实现服务启动时自动生成OpenAPI文档

主要变更:
1. 新增 cmd/api/docs.go 实现文档自动生成逻辑
2. 修改 cmd/api/main.go 在服务启动时调用文档生成
3. 重构 cmd/gendocs/main.go 提取生成函数
4. 更新 .gitignore 忽略自动生成的 openapi.yaml
5. 新增 Makefile 支持 make docs 命令
6. OpenSpec 框架更新和变更归档

功能特性:
- 服务启动时自动生成 OpenAPI 文档到项目根目录
- 保留独立的文档生成工具 (make docs)
- 生成失败时记录错误但不影响服务启动
- 所有代码已通过 openspec validate --strict 验证

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

cmd/api/main.go

@@ -71,7 +71,10 @@ func main() {
 	// 10. 注册路由
 	initRoutes(app, cfg, handlers, queueClient, db, redisClient, appLogger)
 
-	// 11. 启动服务器
+	// 11. 生成 OpenAPI 文档
+	generateOpenAPIDocs("./openapi.yaml", appLogger)
+
+	// 12. 启动服务器
 	startServer(app, cfg, appLogger, cancelWatch)
 }