用途:在 OpenSpec 实验性工作流中,把已实现完成的变更正式收尾并归档。
主要能力:选择目标变更(可由参数指定、从上下文推断,或列出活动变更让用户选择);用 openspec status --change "<name>" --json 检查产物完成状态,读取 tasks 文件统计未完成任务;比较 delta spec 与主规格,给出合并变更摘要并提示是否同步;同步后再次校验各能力是否已同步(新增、修改、删除、重命名要求是否符合)。
使用方式:如工作位于已注册的 store 中,先运行 openspec store list --json 获取 id,并在读写 spec 与变更的命令上追加 --store <id>,该选择在流程内保持。归档前可选择性运行 openspec instructions archive --change "<name>" --json 获取上下文;若需同步,先运行一次 openspec instructions specs --change "<name>" --json 并要求成功返回,再执行同步工作流,完成后重新比较。归档时创建 archive 目录,按 YYYY-MM-DD-<change-name> 生成目标名(已有日期前缀则不重复添加),用 mv 移动 changeRoot,最后输出归档摘要。
适用场景:变更已实现、需要把完成的变更从活动目录转入归档,并在归档前确认主规格与 delta spec 一致。
限制:产物或任务未完成会提示确认,但不阻止归档;同步失败或校验不通过时必须停止归档;带有自定义 --store 的命令集合之外不追加该参数;除资料所述命令与流程外,其他平台、收费或效果信息暂未提供。