用途:在实验性 OpenSpec 工作流中,把已完成的变更定稿并移入归档目录;可先同步 delta 规格,再进行归档。
主要能力:选择变更(名称、会话上下文或列表挑选);通过 openspec status --change "<name>" --json 检查工件完成情况;读取 tasks.md 统计未完任务;比对 delta 规格与主规格,提示同步或直接归档;执行 mkdir -p "<planningHome.changesDir>/archive" 并 mv "<changeRoot>" 到归档路径。
使用方式:先确认变更,运行 openspec instructions archive --change "<name>" --json;该命令为可选提示输入,失败不阻塞。若涉及注册 store,先用 openspec store list --json 获取 id,并在读写的命令上追加 --store "<id>"(如 openspec status --change "<name>" --json --store "<id>")。归档目标名:若变更名已含 YYYY-MM-DD- 前缀则沿用,否则加上当前日期前缀,不重复叠加日期。若选择同步,需在写主规格前运行 openspec instructions specs --change "<name>" --json 并以零退出成功为前提,然后内联执行 openspec-sync-specs 工作流并重新校验。
适用场景与限制:适合实现完成后的变更收尾;不完整工件或任务只提示并确认,不阻断归档。目标已存在则报错。.openspec.yaml 随目录移动保留。同步进行中不得归档,需内联同步并校验主规格后再移动。资料未提供官方文档与更多参数细节。