Comet 阶段 3：计划与构建（Build）

前置条件

• Design Doc 已创建（阶段 2 完成）
• 活跃 change 存在

步骤

0. 入口状态验证（Entry Check）

按 comet/reference/scripts.md 定位脚本（定位 comet-env.mjs），然后执行入口验证；从任意入口恢复时先按 comet/reference/context-recovery.md 运行恢复检查：

node "$COMET_STATE" check <name> build

验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。

幂等性：build 阶段所有操作可安全重复执行。读取 .comet.yaml 的 phase 字段确认仍在 build 阶段，读取 plan 文件头的 base-ref，再用 grep -n '\- \[ \]' tasks.md | head -1 找到第一个未勾选任务继续执行。已提交的任务不得重复提交。

1. 制定计划（Subagent Offload）

通过 subagent 创建实施计划，避免 planning skill 占用主 session 上下文。计划文件和执行反馈必须使用触发本次工作流的用户请求语言。

Subagent 指令：

你是实施计划专家。基于以下输入创建实施计划：

1. 立即执行： 使用 Skill 工具加载 Superpowers writing-plans 技能。禁止跳过此步骤。技能加载后，ARGUMENTS 必须包含：Language: 使用触发本次工作流的用户请求语言输出
2. 读取 Design Doc（docs/superpowers/specs/ 下的技术设计文档）
3. 读取 openspec/changes/<name>/tasks.md（任务边界）
4. 按技能指引创建计划

计划要求：

• 保存至 docs/superpowers/plans/YYYY-MM-DD-<feature>.md
• 引用设计文档，拆分为可执行任务
• Plan 文件头必须包含关联元数据：

---
change: <openspec-change-name>
design-doc: docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md
base-ref: <git rev-parse HEAD before implementation>
---

base-ref 用于验证阶段跨提交统计改动规模。创建计划时先记录当前提交：

git rev-parse HEAD

将计划写入文件后，返回文件路径。

执行 subagent：使用当前平台的 subagent 调度机制派发上述任务。

Subagent 完成后：

• 若返回有效文件路径且文件存在，记录为 plan
• 若 subagent 失败或返回路径无效，在主 session 内联加载 Superpowers writing-plans 技能创建计划（降级回退）

2. 更新计划状态并提供 plan-ready 暂停点

先记录 plan 路径：

node "$COMET_STATE" set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md

无需手动更新 phase，阶段守卫（guard --apply）会在退出条件满足后推进 phase 字段。

计划写入后，立即提供一个新的用户决策点：

选项	行为	说明
A	继续执行	保持在当前模型中，进入 Step 3 选择工作区隔离、执行方式、TDD 模式和代码审查模式
B	暂停切换模型	记录 build_pause: plan-ready，本次 /comet-build 停止，用户稍后可从 /comet 或 /comet-build 恢复

这是用户决策点。必须按 comet/reference/decision-point.md 的协议暂停并等待用户明确选择，不得自动继续，也不得把暂停写入 build_mode。

用户选择继续时：