Comet Design

Use when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc,或 design 阶段需要从 OpenSpec 交接包恢复。

3,306 stars 317 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add rpamis/comet --skill comet-design
Manual install
git clone --depth 1 https://github.com/rpamis/comet.git /tmp/comet
mkdir -p ~/.claude/skills
cp -r /tmp/comet/eval/local/skills/benchmarks/040-beta/comet-design ~/.claude/skills/comet-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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` 运行恢复检查:

```bash
node "$COMET_STATE" check <name> design
```

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

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

### 1a. 生成 OpenSpec → Superpowers 交接包

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

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

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

默认 `context_compression: off` 时生成:

```text
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`)时生成:

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

并在 `.comet.yaml` 写入:

```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
Read the full skill on GitHub

Details

Skill name
comet-design
Repository
rpamis/comet
Path
eval/local/skills/benchmarks/040-beta/comet-design/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Comet Design skill do?

Use when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc,或 design 阶段需要从 OpenSpec 交接包恢复。

How do I install the Comet Design skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add rpamis/comet --skill comet-design. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Comet Design popular?

It lives in rpamis/comet, which has 3,306 GitHub stars and 317 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.