SuperAPI AI 工具集

reviewer-creator

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

用途:当用户要求创建自定义审查者、添加项目专属审查者、扩展 deep-review,或调用 /reviewer-creator 时,为 deep-review 技能脚手架一个项目级自定义审查者文件,生成于 docs/rules/review/<name>.md,分派时由调度器自动发现。

适用场景:需要新增 11 位内置审查者未覆盖的项目专属关切(如迁移安全、特性标志清理、国际化键一致性、schema 版本兼容、遥测命名),或团队要引入在拉取请求阶段强制执行的约定。内置审查者已覆盖且无需项目补充的通用关切不必创建。

前置条件:已安装 auriga-workflow 插件(本技能与 deep-review 一同分发);docs/rules/review/ 目录不存在时按需创建;references/template.md 为规范模板。

主要能力与用法:通过 AskUserQuestion / request_user_input 依次收集名称、一句话职责、领域短语、触发类别、检测信号、推理档位、示例场景与分派模式;名称须为 kebab-case 且不得与内置审查者重名。生成文件使用 YAML frontmatter,必填字段含 name、best_for、trigger、reasoning、tools、value,可选 extends、effort。trigger 取 always、tag:<logic|auth-sensitive|ui|perf|arch>、non-trivial 或 detection-driven;detection-driven 至少需 3 行可 grep 的规则。extends 用于声明定位:extends: <内置名> 表示项目专属补充并由 deep-review 吸收进同一 host,extends: standalone 表示全新独立维度;多数项目关切宜吸收以控制子代理数量。推理档位除默认外由平台解析,不写死模型名。

输出目录以仓库根为锚,命令为 mkdir -p "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/docs/rules/review/";monorepo 中可写入子包内的 docs/rules/review/,deep-review 会两层收集。

限制:frontmatter 的 value 字段,以及 Checklist 正文、场景 2 和 3、Output contract 细节等 <TODO> 占位符需用户自行填写;生成后需手工补全 Checklist(5–10 条具体问题)与至少 2 个场景,并运行 /deep-review 验证分派。其他细节暂未提供。