用途:在实验性工作流中归档已完成的变更,适合用户希望在实现完成后收尾并归档变更时使用。
主要能力:选择变更(可按名称、对话上下文推断或自动选择唯一活动变更,含糊时必须让用户选择);用 openspec status --change "<name>" --json 检查工件完成状态;读取 tasks.md 统计未完成任务;依据 status JSON 中 artifactPaths.specs.existingOutputPaths 评估增量规格与主规格的同步状态,并在需要时先运行 openspec-sync-specs 内联同步并验证,再执行归档。
使用方式:若存在 store,先运行 openspec store list --json 发现 id,并在读取或写入规格与变更的命令上加 --store <id>,之后保持 sticky。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文;同步写入主规格前须运行 openspec instructions specs --change "<name>" --json 并须零退出与合法 JSON。归档用 mkdir -p "<planningHome.changesDir>/archive" 后,将 changeRoot 移动到带 YYYY-MM-DD- 前缀的目标名,已有前缀则不重复加日期。
适用场景:变更实现完成、需要把变更目录移入 archive 并确保主规格同步。
限制:工件或任务未完成只在用户确认后可继续;目标名已存在则失败;同步失败或能力不匹配必须停止、不得归档;同步不得后台委派,避免归档与同步冲突;不完整或无法运行的 CLI 指令查询不阻断归档。资料未提供收费、平台与效果等信息。