用途:在 OpenSpec 实验性工作流中,于实现完成后最终确认并归档一个已完成的变更。
主要能力与用法:先选择变更(可指定名称,或从上下文推断;有多个活动变更时需让用户选择)。若涉及已注册的 store,可先运行 openspec store list --json 获取 id,并在读写 specs 与 changes 的命令上追加 --store <id>;该标志一旦选定即在本工作流中保持。随后通过 openspec instructions archive --change "<name>" --json 加载归档输入(该查询为可选,失败时不阻塞归档),并用 openspec status --change "<name>" --json 检查产物完成状态;任务文件中的 - [ ] 与 - [x] 用于统计未完成任务。若有增量规格,会与主规格对比并提示同步或直接归档;选择同步时先运行 openspec instructions specs --change "<name>" --json,再内联执行 openspec-sync-specs 工作流,完成后重新校验各能力。最后在 changesDir 下建立 archive 目录,按 YYYY-MM-DD-<change-name> 命名(已有日期前缀不重复添加),用 mv 移动 changeRoot,并输出归档摘要。
适用场景:需要在实现完成后收尾并归档变更的 OpenSpec 用户。
限制:产物不完整或任务未完成时仅警告并要求确认,不阻塞归档;同步未完成前不得移动 changeRoot;归档目标已存在时报错;.openspec.yaml 随目录移动保留。运行上下文与操作指导属提示层,冲突时以既有步骤与命令契约为准。