api-review
评估API接口设计的合理性、一致性与规范性
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：api-review。 它的用途是：评估API接口设计的合理性、一致性与规范性 完整的 Skill 内容见：https://321skill.com/skills/api-review-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请评审以下用户服务API的设计：GET /api/v1/users/{id} 返回用户详情，POST /api/v1/user/create 用于创建新用户。’ 它会指出两个接口在路径命名（users vs user）和动词使用（create冗余）上的不一致性，并建议遵循RESTful规范进行统一。
介绍
这个Skill专注于API接口的评审工作，帮助开发者确保API设计符合最佳实践。它通过分析API的表面设计、命名规范、参数结构以及整体一致性，来识别潜在的设计缺陷和风格不统一的问题。
使用时，你可以将API的设计方案（例如接口定义、参数说明、响应格式）提供给AI，它会基于行业标准和一致性原则，对设计进行审查，并提供具体的改进建议。
它非常适合后端开发、全栈开发以及负责系统架构设计的工程师使用，尤其是在团队协作或项目重构阶段，需要统一API规范时。
建议在API设计稿初步完成后或代码评审阶段使用，以便尽早发现问题。注意，它主要评估设计层面，不涉及代码实现细节或性能测试。
核心特点
与一般代码审查工具不同，它专门聚焦于API接口的“设计评审”，而非代码质量或功能实现；它能结合行业内的优秀范例（exemplar alignment）进行比对，提供更具指导性的规范建议。
注意事项
不适合评估API接口的实际性能、安全性漏洞或底层代码的具体实现逻辑。
常见问题
这个Skill能检查OpenAPI/Swagger文档吗？
可以，你可以提供OpenAPI/Swagger文档内容，它会分析其中的接口设计。
它能给出具体的代码修改建议吗？
主要提供设计层面的评审和建议，如命名、结构、一致性，不直接生成修改后的代码。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/api-review-x-3/raw/index.md 读取 api-review 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/api-review-x-3/raw/index.md（查看排版版本）