Comet Archive

This handles the final stage of the Comet workflow after verification passes. It walks through merging delta specs back into the main spec, moving the change directory into a timestamped archive folder, and annotating design docs with archive metadata. The key bit is it blocks at the start to make you explicitly confirm the archive action with three options: proceed, reopen for more verification, or wait. It runs state checks, executes the archive script, then reminds you to commit the changes since the script doesn't auto-commit. The whole thing enforces OpenSpec's delta semantics and makes sure you don't leave half-archived artifacts in your working directory.

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

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

Comet 阶段 5：归档（Archive）

首次进入阶段、交接给新 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、phase 和 nextAction.kind，在已绑定的 projectRoot 执行；路径缺失或绑定发生变化时才运行 comet classic workspace resolve <change-name> --json。SDK Run 的 Verify 收据必须仍有效；状态文件和验证报告存在并不表示已获归档授权。reconcile 时运行 comet state check <change-name> archive --recover --json 核对原 Action 与磁盘、Git 证据，结果未明时不重做归档、提交、push 或 PR。

SKILL.md on GitHub

Details

Repository: github.com/rpamis/comet
First seen: Jul 14, 2026

More from rpamis/comet

All 8