Super Run
把任务规划与阶段执行合并为一个可恢复闭环。只做 phase -> task 目标级规划,由当前主会话直接完成实现、测试和修复;验收按共享协议派发对应只读 accept subagent,除此之外不调用 subagent。每次调用只执行 --phase 显式指定的一个 phase;该 phase 完成后停止并报告剩余未完成 phase,不自动进入下一个 phase。
运行时边界统一参考:${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md
设计生成状态统一参考:${CLAUDE_PLUGIN_ROOT}/protocols/design-state-contract.md
需求与决策边界统一参考:
${CLAUDE_PLUGIN_ROOT}/protocols/requirement-source-contract.md${CLAUDE_PLUGIN_ROOT}/protocols/decision-continuity-contract.md
计划、状态、角色映射、执行顺序、恢复、验收回退和 Goal 规则统一参考:
${CLAUDE_PLUGIN_ROOT}/protocols/super-run-state-contract.md
参数
| 参数 | 说明 |
|---|---|
[feature] |
必填;允许中文、英文、数字、空格、下划线和连字符 |
--phase <backend|frontend|web-demo|flutter|flutter-demo> |
必填;本次调用只执行该 phase,完成后停止 |
前置条件
--phase缺失或不在支持列表内时终止,提示--phase <backend|frontend|web-demo|flutter|flutter-demo>用法。.ai/design/[feature].md必须存在。- 运行
python ${CLAUDE_PLUGIN_ROOT}/scripts/check-design.py ".ai/design/[feature].md" --require-complete --json;失败时停止,不创建或恢复 super-run。 - 只支持
backend | frontend | web-demo | flutter | flutter-demo;请求的 phase 不在设计与需求来源识别出的真实交付端内时终止,不得为满足命令而编造交付范围。miniapp 和 extension 使用/t-task、可选/t-task-check与/t-run。 - 不读取或修改
.ai/task/[feature]/作为 super-run 状态。 - 已有状态且请求的 phase 为
completed | skipped时,直接报告结果,不重新执行,也不选择其他 phase。
来源加载
在规划或恢复前:
- 读取
check-design.py返回的全部design_documents、design_fingerprint和现有.ai/super-run/[feature]/。 - 按 phase 确认设计输入:backend 读
backend.md;frontend/web-demo 读frontend.md;flutter/flutter-demo 读flutter.md;客户端依赖后端契约时同时读backend.md。 - 读取相关
.ai/prd/**/*.md、docs/prd/**/*.md、.ai/user-stories/**/*.md与docs/user-stories/**/*.md,保留 draft/published 来源边界。 - 在任何提问前读取
.ai/decision-log/[feature].md;存在时按需读取.ai/decision/[feature].md与.ai/tech-research/[feature].md。 - 按
${CLAUDE_PLUGIN_ROOT}/protocols/task-phase-execution.md的 Phases 启用规则,从设计覆盖矩阵、Operation ID、文件影响表、Decision Trace、代码和配置确定 active phases、task 闭环与真实验证入口;设计主文档声明 Demo 主路径或文件影响表含web-demo/flutter-demo行且项目存在对应交付端时,对应 demo phase 计入 active phases,demo 资产由该 phase 交付,不并入 frontend/flutter。 - 按 Decision Exposure Gate 分类缺口;
needs_user_answer未解决时不得进入实现。
不要无差别加载所有 PRD、用户故事或 guide。先通过 feature 名、设计引用和内容检索定位相关文件,再读取全文。
计划与状态
- 按
${CLAUDE_PLUGIN_ROOT}/protocols/super-run-state-contract.md创建或更新:.ai/super-run/[feature]/.state.json.ai/super-run/[feature]/[phase].md
- backend/frontend/flutter 固定规划
dev -> test -> accept,web-demo/flutter-demo 固定规划dev -> accept。 - 每个 task 只规划一个责任闭环,不生成 item。
- 把校验结果的
design_documents和design_fingerprint写入 super-run state;恢复规则见共享协议。 - 计划必须写明每个 task 要读取的 agent 规范及其关联文档的具体路径。
- 每个 task 的关联文档必须包含设计主文档和当前 phase 分端设计;消费后端契约时同时包含
backend.md。 - web-demo/dev 的关联文档必须包含
${CLAUDE_PLUGIN_ROOT}/agents/web-demo-diagnose.md,用于把 Playwright 失败归因到测试资产、frontend 或 backend 后再切换对应规范修复。 - flutter-demo/dev 的关联文档必须包含
${CLAUDE_PLUGIN_ROOT}/agents/flutter-demo-diagnose.md,用于把 Patrol 失败归因到测试资产、Flutter 或 backend 后再切换对应规范修复。 - 首次写入后或恢复到未完成的请求 phase 后,主动调用
/goal或运行时等价 Goal API;Goal 的 outcome、constraints 和 verification 必须符合共享协议,且只为请求的 phase 创建或恢复 Goal。
规划写清目标、成功标准、权限边界、当前角色、证据入口和停止条件,具体实现路径根据仓库事实决定。不要把 t-task 的细粒度 item 换一种格式复制进来,也不要用长篇过程指令占用持续 Goal 的上下文。
执行
循环执行直到 phase 完成或进入真正阻塞:
- 重新运行设计校验并比较指纹;变化时先按共享协议重规划。
- 按状态选择顺序中的第一个
pending | in_progress | failedtask。 - dev/test task:读取该 task 的 agent 规范全文及计划列出的关联文档,把它们作为主会话当前角色边界。accept task:按共享协议派发对应只读 accept subagent,并把报告结论映射回状态。
- 写入
in_progress,执行交付、最小可靠验证和必要修复。 - 写入
completed与证据,重新聚合 phase,继续下一个 task。 - 失败时先写
failed与证据;能够基于新证据修复时继续闭环,否则写blocked并暂停 Goal。 - accept 拒绝时按共享协议重新打开 dev 或 test,再次测试和验收。
每次显著步骤后把完成内容、验证证据、剩余工作和 handoff 写入状态或 phase 计划,确保上下文压缩后能从文件恢复。
禁止事项
- 为 dev/test 调用
Agent、并行 subagent 或任何以 subagent 做上下文隔离的调度;accept 只允许串行派发计划中对应的只读 accept agent,不得派发其他角色。 - 自动进入、规划或恢复未被本次调用显式请求的 phase,或为其创建 Goal。
- 生成
.ai/task/的 manifest/item,或修改t-task/t-run状态。 - 把 accept 角色改为实现角色,或让 accept 直接修复代码。
- 跳过测试、弱化断言、忽略失败或把
blocked当作 Goal 完成。 - 在无真实兼容约束时保留被设计明确替换的旧路径。
完成条件
只有同时满足以下条件才完成 Goal:
- 当前 phase 的全部 task 为
completed | skipped。 - 当前设计校验通过且指纹与
sources.design.fingerprint一致。 - 计划中的验证已经执行并有证据。
- accept task 给出允许进入下游的结论;整个 phase 为
skipped时必须有明确不适用证据。 .state.json已按最终结果聚合。
输出当前 phase、task 状态、主要变更、验证证据和剩余未完成 phase,然后停止本次调用;剩余 phase 由用户再次显式传入 --phase 启动。若全部 active phases 已完成,明确报告 feature 的 super-run 已完成。