用途:在 OpenSpec 实验性工作流中,把已实现完成的变更正式归档。适用于用户希望收尾并归档某个变更的场景。
主要能力:选择目标变更(可从对话上下文推断、唯一活跃变更自动选中,歧义时用 openspec list --json 让用户选择);用 openspec status --change "<name>" --json 检查产物完成状态;读取 tasks.md 统计未完成任务;对比 delta 规格与主规格,评估需要应用的增删改重命名;按用户选择同步规格或直接归档;把变更目录移动到 archive 并生成带日期前缀的目标名;输出归档摘要。
使用方式:若指定了 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>,选定后保持粘性。归档前可运行 openspec instructions archive --change "<name>" --json 获取可选上下文,该命令失败或返回无效 JSON 时不应阻断归档。同步前需运行 openspec instructions specs --change "<name>" --json 并要求零退出与有效 JSON,否则报错停止。同步以内联方式运行 openspec-sync-specs 工作流并等待完成,随后重新校验每个 delta 规格对应的能力,全部匹配才继续。归档时创建 archive 目录并执行 mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>",目标名已带 YYYY-MM-DD- 前缀时不重复加日期。
限制:产物或任务未完成只警告并请求确认,不阻断归档;同步进行中不得归档;delta 规格存在时必须先做同步评估并展示合并摘要;运行时上下文与操作指引不得原样写入输出文件;资料未提供具体平台、收费或效果信息。