用途
plan-review 是一个计划审查技能,用于审查实施计划的完整性、正确性和可验证性。它采用多智能体方法,通过并行的审查视角对计划进行评估。
主要能力
该技能围绕多个审查维度组织审查代理:
- 意图与完整性审查:检查核心意图是否清晰陈述并贯穿计划,计划意图是否与原始请求一致,所有原始需求是否被计划任务覆盖,以及边界情况。
- 验证审查:检查每个任务是否可测试、成功标准是否可衡量、完成情况如何被证明。
- 并行性分析:分析哪些任务必须顺序执行、哪些可以并行、最优执行模式,以及子代理提示中是否传达了「为什么」。
- 魔鬼代言人(默认启用):挑战方案是否为正确方法、关键假设若错误会怎样、任务是否可移除或推迟、最可能的失败点在哪里。
- 技术审查、风险审查、外部审查(彻底模式):在彻底模式下额外包含技术审查、风险审查,以及可选的外部审查(需 --external 标志)。
使用方式
通过命令调用:
# 彻底审查(默认)
/plan-review
# 快速审查,更快获得反馈
/plan-review --quick
# 指定计划文件
/plan-review path/to/plan.md
# 如可用,包含外部工具
/plan-review --external
支持的标志:
--quick:快速审查,使用较少代理(3-4 个,对比 6-8 个)--thorough:全面审查(默认)--external:如可用,包含外部工具(Codex/Gemini)--no-devils-advocate:跳过魔鬼代言人审查环节(默认运行)
输入要求:用户需提供显式计划文件路径,或由技能从上下文自动检测近期计划。
执行阶段
阶段 0:计划检测与模式选择 检测计划文件(显式路径、常见位置如 ${CLAUDE_CONFIG_DIR:-~/.claude}/plans/、当前对话上下文、node_modules/.cache/plans/),确定审查模式,提取原始请求/规格说明并分解为编号需求清单,提取并验证意图,解析计划结构,构建任务依赖图。
阶段 1:并行审查代理 根据模式启动专门的审查代理。快速模式包含意图与完整性审查、验证审查、并行性分析、魔鬼代言人;彻底模式包含意图审查(关键,首先运行)、完整性与规格覆盖审查、技术审查、验证审查、风险审查、并行性分析、魔鬼代言人、外部审查(可选)。
阶段 2:智能体执行分析 评估计划的智能体执行模式,包括简单执行、子代理委派、子代理+验证、迭代直到验证、并行扇出、编排流水线、树形执行等模式,并进行依赖检测(文件级依赖、数据流依赖、隐式顺序)。
阶段 3:综合汇总 汇总所有审查代理的发现,按严重程度分类(关键/重要/次要),合并重复项,生成可操作建议,构建规格覆盖分析(可追溯性矩阵、覆盖率指标),汇总发现的任务。
阶段 4:交互式解决(可选) 如发现问题,呈现给用户进行迭代细化。
魔鬼代言人模式(默认)
默认情况下,在标准审查代理完成后会运行额外的对抗性审查环节。该模式挑战假设、压力测试计划方案,并质疑所提议的任务是否正确。传入 --no-devils-advocate 可跳过。工作流程:先运行标准审查代理并收集发现,然后生成带有魔鬼代言人指令的子代理,合并两轮发现(魔鬼代言人发现以 [DA] 为前缀),去重,在输出报告中添加「## Devil's Advocate Findings」章节,并更新评估。
与其他命令的集成
- 实施前:运行 /plan-review 验证计划
- 实施中:运行 /plan-implementation-review 跟踪进度
- 实施后:运行计划中的测试和验证任务
缓存位置
审查结果会缓存以便恢复:
node_modules/.cache/plan-reviews/
├── {plan-name}-{timestamp}.json # 原始代理发现
├── {plan-name}-report.md # 生成的报告
└── metadata.json # 审查会话元数据
子文档
技能会根据审查模式和阶段逐步加载子文档:agent-prompts-quick.md(快速模式代理提示模板)、agent-prompts-thorough.md(彻底模式代理提示模板)、output-format.md(报告模板和输出结构,阶段 3 加载)、discovered-work.md(子代理发现工作协议,包含在所有子代理提示中)、external-tools.md(Codex/Gemini 集成,仅 --external 标志时)、agents/devils-advocate.md(魔鬼代言人对抗性审查代理,默认加载)。
适用场景
适用于在实施前对实施计划进行结构化审查,尤其适合需要多视角评估、验证可测试性、分析任务依赖与并行性、以及通过对抗性审查发现潜在问题的复杂计划。
限制
资料未提供关于收费、价格、平台支持范围、具体效果保证等信息。该技能依赖 Claude 相关环境(如 CLAUDE_CONFIG_DIR)及特定目录结构,外部工具集成需相应工具可用。