Comet Design

Handles the design phase of Comet's change workflow when you've wrapped up the open phase but don't have a Superpowers Design Doc yet. It generates a handoff package from your OpenSpec artifacts (proposal, design, tasks, specs), then loads the brainstorming skill to walk through technical design with proper context. The handoff uses deterministic excerpts with source paths and hashes, not summaries an agent made up on the spot. You'll go through clarifying questions, compare a few approaches, and confirm a design before it writes the actual doc. Includes checkpoint recovery if your context window fills up mid-brainstorm. The guard won't let you proceed until the handoff hash matches your OpenSpec output and the design doc has the right frontmatter.

skills.sh installs: 864
GitHub stars: 3.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add rpamis/comet --skill comet-design --agent claude-code

Installs into .claude/skills of the current project.

Files

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

首次进入阶段、交接给新 Agent 或上下文恢复后，读取并执行任务上下文与产物语言，优先采用当前 continuation 或已领取 Action 的 contextRequest；同一阶段连续执行不重复获取。

收到入口返回的 layout 后，首次接收阶段或绑定变化时执行阶段共用入口，复用仍有效的 layout，无需先额外运行 root show；遇编辑判断时按共用入口加载编辑后续行协议。

SDK Run 路径

首次进入当前 SDK 阶段、换 Agent 或恢复上下文时，读取阶段入口与恢复及该参考的当前阶段章节；本会话已有且仍有效时直接复用。下文按当前阶段执行；nextAction.kind 的恢复路由只适用于没有 continuation mode 的旧响应。

优先复用同一 change、工作区和 Run 的最新有效响应中的 agent.continuation、data.nextAction、phase、revision 和路径摘要。只有冷恢复、工作区或外部状态变化、响应版本已过期或缺少当前步骤必要信息时，才运行 comet state next <change-name> --json；不要因加载下一 Skill 再读一次。后续写操作仍由 Runtime 校验当前版本与证据，不能用缓存跳过检查或批准。当 data.runtimeFormat 为 sdk 时，只执行本节的状态命令；设计探索、提问与正式文档要求见 SDK 方法参考的 Design 章节，状态操作使用本节命令。data.phase 必须为 design；已进入 Build 时交回当前阶段入口。data.nextAction.kind 为 reconcile 时，运行 comet state check <change-name> design --recover --json 核对已领取 Action 的原结果，在结果明确前停止，不重新提案或重发工作。