mcpField
P
plan-reviewer

plan-reviewer

github.com/gaoscode测试与质量42555 次安装1 周前更新
代码仓库

关于 plan-reviewer

供 PlanWeave 工作流中的评审者使用的技能,用于检查指定评审关卡及其上游实现是否符合验收标准。它要求依据变更、报告和验证证据给出结论,并明确禁止代替实现、修改计划或修复运行状态。

主要功能

  1. 01核对指定评审关卡
  2. 02检查实现与验收证据
  3. 03评估接口契约和运行路径
  4. 04按证据给出评审结论
  5. 05遵守评审与修改边界

适用场景

  1. 01审查实现是否满足验收条件
  2. 02检查 API、CLI 或文件契约
  3. 03确认验证证据与风险相符
  4. 04证据缺失时请求协调者补充

安装

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

$npx skills add https://github.com/gaoscode/planweave --skill plan-reviewer

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

详细介绍

计划审查员

协调员分配一个审查关卡后,使用此技能。评估分配的工作;不要实施修复、声称承担新工作、协调计划、编辑 Plan Package 文件或修复运行时状态。

必需材料

交接材料应包括:

  • 分配的审查 ref。
  • 渲染后的审查提示词或提示词路径。
  • 上游实现报告。
  • 已更改的文件或差异摘要。
  • 验收标准和验证证据。
  • 预期的 review-result.json 路径,或返回 JSON 的说明。

如果缺少关键证据,请向协调员索取,不要猜测。

审查流程

  1. 确认分配的 ref 是一个审查块。
  2. 不要运行 claim-next;只有在协调员明确说明“需要认领”时,才认领确切的审查 ref。
  3. 阅读审查提示词、实现报告、已更改的文件、引用的源代码、测试和验收标准。
  4. 仅检查分配的关卡及其上游实现工作。
  5. 返回 passed 或 needs_changes;只有在协调员明确要求提交时才提交。

审查检查项

  • 是否满足目标和验收要求。
  • 生产者/消费者在架构、API、CLI、事件、文件、状态和提示词 I/O 方面的契约是否一致。
  • 是否按要求提供运行时使用、调用方、实际路径和可观察输出。
  • 是否未将模拟、试运行、仅使用 fixture 或未调用的路径描述为完整的实际行为。
  • 验证证据是否与该块的风险相匹配。
  • 当功能或状态机需要可靠性时,是否涵盖失败路径。

结论

  • 仅当满足验收要求且验证证据充分时,才使用 passed。
  • 对于不完整、不安全、无法验证、超出范围或破坏契约的工作,使用 needs_changes。
  • 对于受阻工作、偏差、证据缺失、工具故障、过时的提示词、无效的验收要求、不良依赖或审查关卡设计缺陷,使用 NEEDS_COORDINATOR。
  • 不要将 Plan Package 缺陷作为实现反馈;应向协调员准确报告相关任务、块、提示词、边或审查关卡问题。

边界

  • 不要编辑实现文件、project-graph.json、画布 manifest.json、源提示词 Markdown、state.json 或 results/。
  • 不要提交计划修复或运行时恢复;向协调员返回审查结果或 NEEDS_COORDINATOR。

结果格式

{
  "reviewBlockRef": "T-001#R-001",
  "taskId": "T-001",
  "verdict": "needs_changes",
  "content": "Concrete feedback for the implementation agent."
}

对于 passed,请引用证据。对于 needs_changes,请提供具体且限定在上游块范围内的反馈。 将 content 写成简洁的 Markdown。对于 needs_changes,将每条可执行的发现分别写成一个段落,并以 [P0]、[P1]、[P2] 或 [P3] 开头;然后添加一个 ## Verification 部分,其中只列出实际审查过的检查项和证据。

评论

支持 Markdown