需为spring boot 3项目集成springdoc-openapi-starter-webmvc-api≥2.0.0依赖，再通过kimi为controller方法自动添加@operation、@parameter、@apiresponse等openapi 3注解，并在/swagger-ui.html验证接口文档完整性与准确性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要快速为Spring Boot 3项目生成符合OpenAPI 3规范的接口文档，但手写@Operation、@Parameter等注解耗时易错，也不愿手动维护YAML或JSON描述文件。
确认项目已启用Springdoc OpenAPI
打开pom.xml，检查是否已引入springdoc-openapi-starter-webmvc-api依赖，版本必须≥2.0.0（Spring Boot 3对应要求），旧版springfox不兼容。
若未添加，插入以下依赖并保存：
【未升级到2.x+会导致Kimi生成的注解完全无效，接口在/swagger-ui.html中不显示】
让Kimi理解你的Controller结构
复制目标Controller类的完整源码（含package、import、类声明、所有@RequestMapping方法），粘贴至Kimi对话框。
输入明确指令：“请为以下Spring Boot 3 Controller中的每个@GetMapping、@PostMapping等方法，逐个添加符合OpenAPI 3规范的springdoc注解。要求：① 方法级用@Operation标注summary和description；② 每个@PathVariable、@RequestParam、@RequestBody参数必须用@Parameter或@Schema说明；③ 返回值用@ApiResponse标注HTTP状态码与响应体示例。”
一键设置，在 OpenClaw 和 Claude Code CLI 中使用 Kimi K2.5 (Kimi Code) 作为编程模型。Kimi Code 兼容 Anthropic Messages API——替换……
等待Kimi返回带注解的代码——它会自动识别参数类型、是否必填、是否为集合，并为常见DTO类推断字段含义。
注入注解并验证效果
第一步：将Kimi返回的注解块，逐个粘贴到对应方法上方，不要覆盖原有逻辑代码。
第二步：启动应用，访问 http://localhost:8080/swagger-ui.html，确认接口列表出现且各字段可展开。
第三步：点击任一接口的“Try it out”，检查Parameters区域是否准确显示路径变量、查询参数、请求体模型；Response Schema是否与实际DTO结构一致。
若发现某参数缺失说明或响应体为空，说明Kimi未识别该参数来源（如隐式绑定的@ModelAttribute），需手动补全@Parameter(hidden = true)或添加@Schema(description = "...")到DTO字段。
