mcpField
P
plan-review

plan-review

github.com/camachoAgent 工作流658 次安装
代码仓库

关于 plan-review

plan-review 在开始构建前对计划执行评审关卡。它并行收集多个 Agent 的评审结论，并依据审批和问题级别决定继续、修改或升级处理。

主要功能

  1. 01查找当前计划文件
  2. 02组建评审小组
  3. 03并行派发 Agent 评审
  4. 04汇总结论与问题
  5. 05执行审批和升级关卡

适用场景

  1. 01实施前评审计划
  2. 02收集多个 Agent 的反馈
  3. 03升级处理未解决的问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/camacho/ai-skills --skill plan-review

安装后在 Claude Code 中输入/plan-review确认已加载。

详细介绍

阶段门：PLAN 检查点。继续进入 Build 前，必须获得所有评审者的 APPROVE。

输入

  • 计划文件路径（默认：ai-workspace/plans/ 中最近的非 .done.md 文件）
  • --include <agent>：强制将某个 Agent 加入评审组
  • --exclude <agent>：移除某个 Agent（technical-editor 除外，该 Agent 不可移除）

步骤

  1. 查找计划文件：

    ls -t "$(git rev-parse --show-toplevel)/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1

    如果未找到计划文件 → 错误：“ai-workspace/plans/ 中没有计划文件。请先编写计划。” 如果计划文件是 .done.md → 错误：“此计划已定稿。”

  2. 读取计划并提取：

    • Files to Modify 部分
    • 正文全文
    • 计划范围（更改的文件数、正文行数）

  3. 组建评审组——调用 /assemble-panel，并将计划文件作为范围。它会根据计划中的文件类型和关键词返回评审组。将 --include/--exclude 作为覆盖选项传入。记录选中了哪些 Agent 及原因。

    Codex/Cursor：直接读取 .claude/skills/assemble-panel/SKILL.md，并在行内应用范围/关键词映射。

    如果 /assemble-panel 不可用，则回退到 [technical-editor, code-reviewer]，gate=P2，cap=3。

  4. 使用 Agent 工具并行分派所有选中的 Agent（在一条消息中调用多个 Agent 工具）。每个 Agent 都会收到：

    • 计划文件内容
    • 其专属评审职责
    • 返回以下结果的指示：APPROVE / REVISE / DROP，并将发现标记为 P0/P1/P2

  5. 收集评审结果并汇总为摘要表：

    ## Plan Review Summary
| Agent | Verdict | P0 | P1 | P2 | Key Finding |
|-------|---------|----|----|-----|-------------|

  6. 阶段门逻辑和评审循环——调用 /assemble-panel 管理评审组。它提供策略代数（gate=P2，cap=3），并处理 RETAIN、EXPAND、CONVERGE 和 ESCALATE_RECURRING。此处不要重复这些规则。

    每轮结束后：

    • 所有评审者均为 APPROVE，且没有高于门槛的问题 →“Proceed to Build”
    • 仍有高于门槛的问题 → 修复，然后按照 assemble-panel 的 RETAIN + EXPAND 规则重新评审
    • 达到上限但仍有未解决的问题 → 升级给人工处理

    如果 /assemble-panel 不可用，则回退：保留所有提出高于门槛问题的评审者，在第 3 轮或所有问题解决时退出。

评审组范围

  • 最少：仅 technical-editor（1 个 Agent，适用于简单计划）
  • 通常：technical-editor + code-reviewer + architect-reviewer（3 个）
  • 最多：所有 Agent（少见，适用于大型跨领域计划）

评论

支持 Markdown