用途
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>:从文件读取回答。省略时从标准输入读取。
工作流程:
- 从 Markdown 计划启动一次运行。
- 请用户切换到评审者模型。
- 运行
prepare-review --id <name>。 - 读取 CLI 打印的生成提示词路径。
- 以当前活动模型回答该提示词。
- 用
save-review --id <name>保存回答。 - 对每个模型重复评审。
- 请用户切换到裁判模型。
- 运行
prepare-judge --id <name>,回答后用save-judge --id <name>保存。 - 请用户切换到验证者模型。
- 运行
prepare-verify --id <name>,回答后用save-verify --id <name>保存。
规则与限制
- 始终将输出保存到当前运行文件夹。
- 除非传入
--overwrite,否则不得覆盖评审、裁判或验证文件。 --id仅作为人类可读标签使用。- 裁判之后,以 judge/final-revised-plan.md 作为事实来源。
- 最终验证者必须包含一行:
Verdict: approved、Verdict: needs_revision或Verdict: blocked。 - 除非用户明确要求,否则不要将生成的运行文件夹提交到版本库。
适用场景
适用于在编码前需要多模型人工评审实现计划的场景,尤其是希望由用户手动切换不同模型、分别给出评审意见、再由裁判汇总并最终由验证者给出结论的流程。
暂未提供的信息
关于收费、价格、支持平台、具体效果等事实,资料中暂未提供。