## 1. RouteSpec 结构体扩展

- [x] 1.1 在 `internal/routes/registry.go` 的 RouteSpec 结构体中新增 Description 字段

## 2. OpenAPI 生成器修改

- [x] 2.1 修改 `pkg/openapi/generator.go` 的 AddOperation 方法签名，增加 description 参数
- [x] 2.2 在 AddOperation 方法中设置 op.Description 字段
- [x] 2.3 修改 AddMultipartOperation 方法签名，增加 description 参数
- [x] 2.4 在 AddMultipartOperation 方法中设置 op.Description 字段

## 3. Register 函数更新

- [x] 3.1 更新 `internal/routes/registry.go` 的 Register 函数，传递 spec.Description 给生成器

## 4. 文档更新

- [x] 4.1 更新 `docs/api-documentation-guide.md`，新增 Description 字段使用说明
- [x] 4.2 补充 Markdown 语法示例和最佳实践

## 5. 验证

- [x] 5.1 运行 `go run cmd/gendocs/main.go` 验证文档生成正常
- [x] 5.2 检查生成的 YAML 文件格式正确