plan-runner

Plan Runner

在协调者分配一个实现区块后使用此技能。专注于准确完成该区块；不要安排工作、发现问题、修复 PlanWeave 状态或协调 Plan Package。

必需材料

交接内容应包括：

• 分配的区块 ref。
• 渲染后的提示词或提示词路径。
• 认领归属：通常为 already claimed。
• 范围边界和不得触碰的文件。
• 预期的报告／结果工件。
• 验证命令或可观察的完成标准。

如果缺少任何必需项，请向协调者索取，不要认领其他工作。

执行流程

1. 确认分配的 ref 属于实现工作。
2. 如果归属为 already claimed，不要运行 claim 或 claim-next。
3. 如果归属为 claim required，仅认领指定的 ref／任务；如果返回了不同的 ref，则停止。
4. 阅读渲染后的提示词和引用的文件。
5. 搜索会影响此区块的相关生产方、使用方、架构、测试、测试固件和文档。
6. 进行满足提示词要求的最小范围修改。
7. 运行分配的验证或直接相关的验证。
8. 编写所需报告并返回；只有在协调者明确要求提交时才提交。

质量关卡

• 除非提示词明确限定该区块的范围，否则不要将模拟、试运行、仅测试固件的测试或未调用的 API 视为已在实际环境中完成。
• 确保生产方和使用方之间的架构／类型／API／CLI／文件／提示词契约保持一致。
• 保留无关文件和行为。
• 如果提示词为空、自相矛盾、过时、受阻、已偏离，或指向缺失的源文件，请停止并返回 NEEDS_COORDINATOR。
• 如果由于计划依赖关系不当、缺少提示词、验收条件无效、评审关卡设计错误或任务范围过时而无法完成分配的区块，请停止并返回 NEEDS_COORDINATOR，并准确说明计划缺陷。

报告

包括：

• 分配的 ref。
• 已更改的文件。
• 已更改和保留的行为。
• 运行的验证及结果。
• 剩余风险或 none。
• 任何协调／恢复问题。

边界

• 不要执行评审关卡；使用 plan-reviewer。
• 不要协调多个区块、画布或子 Agent；使用 plan-coordinator。
• 不要编辑 project-graph.json、画布 manifest.json、源提示词 Markdown 或其他 Plan Package 文件；将计划缺陷报告给协调者。
• 不要运行 doctor --repair、解除阻塞、解决偏离问题或编辑 state.json / results/；使用 plan-recovery。
• 不要创建反馈区块；反馈属于运行时状态。