[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72W1SW5JFWEJG3KX19TFWSX":3,"skill-same:01M72W1SW5JFWEJG3KX19TFWSX":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M72W1SW5JFWEJG3KX19TFWSX","comet-design",null,"Use when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc，或 design 阶段需要从 OpenSpec 交接包恢复。","rpamis\u002Fcomet","rpamis","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F153429891?v=4","01M72VXBR7EQYMM7KN8C19244V","01M72VXBRYC06QG0ZH0JBGV09V",3298,"MIT","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002F040-beta\u002Fcomet-design\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: comet-design\ndescription: \"Use when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc，或 design 阶段需要从 OpenSpec 交接包恢复。\"\n---\n\n# Comet 阶段 2：深度设计（Design）\n\n## 前置条件\n\n- 活跃 change 已存在（proposal.md、design.md、tasks.md）\n- 无 Design Doc（`docs\u002Fsuperpowers\u002Fspecs\u002F` 下无对应文件）\n\n> 职责边界：open 阶段的 `design.md` 给出**高层方案框架**（架构决策方向、方案选型、数据流）；design 阶段的 Design Doc 是对它的**深度技术细化**（详细实现设计、技术风险、测试策略、边界条件），是深化而非替代或重写。\n\n## 步骤\n\n### 0. 入口状态验证（Entry Check）\n\n按 `comet\u002Freference\u002Fscripts.md` 定位脚本（定位 `comet-env.mjs`），然后执行入口验证；从任意入口恢复时先按 `comet\u002Freference\u002Fcontext-recovery.md` 运行恢复检查：\n\n```bash\nnode \"$COMET_STATE\" check \u003Cname> design\n```\n\n验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。\n\n**幂等性**：所有 design 阶段操作可以安全重试。如果 `handoff_context` 和 `handoff_hash` 已存在，先确认它们与当前产物一致再决定是否重新生成。\n\n### 1a. 生成 OpenSpec → Superpowers 交接包\n\n**必须由脚本生成，不允许 agent 临场手写 summary 代替。**\n\n```bash\nnode \"$COMET_HANDOFF\" \u003Cchange-name> design --write\n```\n\n脚本会根据 change `.comet.yaml` 的 `context_compression` 快照生成并记录交接包。\n\n默认 `context_compression: off` 时生成：\n\n```text\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.md\n```\n\n启用 beta（项目 `.comet\u002Fconfig.yaml` 中 `context_compression: beta`，创建 change 时快照进入 `.comet.yaml`）时生成：\n\n```text\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.json\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.md\n```\n\n并在 `.comet.yaml` 写入：\n\n```yaml\nhandoff_context: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json\nhandoff_hash: \u003Csha256>\n```\n\n默认交接包是 **compact 可追溯摘录**，不是 agent summary：\n- `design-context.json`：机器索引，包含 change、phase、canonical spec、source paths、hash\n- `design-context.md`：供 Superpowers 阅读的上下文，包含脚本标记、source path、line range、sha256、确定性摘录\n- 超出摘录预算时标记 `[TRUNCATED]`，并保留 Full source 路径\n\nbeta 交接包是 **结构化 spec projection**，用于减少 OpenSpec 原文 token 占用但避免实现漂移：\n- `spec-context.json`：机器索引，包含 change、phase、mode=beta、source paths、context_hash、files 角色\n- `spec-context.md`：供 Superpowers 阅读的紧凑上下文，verbatim 投影 delta spec 文件并按 hash 引用支撑产物\n- OpenSpec delta spec 仍是 canonical spec；projection 缺失或过期时必须重新生成或读取源 spec，不得用 agent summary 替代\n\n如确实需要全文上下文，可显式运行：\n\n```bash\nnode \"$COMET_HANDOFF\" \u003Cchange-name> design --write --full\n```\n\n交接包来源来自 OpenSpec open 阶段产物：\n- `proposal.md`：目标、动机、范围、非目标\n- `design.md`：高层架构决策、方案约束\n- `tasks.md`：初始任务边界\n- `specs\u002F*\u002Fspec.md`：delta 能力规格\n\n### 1b. 执行 Brainstorming（带上下文）\n\n**立即执行：** 使用 Skill 工具加载 Superpowers `brainstorming` 技能。禁止跳过此步骤。\n\n技能加载时，ARGUMENTS 必须包含：\n\n```text\nLanguage: 使用触发本次工作流的用户请求语言输出\n```\n\n技能加载后，按其指引使用以下上下文：\n\n```text\nChange: \u003Cchange-name>\nOpenSpec Context Pack: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.md\nMachine handoff: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json\n\n如 context_compression: beta，则使用：\nOpenSpec Context Pack: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.md\nMachine handoff: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.json\n\nOpenSpec 产物是上游事实源，但不得用“跳过重复上下文探索”削弱 Superpowers `brainstorming` 的澄清流程。\n你的任务是基于交接包做深度技术设计：实现方案、技术风险、测试策略、边界条件。\n如发现目标、范围、非目标、验收场景或关键约束仍不清楚，必须先继续提问并形成设计方案，不得只进行一轮问答就创建 Design Doc。\n不要重写 proposal\u002Fspec；如发现 OpenSpec delta spec 缺少验收场景，只能提出 Spec Patch，并回写 OpenSpec delta spec；不要在 Design Doc 中创建第二份需求 spec。Spec Patch 仅限于补充验收场景、修正歧义描述或添加边界条件，不得大幅重写 delta spec 的结构或范围——如需大幅修改，应标记为设计发现并回到 brainstorming 确认。\n\nDesign Doc frontmatter 必须最小化，只包含：\n---\ncomet_change: \u003Cchange-name>\nrole: technical-design\ncanonical_spec: openspec\n---\n\n按 Superpowers `brainstorming` 技能原流程推进：澄清问题、2-3 个方案、分段确认设计。不得提前写入 Design Doc。\n```\n\n禁止在未加载该技能的情况下继续。\n\n如 Superpowers `brainstorming` 技能不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。\n\n技能加载后，按其指引产出设计方案（以对话形式呈现）：\n- 技术方案：架构、数据流、关键技术选型与风险\n- 测试策略\n- 需求\u002F范围缺口与需回写的 Spec Patch\n- 如需补充验收场景，标明将回写的 delta spec 变更\n\nbrainstorming 阶段不写入 Design Doc 文件，仅产出设计方案供 Step 1c 用户确认。确认后才创建 `docs\u002Fsuperpowers\u002Fspecs\u002FYYYY-MM-DD-\u003Ctopic>-design.md` 并回写 delta spec。\n\n但为了上下文压缩恢复，brainstorming 过程中必须增量更新 `brainstorm-summary.md`。每轮澄清或方案迭代后，只要产生新的已确认事实、关键约束、候选方案、取舍\u002F风险、测试策略或 Spec Patch 候选，就更新该文件；未确认内容必须标注为“待确认”或“候选”。该文件是恢复检查点，不是 Design Doc，也不得替代 Step 1c 的用户确认。\n\n### 1c. 用户确认设计方案（阻塞点）\n\nbrainstorming 产出设计方案后，**必须按 `comet\u002Freference\u002Fdecision-point.md` 的协议暂停并等待用户明确确认设计方案**。不得在用户确认前创建最终 Design Doc、写入 `design_doc`、运行 design guard，或进入 `\u002Fcomet-build`。\n\n暂停时只展示必要摘要：\n- 采用的技术方案\n- 关键取舍与风险\n- 测试策略\n- 如有 Spec Patch，列出将回写的 delta spec 变更\n\n用户明确确认后，才继续 Step 2。若用户要求调整，继续 brainstorming 迭代，直到用户确认。\n\n\n### 1d. Brainstorming 检查点定稿\n\n用户确认设计方案后，在创建 Design Doc 前，创建或更新已增量维护的检查点文件，将其定稿为确认后的设计方案摘要：\n\n```bash\nmkdir -p openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\n```\n\n`openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fbrainstorm-summary.md` 结构：\n\n```markdown\n# Brainstorm Summary\n\n- Change: \u003Cchange-name>\n- Date: \u003CYYYY-MM-DD>\n\n## 确认的技术方案\n\n\u003C用户确认的方案摘要>\n\n## 关键取舍与风险\n\n\u003C主要取舍和风险>\n\n## 测试策略\n\n\u003C测试方法概述>\n\n## Spec Patch\n\n\u003C将回写的 delta spec 变更，无则写\"无\">\n```\n\n**上下文压缩说明**：每次增量更新 `brainstorm-summary.md` 后，都是相对安全的压缩恢复点。Brainstorming 完成后，如上下文窗口紧张，应优先在此处进行压缩。压缩后重新加载以下文件继续 Step 2：\n- `openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fbrainstorm-summary.md`\n- `openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.md`（或 beta 模式的 `spec-context.md`）\n- `openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json`（或 beta 模式的 `spec-context.json`）\n\n### 1e. 主动式上下文压缩\n\n完成 Step 1d 并确认 `brainstorm-summary.md` 已写入后，进入 Design Doc 创建前的主动式上下文压缩。此时 OpenSpec 交接包、brainstorming 决策和待确认项都已落盘，应主动释放前面读取 Spec 和 brainstorming 消耗的上下文，为 Step 2 及后续 Build 阶段保留窗口。\n\n执行规则：\n- 如果当前平台提供原生上下文压缩\u002F清理机制（例如宿主 Agent 的 compact\u002Fcompaction 命令、工具或 UI 操作），必须在这里触发一次主动压缩；不要尝试用 shell 脚本伪造压缩命令。\n- 压缩恢复提示必须包含 change 名称、当前步骤（Design Step 2）、以及上方三类需重新加载的 handoff 文件。\n- 如果当前平台无法由 agent 程序化触发压缩，必须暂停并提示用户在宿主平台执行手动压缩；用户确认无法压缩或要求继续时，才继续 Step 2。\n\n### 2. 创建 Design Doc\n\n基于 brainstorming 对话的完整上下文（仍在主 session 中），创建 Design Doc。\n\nDesign Doc frontmatter 必须最小化：\n\n```yaml\n---\ncomet_change: \u003Cchange-name>\nrole: technical-design\ncanonical_spec: openspec\n---\n```\n\n将 Design Doc 写入 `docs\u002Fsuperpowers\u002Fspecs\u002FYYYY-MM-DD-\u003Ctopic>-design.md`。\n如需回写 delta spec（Spec Patch），同时编辑对应的 `specs\u002F*\u002Fspec.md`。\n\n**上下文压缩恢复**：若上下文已被压缩，从 `brainstorm-summary.md` + handoff 上下文恢复。若用户尚未确认设计方案，回到 Step 1b\u002F1c 继续 brainstorming；若用户已确认，继续创建 Design Doc。brainstorm-summary.md 是压缩恢复的落盘点，不是 Design Doc 的唯一输入——创建时应尽可能利用恢复后的完整上下文。\n\n### 3. 更新 Comet 状态\n\n先记录 design_doc 路径。如果 Spec Patch 回写了 delta spec（新增或修改了 `specs\u002F*\u002Fspec.md`），必须重新生成 handoff 以更新 hash：\n\n```bash\n# 记录 design_doc 路径\nnode \"$COMET_STATE\" set \u003Cname> design_doc docs\u002Fsuperpowers\u002Fspecs\u002FYYYY-MM-DD-topic-design.md\n\n# 如有 delta spec 变更，重新生成 handoff（更新 hash）\nnode \"$COMET_HANDOFF\" \u003Cchange-name> design --write\n\n# 阶段守卫推进 phase 到下一阶段\nnode \"$COMET_GUARD\" \u003Cchange-name> design --apply\n```\n\n如果没有 delta spec 变更，跳过 handoff 重新生成步骤。状态文件自动更新，无需手动编辑其他字段。\n\n## 退出条件\n\n- Design Doc 已创建并保存\n- Design Doc frontmatter 包含 `comet_change`、`role: technical-design`、`canonical_spec: openspec`\n- `handoff_context` 和 `handoff_hash` 已写入 `.comet.yaml`（由 guard 强制校验）\n- `handoff_hash` 与当前 OpenSpec open 阶段产物一致（由 guard 强制校验）\n- `design-context.md` 或 beta `spec-context.md` 必须是脚本生成，且包含 source path、mode、sha256 等可追溯标记（由 guard 强制校验）\n- beta 模式下，`spec-context.json` 必须结构合法且引用当前源文件（由 guard 强制校验）\n- 如有新能力或补充验收场景，OpenSpec delta spec 已创建\u002F更新\n- `design_doc` 已写入 `.comet.yaml`\n- **阶段守卫**：运行 `node \"$COMET_GUARD\" \u003Cchange-name> design --apply`，全部 PASS 后由守卫推进到 `phase: build`（此步骤更新 `phase` 字段，与 `auto_transition` 无关）\n\n退出前必须使用 `--apply`：\n\n```bash\nnode \"$COMET_GUARD\" \u003Cchange-name> design --apply\n```\n\n## 上下文压缩恢复\n\n按 `comet\u002Freference\u002Fcontext-recovery.md` 执行，phase 参数为 `design`。\n\n## 自动衔接下一阶段\n\n按 `comet\u002Freference\u002Fauto-transition.md` 执行。关键命令：\n\n```bash\nnode \"$COMET_STATE\" next \u003Cchange-name>\n```\n\n- `NEXT: auto` → 调用 `SKILL` 指向的 skill 进入下一阶段\n- `NEXT: manual` → 不要调用下一 skill，按 `HINT` 提示用户手动运行 `\u002F\u003CSKILL>`\n- `NEXT: done` → 流程已完成，无需继续\n","# Comet 阶段 2：深度设计（Design）\n\n## 前置条件\n\n- 活跃 change 已存在（proposal.md、design.md、tasks.md）\n- 无 Design Doc（`docs\u002Fsuperpowers\u002Fspecs\u002F` 下无对应文件）\n\n> 职责边界：open 阶段的 `design.md` 给出**高层方案框架**（架构决策方向、方案选型、数据流）；design 阶段的 Design Doc 是对它的**深度技术细化**（详细实现设计、技术风险、测试策略、边界条件），是深化而非替代或重写。\n\n## 步骤\n\n### 0. 入口状态验证（Entry Check）\n\n按 `comet\u002Freference\u002Fscripts.md` 定位脚本（定位 `comet-env.mjs`），然后执行入口验证；从任意入口恢复时先按 `comet\u002Freference\u002Fcontext-recovery.md` 运行恢复检查：\n\n```bash\nnode \"$COMET_STATE\" check \u003Cname> design\n```\n\n验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。\n\n**幂等性**：所有 design 阶段操作可以安全重试。如果 `handoff_context` 和 `handoff_hash` 已存在，先确认它们与当前产物一致再决定是否重新生成。\n\n### 1a. 生成 OpenSpec → Superpowers 交接包\n\n**必须由脚本生成，不允许 agent 临场手写 summary 代替。**\n\n```bash\nnode \"$COMET_HANDOFF\" \u003Cchange-name> design --write\n```\n\n脚本会根据 change `.comet.yaml` 的 `context_compression` 快照生成并记录交接包。\n\n默认 `context_compression: off` 时生成：\n\n```text\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.md\n```\n\n启用 beta（项目 `.comet\u002Fconfig.yaml` 中 `context_compression: beta`，创建 change 时快照进入 `.comet.yaml`）时生成：\n\n```text\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.json\nopenspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.md\n```\n\n并在 `.comet.yaml` 写入：\n\n```yaml\nhandoff_context: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json\nhandoff_hash: \u003Csha256>\n```\n\n默认交接包是 **compact 可追溯摘录**，不是 agent summary：\n- `design-context.json`：机器索引，包含 change、phase、canonical spec、source paths、hash\n- `design-context.md`：供 Superpowers 阅读的上下文，包含脚本标记、source path、line range、sha256、确定性摘录\n- 超出摘录预算时标记 `[TRUNCATED]`，并保留 Full source 路径\n\nbeta 交接包是 **结构化 spec projection**，用于减少 OpenSpec 原文 token 占用但避免实现漂移：\n- `spec-context.json`：机器索引，包含 change、phase、mode=beta、source paths、context_hash、files 角色\n- `spec-context.md`：供 Superpowers 阅读的紧凑上下文，verbatim 投影 delta spec 文件并按 hash 引用支撑产物\n- OpenSpec delta spec 仍是 canonical spec；projection 缺失或过期时必须重新生成或读取源 spec，不得用 agent summary 替代\n\n如确实需要全文上下文，可显式运行：\n\n```bash\nnode \"$COMET_HANDOFF\" \u003Cchange-name> design --write --full\n```\n\n交接包来源来自 OpenSpec open 阶段产物：\n- `proposal.md`：目标、动机、范围、非目标\n- `design.md`：高层架构决策、方案约束\n- `tasks.md`：初始任务边界\n- `specs\u002F*\u002Fspec.md`：delta 能力规格\n\n### 1b. 执行 Brainstorming（带上下文）\n\n**立即执行：** 使用 Skill 工具加载 Superpowers `brainstorming` 技能。禁止跳过此步骤。\n\n技能加载时，ARGUMENTS 必须包含：\n\n```text\nLanguage: 使用触发本次工作流的用户请求语言输出\n```\n\n技能加载后，按其指引使用以下上下文：\n\n```text\nChange: \u003Cchange-name>\nOpenSpec Context Pack: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.md\nMachine handoff: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json\n\n如 context_compression: beta，则使用：\nOpenSpec Context Pack: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.md\nMachine handoff: openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fspec-context.json\n\nOpenSpec 产物是上游事实源，但不得用“跳过重复上下文探索”削弱 Superpowers `brainstorming` 的澄清流程。\n你的任务是基于交接包做深度技术设计：实现方案、技术风险、测试策略、边界条件。\n如发现目标、范围、非目标、验收场景或关键约束仍不清楚，必须先继续提问并形成设计方案，不得只进行一轮问答就创建 Design Doc。\n不要重写 proposal\u002Fspec；如发现 OpenSpec delta spec 缺少验收场景，只能提出 Spec Patch，并回写 OpenSpec delta spec；不要在 Design Doc 中创建第二份需求 spec。Spec Patch 仅限于补充验收场景、修正歧义描述或添加边界条件，不得大幅重写 delta spec 的结构或范围——如需大幅修改，应标记为设计发现并回到 brainstorming 确认。\n\nDesign Doc frontmatter 必须最小化，只包含：\n---\ncomet_change: \u003Cchange-name>\nrole: technical-design\ncanonical_spec: openspec\n---\n\n按 Superpowers `brainstorming` 技能原流程推进：澄清问题、2-3 个方案、分段确认设计。不得提前写入 Design Doc。\n```\n\n禁止在未加载该技能的情况下继续。\n\n如 Superpowers `brainstorming` 技能不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。\n\n技能加载后，按其指引产出设计方案（以对话形式呈现）：\n- 技术方案：架构、数据流、关键技术选型与风险\n- 测试策略\n- 需求\u002F范围缺口与需回写的 Spec Patch\n- 如需补充验收场景，标明将回写的 delta spec 变更\n\nbrainstorming 阶段不写入 Design Doc 文件，仅产出设计方案供 Step 1c 用户确认。确认后才创建 `docs\u002Fsuperpowers\u002Fspecs\u002FYYYY-MM-DD-\u003Ctopic>-design.md` 并回写 delta spec。\n\n但为了上下文压缩恢复，brainstorming 过程中必须增量更新 `brainstorm-summary.md`。每轮澄清或方案迭代后，只要产生新的已确认事实、关键约束、候选方案、取舍\u002F风险、测试策略或 Spec Patch 候选，就更新该文件；未确认内容必须标注为“待确认”或“候选”。该文件是恢复检查点，不是 Design Doc，也不得替代 Step 1c 的用户确认。\n\n### 1c. 用户确认设计方案（阻塞点）\n\nbrainstorming 产出设计方案后，**必须按 `comet\u002Freference\u002Fdecision-point.md` 的协议暂停并等待用户明确确认设计方案**。不得在用户确认前创建最终 Design Doc、写入 `design_doc`、运行 design guard，或进入 `\u002Fcomet-build`。\n\n暂停时只展示必要摘要：\n- 采用的技术方案\n- 关键取舍与风险\n- 测试策略\n- 如有 Spec Patch，列出将回写的 delta spec 变更\n\n用户明确确认后，才继续 Step 2。若用户要求调整，继续 brainstorming 迭代，直到用户确认。\n\n\n### 1d. Brainstorming 检查点定稿\n\n用户确认设计方案后，在创建 Design Doc 前，创建或更新已增量维护的检查点文件，将其定稿为确认后的设计方案摘要：\n\n```bash\nmkdir -p openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\n```\n\n`openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fbrainstorm-summary.md` 结构：\n\n```markdown\n# Brainstorm Summary\n\n- Change: \u003Cchange-name>\n- Date: \u003CYYYY-MM-DD>\n\n## 确认的技术方案\n\n\u003C用户确认的方案摘要>\n\n## 关键取舍与风险\n\n\u003C主要取舍和风险>\n\n## 测试策略\n\n\u003C测试方法概述>\n\n## Spec Patch\n\n\u003C将回写的 delta spec 变更，无则写\"无\">\n```\n\n**上下文压缩说明**：每次增量更新 `brainstorm-summary.md` 后，都是相对安全的压缩恢复点。Brainstorming 完成后，如上下文窗口紧张，应优先在此处进行压缩。压缩后重新加载以下文件继续 Step 2：\n- `openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fbrainstorm-summary.md`\n- `openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.md`（或 beta 模式的 `spec-context.md`）\n- `openspec\u002Fchanges\u002F\u003Cname>\u002F.comet\u002Fhandoff\u002Fdesign-context.json`（或 beta 模式的 `spec-context.json`）\n\n### 1e. 主动式上下文压缩\n\n完成 Step 1d 并确认 `brainstorm-summary.md` 已写入后，进入 Design Doc 创建前的主动式上下文压缩。此时 OpenSpec 交接包、brainstorming 决策和待确认项都已落盘，应主动释放前面读取 Spec 和 brainstorming 消耗的上下文，为 Step 2 及后续 Build 阶段保留窗口。\n\n执行规则：\n- 如果当前平台提供原生上下文压缩\u002F清理机制（例如宿主 Agent 的 compact\u002Fcompaction 命令、工具或 UI 操作），必须在这里触发一次主动压缩；不要尝试用 shell 脚本伪造压缩命令。\n- 压缩恢复提示必须包含 change 名称、当前步骤（Design Step 2）、以及上方三类需重新加载的 handoff 文件。\n- 如果当前平台无法由 agent 程序化触发压缩，必须暂停并提示用户在宿主平台执行手动压缩；用户确认无法压缩或要求继续时，才继续 Step 2。\n\n### 2. 创建 Design Doc\n\n基于 brainstorming 对话的完整上下文（仍在主 session 中），创建 Design Doc。\n\nDesign Doc frontmatter 必须最小化：\n\n```yaml\n---\ncomet_change: \u003Cchange-name>\nrole: technical-design\ncanonical_spec: openspec\n---\n```\n\n将 Design Doc 写入 `docs\u002Fsuperpowers\u002Fspecs\u002FYYYY-MM-DD-\u003Ctopic>-design.md`。\n如需回写 delta spec（Spec Patch），同时编辑对应的 `specs\u002F*\u002Fspec.md`。\n\n**上下文压缩恢复**：若上下文已被压缩，从 `brainstorm-summary.md` + handoff 上下文恢复。若用户尚未确认设计方案，回到 Step 1b\u002F1c 继续 brainstorming；若用户已确认，继续创建 Design Doc。brainstorm-summary.md 是压缩恢复的落盘点，不是 Design Doc 的唯一输入——创建时应尽可能利用恢复后的完整上下文。\n\n### 3. 更新 Comet 状态\n\n先记录 design_doc 路径。如果 Spec Patch 回写了 delta spec（新增或修改了 `specs\u002F*\u002Fspec.md`），必须重新生成 handoff 以更新 hash：\n\n```bash\n# 记录 design_doc 路径\nnode \"$COMET_STATE\" set \u003Cname> design_doc docs\u002Fsuperpowers\u002Fspecs\u002FYYYY-MM-DD-topic-design.md\n\n# 如有 delta spec 变更，重新生成 handoff（更新 hash）\nnode \"$COMET_HANDOFF\" \u003Cchange-name> design --write\n\n# 阶段守卫推进 phase 到下一阶段\nnode \"$COMET_GUARD\" \u003Cchange-name> design --apply\n```\n\n如果没有 delta spec 变更，跳过 handoff 重新生成步骤。状态文件自动更新，无需手动编辑其他字段。\n\n## 退出条件\n\n- Design Doc 已创建并保存\n- Design Doc frontmatter 包含 `comet_change`、`role: technical-design`、`canonical_spec: openspec`\n- `handoff_context` 和 `handoff_hash` 已写入 `.comet.yaml`（由 guard 强制校验）\n- `handoff_hash` 与当前 OpenSpec open 阶段产物一致（由 guard 强制校验）\n- `design-context.md` 或 beta `spec-context.md` 必须是脚本生成，且包含 source path、mode、sha256 等可追溯标记（由 guard 强制校验）\n- beta 模式下，`spec-context.json` 必须结构合法且引用当前源文件（由 guard 强制校验）\n- 如有新能力或补充验收场景，OpenSpec delta spec 已创建\u002F更新\n- `design_doc` 已写入 `.comet.yaml`\n- **阶段守卫**：运行 `node \"$COMET_GUARD\" \u003Cchange-name> design --apply`，全部 PASS 后由守卫推进到 `phase: build`（此步骤更新 `phase` 字段，与 `auto_transition` 无关）\n\n退出前必须使用 `--apply`：\n\n```bash\nnode \"$COMET_GUARD\" \u003Cchange-name> design --apply\n```\n\n## 上下文压缩恢复\n\n按 `comet\u002Freference\u002Fcontext-recovery.md` 执行，phase 参数为 `design`。\n\n## 自动衔接下一阶段\n\n按 `comet\u002Freference\u002Fauto-transition.md` 执行。关键命令：\n\n```bash\nnode \"$COMET_STATE\" next \u003Cchange-name>\n```\n\n- `NEXT: auto` → 调用 `SKILL` 指向的 skill 进入下一阶段\n- `NEXT: manual` → 不要调用下一 skill，按 `HINT` 提示用户手动运行 `\u002F\u003CSKILL>`\n- `NEXT: done` → 流程已完成，无需继续\n",{"name":5,"description":7},"master","a61a2e5b4766e1ad62377dec598e402560a259b6","eval\u002Flocal\u002Fskills\u002Fbenchmarks\u002F040-beta\u002Fcomet-design",314,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet","https:\u002F\u002Fdocs.comet.rpamis.com","https:\u002F\u002Fgithub.com\u002Frpamis","More Efficient, Easier to Use, and Less Annoying","2026-11-15 00:26:58",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add rpamis\u002Fcomet --skill comet-design",{"tool":38,"command":39},"bunx","bunx skills add rpamis\u002Fcomet --skill comet-design",{"tool":41,"command":42},"pnpm","pnpm dlx skills add rpamis\u002Fcomet --skill comet-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002F040-beta\u002Fcomet-design\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M72W3K6F0C2FKZ8DHABM49R7","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M72W3HCPQ3GVMACX61QJTD4B","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M72W3F8EVD3EK4NXJG40P84K","verification-before-completion","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M72W3CA9YM0Y6CSXXTNCV1CA","using-git-worktrees","Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fusing-git-worktrees\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M72W3AEH0F548GTPRNYRR3H3","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M72W38EN8NEKX1YN4W9G19Y2","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fsystematic-debugging\u002FSKILL.md",[],[]]