super-plumber: Skill for Claude Code

Plumber Execute — 主线程编排剧本：拓扑执行 → 全部 passed → 三层验收

Overview

按依赖顺序执行每个节点：CLAIM → WORK → 逐 checkpoint 上报 → execution_report → passed；全部 passed 后做三层验收，验证构建成果真实完整。本页是编排剧本：每步只留一句纪律，全部调用语法、字段含义与报错修法统一看 Operations 手册（寻址约定见手册 §11）；细则按需读 attachments/（与本文件同目录，两渠道同构可解析）：context-hygiene / prototype-research（chart/work 两模式细则在 plumber-design 附件 wayfinder-mode）。产出物 = 全部节点 passed 且验收通过的构建成果，不是设计；图还没设计/未审核 → 回 plumber-design。

When to Use 与衔接关系

• Use：拓扑图已设计并审核通过，开始执行节点任务；claim / checkpoint / execution_report / 状态流转；判断串行还是派 subagent 并行；验证全部节点 passed、构建成果完整；节点 failed → 走重试链重新调度。
• 代理层级边界：skill 文本和“有 subagent 工具”都不能可靠识别代理深度，故每个会话默认无派单权，不得从能力存在推断授权。只有直接承接用户执行请求的外层协调者可持一次性、不可转授的 orchestrator 授权直接派 executor；授权在派发时耗尽，子任务只收到 leaf 约束，绝不可向下复制。缺授权一律 solo。当前通用宿主未向 skill 暴露可验证的签名层级令牌，因此这是行为协议而非硬隔离：需要强保证的宿主还必须在工具层移除子 agent 的派发能力。
• 执行协议的工具调用语法与并行数据判读法 → 手册 §4；状态机七态与三条硬规则 → 手册 §5——本 skill 只留骨架与纪律，绝不复述语法。
• 图未设计或未审核通过 → plumber-design；节点状态裁决 / checkpoint 聚合 / 输出抽查 → super-mario agent；派 executor subagent → 按「派单模板」，检测不到可用 subagent → 走「solo 分支」；新会话缺少背景 → /plumber-join 获取最小上下文并置 ready 后回本技能；已有上下文直接执行，不重复入场。

执行协议（每节点 0–5 步，严格按序；各步调用语法统一 → 手册 §4.1）

1. PLAN — 每轮决策前先看 graph_get_next_actions 五桶；优先已有 ready 节点，空时再从 ready_eligible 选择（门禁复校后转 ready），不要拿 get_graph+search 手工拼数据。
2. CLAIM — 只 claim ready 节点（eligible 先 {status:"ready"} 再 claim），必带 claim_by，拿到 already claimed 就换节点别重试同节点；claim 响应附 governing_adrs 必读——adr_flags ⚠️ 出现即停：该节点依据的 ADR 已被接替，先弄清新决策再动手，ADR 状态只能由裁决方（super-mario/人类）改。
3. WORK — 执行 plan.description，把 checkpoints 当逐条清单完成。测试先行、新增测试或缺陷修复 → 若可用，参考 plumber-tdd；遇到 cross_review 或指定 artifact 复核 → 若可用，交 plumber-review，结果交 super-mario/独立裁决方。两者都是软路由：技能缺失直接按 plan/DoD 与手册执行，不另找替代、不增加门禁；缺技能不取消原有交叉复核要求，独立复核者不可用时如实交接。
4. REPORT AS YOU GO — 每完成一个 checkpoint 立即上报，绝不攒批——完成的未上报 = 丢失的进度。
5. HAND OFF — 干完立刻填 execution_report：artifacts 只写真实文件路径（会被存在性核验），绝不编造路径。
6. passed — 委派工人止于 report，由 super-mario/独立裁决方写 verdict 并流转 passed；solo 按下文裁定边界处理。核心层硬门禁一句话：非空 report + checkpoint 全 passed/skipped + 无 failed 裁决，缺一即拒——铁律先 verdict 后 passed（重试链 / attempts 上限 / blocked 解除 / reclaim 细节 → 手册 §4.3 与 §5）。