Comet Archive

Use when Comet change 验证已通过,需要用户确认归档、合并 delta spec,或恢复 archive 阶段。

3,306 stars 317 forksOther

Install

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

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 阶段 5:归档(Archive)

## 前置条件

- 验证已通过(阶段 4 完成)
- 分支已处理
- `openspec/changes/<name>/.comet.yaml` 中 `verify_result: pass`

## 步骤

### 0. 输出语言约束

归档摘要和生命周期闭环说明必须使用触发本次工作流的用户请求语言。

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

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

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

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

### 1. 归档前最终确认(阻塞点)

入口验证通过后,**必须按 `comet/reference/decision-point.md` 的协议暂停并等待用户确认是否立即归档**。不得在用户确认前运行 `node "$COMET_ARCHIVE" "<change-name>"`。

确认前必须向用户展示简短摘要:
- change 名称
- 验证报告路径和结论
- 分支处理状态
- 本次归档将执行的不可逆动作:按 OpenSpec delta 语义合并主 spec、标注 design doc / plan、移动 change 到 archive 目录

用户确认问题必须以单选题形式呈现,包含以下选项:
- 「确认归档」— 立即执行归档脚本,完成 spec 合并和 change 移动
- 「需要调整或重新验证」— 不执行归档;运行 `node "$COMET_STATE" transition <change-name> archive-reopen` 回到 `phase: verify`,再调用 `/comet-verify`。若验证阶段确认需要修复,再按 `/comet-verify` 的验证失败决策回到 `/comet-build`
- 「暂不归档」— 不执行归档,保留当前 `phase: archive` 状态,等待用户稍后再次调用 `/comet-archive`

只有用户选择「确认归档」后,才允许继续 Step 2。用户选择「需要调整或重新验证」后,必须先执行 `archive-reopen` 状态回退,不得手动编辑 `.comet.yaml`。

### 2. 执行归档

运行归档脚本,自动完成以下全部步骤:

```bash
node "$COMET_ARCHIVE" "<change-name>"
```

脚本自动执行:
1. 入口状态验证(phase=archive, verify_result=pass, archived=false)
2. Design doc 前置元数据标注(archived-with, status)
3. Plan 前置元数据标注(archived-with)
4. 调用 OpenSpec archive 按 delta 语义合并主 spec 并移动 change 到归档目录
5. 校验主 spec 未残留 delta-only section 标题
Read the full skill on GitHub

Details

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

FAQ

What does the Comet Archive skill do?

Use when Comet change 验证已通过,需要用户确认归档、合并 delta spec,或恢复 archive 阶段。

How do I install the Comet Archive skill?

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

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