SuperAPI AI 工具集

plan-review

编程与开发

查看项目

更新于 10-21 13:34

技能介绍

用途

Plan Review 用于在开始编码之前,对一份实现计划进行多模型的人工评审。它适合希望借助多个手动选择的 AI 模型来审查实现计划的场景,触发条件包括多模型计划评审等。

该技能与模型无关:它不负责选择模型、切换模型、调用模型 API 或管理 API 密钥。模型切换由用户手动完成,当前活动智能体只处理当前步骤。

主要能力

  • 从 Markdown 计划文件启动一次评审运行。
  • 为评审者、裁判和验证者分别准备提示词,并保存各自的回答。
  • 支持查看当前运行状态以及列出已有运行。
  • 运行输出默认保存在当前工作目录的 plan-review-runs/ 下,提示词模板从技能文件夹加载。

使用方式

Python CLI 是可靠的操作入口,命令如下:

python3 scripts/plan_review.py start <plan-file.md>
python3 scripts/plan_review.py prepare-review --id <reviewer-name>
python3 scripts/plan_review.py save-review --id <reviewer-name> --content-file <file>
python3 scripts/plan_review.py prepare-judge --id <judge-name>
python3 scripts/plan_review.py save-judge --id <judge-name> --content-file <file>
python3 scripts/plan_review.py prepare-verify --id <verifier-name>
python3 scripts/plan_review.py save-verify --id <verifier-name> --content-file <file>
python3 scripts/plan_review.py status
python3 scripts/plan_review.py list

如果宿主支持斜杠命令,可将 /plan-review ... 映射到相同的 CLI 命令。

可用标志:

  • --base-dir <path>:将运行写入当前工作目录以外的位置。需放在子命令之前,例如 python3 scripts/plan_review.py --base-dir /path start plan.md。
  • --run <run-id>:操作非当前运行。适用于 prepare-、save- 和 status。省略时,目标为 plan-review-runs/current 中指定的运行。
  • --overwrite:用相同的 --id 替换已有的评审、裁判或验证条目。不传时,重复的 --id 会失败。
  • --content-file <file>:从文件读取回答。省略时从标准输入读取。

工作流程:

  1. 从 Markdown 计划启动一次运行。
  2. 请用户切换到评审者模型。
  3. 运行 prepare-review --id <name>。
  4. 读取 CLI 打印的生成提示词路径。
  5. 以当前活动模型回答该提示词。
  6. 用 save-review --id <name> 保存回答。
  7. 对每个模型重复评审。
  8. 请用户切换到裁判模型。
  9. 运行 prepare-judge --id <name>,回答后用 save-judge --id <name> 保存。
  10. 请用户切换到验证者模型。
  11. 运行 prepare-verify --id <name>,回答后用 save-verify --id <name> 保存。

规则与限制

  • 始终将输出保存到当前运行文件夹。
  • 除非传入 --overwrite,否则不得覆盖评审、裁判或验证文件。
  • --id 仅作为人类可读标签使用。
  • 裁判之后,以 judge/final-revised-plan.md 作为事实来源。
  • 最终验证者必须包含一行:Verdict: approved、Verdict: needs_revision 或 Verdict: blocked。
  • 除非用户明确要求,否则不要将生成的运行文件夹提交到版本库。

适用场景

适用于在编码前需要多模型人工评审实现计划的场景,尤其是希望由用户手动切换不同模型、分别给出评审意见、再由裁判汇总并最终由验证者给出结论的流程。

暂未提供的信息

关于收费、价格、支持平台、具体效果等事实,资料中暂未提供。