SuperAPI AI 工具集

triangulate-spec-review

编程与开发

查看项目

更新于 10-16 08:15

技能介绍

Triangulate Spec Review 是一个面向设计文档评审的技能,主要用于审查和改进架构规格、ADR(架构决策记录)、插件或智能体目录提案以及其他设计文档。其核心思路是引入多个独立的 AI 评审者作为评估面,由主导智能体负责综合意见、编辑文档、执行验证并给出最终建议。

用途 该技能适用于需要对设计文档进行多角度、独立评审的场景。它不依赖单一评审者的判断,而是通过多个评审者的独立输出形成证据集合,帮助发现文档中的问题并推动改进。

主要能力

  • 支持对架构规格、ADR、插件或智能体目录提案等设计文档进行评审。
  • 默认评审维度为复杂度、便利性和演进性;若用户指定了维度,则以用户指定为准。
  • 要求评审者输出结构化的 P1/P2/P3 发现,以及一个 p1_p2_clear 布尔值。
  • 至少运行两个评审者,条件允许时推荐三个。
  • 提供 scripts/run-triad-review.mjs 脚本用于可重复的本地评审运行。
  • 主导智能体对发现进行归一化处理,将评审者视为证据而非权威,优先修复趋同的 P1/P2 问题,质疑薄弱或矛盾的发现,P3 一般留作待办,除非修复成本低且能澄清问题。
  • 若用户要求编辑,仅修补所属规格或直接相关的辅助文档,避免无关重构进入评审循环。
  • 支持本地验证,例如 git diff --check、相关测试以及针对重命名概念或过期路径的定向 rg 检查。
  • 重复评审者轮次,直到每个被要求的评审者都报告无 P1 或 P2,或用户停止循环。

使用方式

  1. 确定目标规格路径和验收门槛。若用户未指定维度,默认使用复杂度、便利性和演进性。
  2. 阅读目标规格及附近仓库说明。不要将你怀疑的修复方案或结论传递给评审者。
  3. 对每个评审者使用相同的只读提示,要求输出结构化的 P1/P2/P3 发现和 p1_p2_clear 布尔值。
  4. 运行至少两个评审者,推荐三个。可使用 scripts/run-triad-review.mjs 进行可重复的本地运行。
  5. 归一化发现,优先修复趋同的 P1/P2 问题,质疑薄弱或矛盾的发现,P3 留作待办。
  6. 若用户要求编辑,仅修补所属规格或直接相关的辅助文档。
  7. 运行本地验证,如 git diff --check、相关测试和定向 rg 检查。
  8. 重复评审者轮次,直到满足验收条件或用户停止。

资源

  • references/review-loop.md 包含提示契约、严重性评分标准、命令矩阵和迭代模式。
  • scripts/run-triad-review.mjs 脚本可执行只读评审轮次并写入归一化的 JSON 输出,使用时相对于 triangulate-spec-review 技能目录解析路径,命令形式为 scripts/run-triad-review.mjs --target <path>。

适用场景 适用于需要对设计文档进行独立、多角度评审的工程或架构场景,尤其是当文档涉及架构决策、插件或智能体目录提案时。也适用于需要将评审结果作为证据进行综合判断,而非依赖单一评审者权威的流程。

限制与护栏

  • 向评审者传递原始工件和任务局部上下文,而非预期答案。
  • 除非工具要求更改命令语法,否则每个评审者的提示应保持实质相同。
  • 不允许评审者编辑文件;主导智能体在比较发现后应用更改。
  • 不得根据平均分宣布验收。验收要求所需评审面没有 P1/P2 发现。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。