用途:在 OpenSpec 实验性工作流中,把已实现完成的变更定稿并归档。
主要能力:选择目标变更(可指定名称,或从上下文推断、自动选择、列出后让用户选择);通过 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;依据 artifactPaths.specs.existingOutputPaths 评估增量规格与主规格的同步状态;创建归档目录并把变更目录移动到带日期前缀的目标位置;输出归档摘要。
使用方式:若使用已注册的 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,该选择在后续流程中保持。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,失败不阻塞。同步前需运行 openspec instructions specs --change "<name>" --json 并校验返回。归档时执行 mkdir -p "<planningHome.changesDir>/archive",再 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。
适用场景:变更实现完成、需要同步增量规格并归档时。
限制:产物或任务未完成只警告并需用户确认,不阻塞;同步必须内联执行并验证主规格后才能移动 changeRoot;目标归档名已存在则报错;运行时上下文与操作指引不得原样写入输出文件。