用途:在 OpenSpec 实验性工作流中,将已实现完成的变更定稿并归档。
主要能力:选择变更(不自动猜测,未提供时提示用户从活跃变更中挑选);通过 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;评估增量规格与主规格的同步状态;执行归档并输出摘要。
使用方式:若使用已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上附加 --store <id>;否则命令作用于最近的本地 openspec/ 根目录。归档时在 planningHome.changesDir 下创建 archive 目录,按 YYYY-MM-DD-<change-name> 命名并移动变更目录;若目标已存在则报错。同步可选,通过 openspec-sync-specs 由代理驱动执行。
适用场景:变更实现完毕、需要归档并同步规格时。
限制:产物或任务未完成只警告并确认,不阻断归档;移动时保留 .openspec.yaml;存在增量规格时必须先做同步评估并展示汇总再提示。