Comet 阶段 2：深度设计（Design）

前置条件

• 活跃 change 已存在（proposal.md、design.md、tasks.md）
• 无 Design Doc（docs/superpowers/specs/ 下无对应文件）

职责边界：open 阶段的 design.md 给出高层方案框架（架构决策方向、方案选型、数据流）；design 阶段的 Design Doc 是对它的深度技术细化（详细实现设计、技术风险、测试策略、边界条件），是深化而非替代或重写。

步骤

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

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

node "$COMET_STATE" check <name> design

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

幂等性：所有 design 阶段操作可以安全重试。如果 handoff_context 和 handoff_hash 已存在，先确认它们与当前产物一致再决定是否重新生成。

1a. 生成 OpenSpec → Superpowers 交接包

必须由脚本生成，不允许 agent 临场手写 summary 代替。

node "$COMET_HANDOFF" <change-name> design --write

脚本会根据 change .comet.yaml 的 context_compression 快照生成并记录交接包。

默认 context_compression: off 时生成：

openspec/changes/<name>/.comet/handoff/design-context.json
openspec/changes/<name>/.comet/handoff/design-context.md

启用 beta（项目 .comet/config.yaml 中 context_compression: beta，创建 change 时快照进入 .comet.yaml）时生成：

openspec/changes/<name>/.comet/handoff/spec-context.json
openspec/changes/<name>/.comet/handoff/spec-context.md

并在 .comet.yaml 写入：

handoff_context: openspec/changes/<name>/.comet/handoff/design-context.json
handoff_hash: <sha256>

默认交接包是 compact 可追溯摘录，不是 agent summary：

• design-context.json：机器索引，包含 change、phase、canonical spec、source paths、hash
• design-context.md：供 Superpowers 阅读的上下文，包含脚本标记、source path、line range、sha256、确定性摘录
• 超出摘录预算时标记 [TRUNCATED]，并保留 Full source 路径

beta 交接包是 结构化 spec projection，用于减少 OpenSpec 原文 token 占用但避免实现漂移：

• spec-context.json：机器索引，包含 change、phase、mode=beta、source paths、context_hash、files 角色
• spec-context.md：供 Superpowers 阅读的紧凑上下文，verbatim 投影 delta spec 文件并按 hash 引用支撑产物
• OpenSpec delta spec 仍是 canonical spec；projection 缺失或过期时必须重新生成或读取源 spec，不得用 agent summary 替代

如确实需要全文上下文，可显式运行：