用途:用于在实现完成并验证后,正式结束一个 OpenSpec 变更,把变更产生的规格差异合并进主规格,并将变更归档留痕。
主要能力:将 delta 规格合并到 openspec/specs/ 主目录,规则为 ADDED Requirements 追加、MODIFIED Requirements 替换、REMOVED Requirements 删除;把变更文件夹移动到 openspec/changes/archive/YYYY-MM-DD-<name>/;完整保留 proposal、design、tasks、specs 等全部工件作为审计记录。
使用方式:执行 /opsx:archive 归档当前或推断出的变更;执行 /opsx:archive <change-name> 归档指定变更。命令会检查工件与任务完成状态,未完成时给出警告但不阻断;若 delta 规格尚未同步,会提示同步(也可事先运行 openspec-sync)。若需归档多个变更,使用 openspec-bulk-archive。
适用场景:实现已完成并验证;用户提到 archive、finish、done with this change、wrap up;通常在运行 openspec-verify 之后(可选但推荐)。
限制与注意:需要已存在包含工件、最好已完成任务的变更;未完成任务只警告不阻止,需自行决定先完成还是照常归档;归档后主规格即反映最新变化,后续变更以此为新的真实来源,新变更用 openspec-new 开始。