用途:从现有 API 代码自动生成 OpenAPI/Swagger 文档,减少手工整理端点与格式的工作,并让文档随代码更新。
主要能力:分析控制器类,提取路由、HTTP 方法与路径参数;解析请求/响应模型,标注字段类型、必填项与校验规则;识别鉴权方式(如 [Authorize] 属性、鉴权方案与所需角色/范围);生成示例请求、示例响应与错误响应;产出 OpenAPI 3.0 规范、Swagger UI、Markdown 文档、Postman 集合及 cURL 示例。
使用方式:在技能激活后,可用“Generate API documentation”“Create OpenAPI spec for our API”“Export Postman collection from API”等提示触发。生成结果通常包括 docs/api/openapi.yaml、docs/api/README.md、docs/api/postman-collection.json 及示例目录,Swagger UI 可访问如 http://localhost:5000/swagger。
适用场景:为外部合作方编写接口文档、维护 Swagger 文档、导出 Postman 集合供团队测试、快速生成 cURL 示例。
限制:资料未提供具体安装命令、支持的语言或框架范围、收费与价格信息,也未说明生成准确率或对复杂代码结构的处理边界,这些需以实际环境验证。