用途:在 OpenSpec 实验性工作流中归档已完成的变更,适用于实现完成后需要定稿并归档变更的场景。
主要能力:选择变更(按名称、上下文推断或列出活动变更让用户选择);检查工件完成状态(openspec status --change "<name>" --json);检查任务完成情况;评估 delta 规格与主规格的同步状态,可选择立即同步或跳过同步归档;执行归档,将 changeRoot 移动到 archive 目录,目标名以当前日期 YYYY-MM-DD-<change-name> 为前缀(已有日期前缀则不重复叠加),归档保留 .openspec.yaml。
使用方式:可选指定变更名;先用 openspec instructions archive --change "<name>" --json 读取归档输入(失败可继续);用 openspec status --change "<name>" --json 检查工件;若有 delta 规格,可先运行 openspec instructions specs --change "<name>" --json,再以内联方式执行 openspec-sync-specs 工作流,并复核每个能力。若使用已注册 store,先运行 openspec store list --json,随后在读写规格与变更的命令上附加 --store <id>,且该标志在该工作流后续保持粘性。归档命令:mkdir -p "<planningHome.changesDir>/archive",再 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"。
限制:工件或任务不完整时只警告并请求确认,不阻断归档;目标归档名已存在则报错并建议重命名或改日期;规格同步未完成前不得归档,同步不得委派到后台任务;同步失败或校验不符时报告差异并停止,不移动变更;instructions 返回的规则仅约束写入的主规格内容与形式,不作为归档指引;运行时上下文与操作指引冲突时报告冲突并保留控制值,不逐字复制到输出文件。具体平台支持与定价暂未提供。