用途
Superwork 用于将复杂工作拆解为一系列经过验证的阶段来执行。根会话作为主协调者和用户可见的控制平面，负责框定、派发、汇报、验证与决策；辅助者只提供边界明确的研究、实现或评审支持。
激活与状态
Superwork 在每个根会话开始时处于关闭状态。其状态作为会话内布尔值由根会话持有，绝不持久化到文件，也不会被子会话继承。
技能命令参数行为：
on：在当前根会话中为符合条件的复杂执行请求启用 Superwork，仅确认，不开始工作。off：在当前根会话中禁用后续自动使用，但不取消已经在进行中的工作，除非用户同时要求停止。status：报告 Superwork 是否开启，以及是否有一次性运行处于活动状态。- 无参数：报告状态并展示命令形式。
- 任意其他非空参数：视为一次性 Superwork 任务，在不改变原有开/关状态的情况下运行。
当 Superwork 关闭时，除非用户显式以任务方式调用，否则不应用该工作流。当它开启时，也仅对符合描述的工作使用；小改动和仅规划类请求按常规处理。
不可妥协的原则
- 未经阶段验证通过，绝不将阶段标记为完成。
- 根会话是主编排者、协调者和用户可见的控制平面，绝不把完整的 Superwork 工作流或多阶段计划委托给子会话。
- 单一写入者：同一时间最多只有一个智能体（根会话或某个工作单元）修改仓库；评审者和研究者为只读。
- 根会话负责阶段转换、计划账本更新、重大决策以及所有面向用户的进度报告。
- 在每个阶段边界记录阶段状态，以便中断的运行能够恢复。
- 将重大决策（范围、架构、安全、删除、发布）升级给用户，而非静默决定。
- 当现实与计划矛盾时，停止并重新规划，不要强行沿用过期计划。
工作流
1. 框定
定位计划：PLAN.md、plans/*.md、SPECS.md，或用户提供的计划，并完整阅读。
对照当前仓库验证该计划——快速浏览其点名的关键文件。如果计划已过期（文件移动、假设失效），重新框定受影响的阶段，并在执行前与用户确认。
未找到计划时，运行压缩式框定采集：目标、范围边界、约束、完成标准、仓库扫描，然后将工作拆分为 2–6 个可独立验证的阶段，在改动代码前展示阶段列表并取得用户确认。
结果：一份阶段列表，每个阶段都有目标、预期文件、完成标准和验证命令。将其记录到计划文件中（或创建计划文件），使运行可恢复。
2. 每阶段：研究 → 构建 → 验证
在开始第一个阶段前，阅读 references/loop.md 以了解完整的阶段契约。概要如下：
- 研究：收集构建该阶段所需的恰好足够的上下文——相关代码路径、API、外部事实。有边界，而非穷尽。
- 构建：实现该阶段，采用满足阶段目标的最小差异。
- 验证：运行该阶段的验证命令，必须通过。在子智能体可用时，还要针对阶段目标对差异做一次全新上下文的评审。失败时：一次修复迭代，然后带着失败内容和选项升级给用户。
- 记录：根会话在计划文件中标记阶段状态（done / blocked / re-framed），并附一行验证证据。
根会话在主会话中报告每次阶段转换。在发起子工作波次前，说明委托内容与原因；在消费其结果后，说明结果与下一步。不要让用户必须查看子会话记录才能理解整体进度。
3. 汇报
当所有阶段完成（或工作停止）时：说明改动了什么及原因、每个阶段的验证证据、残余风险、建议的下一步，保持简洁。
子智能体
如果具备子智能体能力（例如 pi-subagents 扩展），阅读 references/subagents.md 并遵循扇出操作手册。根会话做出所有委托决策，只发送边界明确、针对具体阶段的任务。子会话绝不负责阶段推进、计划账本、用户交互或进一步编排。
如果不存在子智能体，则以单会话、顺序方式运行同一循环，其他部分不变。
边界情况
- 阶段揭示计划有误：停止，重新框定剩余阶段，与用户确认后继续。
- 没有构建或测试可用于验证：明确说明改用了何种正确性检查方式（评审通过、针对性脚本、人工追踪），由用户决定是否足够。
- 运行被中断：恢复时读取已记录的阶段状态，对最后一个声称完成的阶段做低成本复验，然后从该处继续。
- 阶段之间存在共享文件重叠：串行执行这些阶段。
适用场景与限制
适用于需要多阶段推进、且每阶段可独立验证的复杂执行请求。不适用于小改动或仅规划类请求。资料中未提供收费、价格、平台或效果方面的信息。