用途:api-review 用于按规范化 API 设计指南审查代码,适合用户要求做 API 审查或检查代码是否符合 API 设计规范时使用。
主要能力:先读取 references/canonical_api_design.md 中的 API 设计指南,再确定审查目标并逐文件深入分析,重点检查契约优先(接口是否清晰、与实现解耦)、KISS/YAGNI(是否存在多余参数或过度泛化)、易用性(命名是否体现意图、是否符合最小惊讶原则)、CQS(命令与查询是否分离)、安全性(类型是否严格,如枚举与字符串之别,校验是否可见)、显式配置(依赖是否显式注入,而非通过全局状态、注册表或环境变量隐式解析)。
使用方式:技能会先加载指南;若用户指定文件(如 review main.dart)则审查这些文件,若上下文中有打开的文件则以其为目标,否则要求用户指定目标文件。审查后生成结构化报告,包含字母评分(A-F)、必须修复的关键问题、易用性改进建议,以及建议改进的前后代码块对比。报告以 markdown 产物保存到会话产物目录,例如 <appDataDir>/brain/<conversation-id>/api_review_results.md。
适用场景:需要按统一 API 设计标准评审代码、发现接口设计缺陷并获取可操作改进建议时。
限制:资料未提供支持的编程语言范围、是否可自定义指南、评分细则、运行环境要求及收费信息,暂未提供。