用途:在 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>" 移动目录;目标名已带 YYYY-MM-DD- 前缀则沿用,否则补当前日期,不重复叠加日期。
限制与注意:产物或任务未完成时仅警告并请求确认,不阻断归档;若存在增量规格,必须先做同步评估并展示合并摘要再询问;同步必须内联执行并等待完成,绝不能在同步进行中移动 changeRoot;同步后需重新比对每个能力,若不一致则报告差异并停止归档;运行时上下文与操作指引仅作提示,冲突时以既有控制输入为准,且不得将其原文复制进输出文件。