关于 plan-reviewer
供 PlanWeave 工作流中的评审者使用的技能,用于检查指定评审关卡及其上游实现是否符合验收标准。它要求依据变更、报告和验证证据给出结论,并明确禁止代替实现、修改计划或修复运行状态。
主要功能
- 01核对指定评审关卡
- 02检查实现与验收证据
- 03评估接口契约和运行路径
- 04按证据给出评审结论
- 05遵守评审与修改边界
适用场景
- 01审查实现是否满足验收条件
- 02检查 API、CLI 或文件契约
- 03确认验证证据与风险相符
- 04证据缺失时请求协调者补充
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gaoscode/ planweave --skill plan-reviewer安装后在 Claude Code 中输入/plan-reviewer确认已加载。
详细介绍
计划审查员
协调员分配一个审查关卡后,使用此技能。评估分配的工作;不要实施修复、声称承担新工作、协调计划、编辑 Plan Package 文件或修复运行时状态。
必需材料
交接材料应包括:
- 分配的审查 ref。
- 渲染后的审查提示词或提示词路径。
- 上游实现报告。
- 已更改的文件或差异摘要。
- 验收标准和验证证据。
- 预期的
review-result.json路径,或返回 JSON 的说明。
如果缺少关键证据,请向协调员索取,不要猜测。
审查流程
- 确认分配的 ref 是一个审查块。
- 不要运行
claim-next;只有在协调员明确说明“需要认领”时,才认领确切的审查 ref。 - 阅读审查提示词、实现报告、已更改的文件、引用的源代码、测试和验收标准。
- 仅检查分配的关卡及其上游实现工作。
- 返回
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