用途:用于在变更实现完成并验证后,将变更正式归档。当用户说“archive”“finish”“done with this change”“wrap up”时使用,通常在运行 openspec-verify 之后(可选但推荐)。
主要能力:执行 /opsx:archive 归档当前或推断出的变更,也可用 /opsx:archive <change-name> 归档指定变更。归档时会检查产物完成状态与任务完成情况(未完成会警告但不阻止),提示是否同步 delta 规格,将 delta 规格合并进 openspec/specs/,并把变更文件夹移动到 openspec/changes/archive/YYYY-MM-DD-<name>/。完整变更上下文(proposal、design、tasks、specs)都会保留在归档中,便于审计。
合并规则:## ADDED Requirements 追加到主规格;## MODIFIED Requirements 替换主规格中的既有需求;## REMOVED Requirements 从主规格中删除。
前置条件:变更已存在且包含产物,任务最好已完成。
后续步骤:可用 openspec-new 开始新变更;主规格已反映本次变更,后续变更基于更新后的真实来源。
限制与排错:任务未完成时归档仅警告不阻止;delta 规格未同步时会提示同步,也可先运行 openspec-sync;如需归档多个变更,应使用 openspec-bulk-archive。