Comet Build

Use when full Comet change 已完成 design 阶段,需要创建/恢复实施计划、选择执行方式或继续 build 阶段任务。

3,306 stars 317 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add rpamis/comet --skill comet-build
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-build ~/.claude/skills/comet-build

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 阶段 3:计划与构建(Build)

## 前置条件

- Design Doc 已创建(阶段 2 完成)
- 活跃 change 存在

## 步骤

### 0. 入口状态验证(Entry Check)

按 `comet/reference/scripts.md` 定位脚本(定位 `comet-env.mjs`),然后执行入口验证;从任意入口恢复时先按 `comet/reference/context-recovery.md` 运行恢复检查:

```bash
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 文件头必须包含关联元数据**:

```yaml
---
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` 用于验证阶段跨提交统计改动规模。创建计划时先记录当前提交:

```bash
git rev-parse HEAD
```

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

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

Subagent 完成后:
- 若返回有效文件路径且文件存在,记录为 plan
- 若 subagent 失败或返回路径无效,在主 session 内联加载 Superpowers `writing-plans` 技能创建计划(降级回退)

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

先记录 plan 路径:
Read the full skill on GitHub

Details

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

FAQ

What does the Comet Build skill do?

Use when full Comet change 已完成 design 阶段,需要创建/恢复实施计划、选择执行方式或继续 build 阶段任务。

How do I install the Comet Build skill?

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

Is Comet Build 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.