api-spec-generator(API 接口文档生成与校验)
根据业务需求/代码片段生成OpenAPI规范,校验接口设计缺陷,输出接口文档。
装好之后怎么用
怎么用:在 AI 工具里直接描述任务即可自动触发。显式调用的写法各端不同:Claude Code / Cursor 等用 /api-spec-generator,Codex 用 $api-spec-generator,Kimi Code 用 /skill:api-spec-generator,ZCODE 用 $api-spec-generator,Gemini CLI 以自动激活为主。
最近把自己反复在用的一套流程整理成了 skill:api-spec-generator。
它做的事:根据业务需求/代码片段生成OpenAPI规范,校验接口设计缺陷,输出接口文档。
怎么用
- 用 skill 页的「复制给 Agent 一键安装」装进你的 AI 工具
- 之后直接描述任务即可自动触发
欢迎装来试试,问题评论区聊。
技能内容
SKILL.md版本与文件 ›Workflow
- 接收业务描述或者后端代码片段
- 生成标准OpenAPI 3.0 YAML,包含路径、请求参数、响应体、错误码
- 校验接口缺陷:参数缺失、类型错误、安全漏洞(未鉴权、敏感信息泄露)
- 输出Markdown版接口说明 + OpenAPI yaml
约束:安全风险项必须高亮标注。
评论 0
更多
登录后可点赞、收藏、评论和举报。
还没有评论,先发起一个具体问题。