api-review
评估API接口设计的规范性、一致性与最佳实践对齐度
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：api-review。 它的用途是：评估API接口设计的规范性、一致性与最佳实践对齐度 完整的 Skill 内容见：https://321skill.com/skills/api-review/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请评估一下我设计的用户管理API，这是OpenAPI定义：...'，它会分析你的API设计，指出命名不一致（如`/getUser` vs `/users/{id}`）、参数冗余或缺失、响应结构不标准等问题，并给出修改建议，帮助你产出更规范的API。
介绍
这个Skill旨在解决开发者在设计或评审API接口时，难以系统化评估其设计质量、一致性和是否符合行业最佳实践的问题。它通过分析API的命名、参数、响应结构、错误处理等维度，提供客观的评估报告。
使用时，开发者只需提供API接口的定义（如OpenAPI/Swagger规范、代码片段或自然语言描述），该Skill便会自动分析其设计模式，检查命名风格是否统一、参数设计是否合理、响应格式是否规范，并与已知的优秀API范例进行比对。
它特别适合后端开发、全栈开发和API设计师，在开发新接口、重构旧接口或进行代码评审阶段使用，能有效提升API的可维护性和开发者体验。
建议在API设计初期或团队内部评审流程中集成此Skill。需要注意的是，其评估基于预设的规则和范例库，对于高度定制化或领域特定的API设计逻辑，可能需要结合人工判断进行最终决策。
核心特点
专注于API接口的“表面设计”评估，而非功能实现或性能测试，能系统性地检查命名、风格、一致性等设计规范问题，并与业界公认的API设计范例（如RESTful最佳实践）进行对齐度分析。
注意事项
不适合评估API的内部业务逻辑正确性、性能瓶颈或安全漏洞等实现层面的问题。
常见问题
这个Skill能分析哪些格式的API定义？
主要支持OpenAPI/Swagger规范、代码中的接口定义片段，也支持用自然语言描述API结构进行分析。
评估报告包含哪些具体内容？
报告通常包含命名规范性、参数设计合理性、HTTP方法使用、状态码映射、响应结构一致性以及与范例API的差异点等维度。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/api-review/raw/index.md 读取 api-review 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/api-review/raw/index.md（查看排版版本）