用途:在 OpenSpec 实验性工作流中,把已实现的变更收尾并归档。
主要能力:选择目标变更(可从上下文推断,只有一个活动变更时自动选择,否则运行 openspec list --json 让用户挑选);通过 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks 文件统计未完成任务;评估 delta spec 与主 spec 的同步状态,必要时以内联方式运行 openspec-sync-specs 智能合并,并在移动前验证每个能力的 ADDED/MODIFIED/REMOVED/RENAMED 已生效;最后创建归档目录并把 changeRoot 移动到 archive。
使用方式:若指定 store,先运行 openspec store list --json 获取 id,并在规格读写相关命令上附加 --store <id>(该标志在选择后保持粘性)。归档前可运行 openspec instructions archive --change "<name>" --json 获取上下文与操作建议;该查询为建议性,失败不阻塞归档。需要写主 spec 前,先运行 openspec instructions specs --change "<name>" --json,要求退出码为零且 JSON 有效,否则停止。归档时执行 mkdir -p "<planningHome.changesDir>/archive",再 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>",目标名已含 YYYY-MM-DD- 前缀时不再叠加日期。
适用场景:变更实现完成、需要合并 delta specs 并归档时。
限制:产物或任务不完整会提示确认,确认后可继续;delta spec 存在时必须先做同步评估;同步未完成前不得归档,否则主 spec 不会被更新;目标已存在则报错;同步失败或能力不匹配时停止并报告差异。运行上下文与操作指引不得原样写入输出文件。其余细节暂未提供。