用途:通过 /opsx:sync 将某个变更(change)中的 delta 规格合并到主规格目录 openspec/specs/,合并后该变更仍保持活动状态,不会被归档。该步骤是可选的,因为 openspec-archive 在归档时会自动完成同步。
适用场景:长期运行的变更希望在归档前先把规格写入主目录;多个并行变更需要更新基础规格;用户希望在归档前单独审查或预览合并结果。
前置条件:存在一个活动变更,且其 specs/ 目录中包含 delta 规格。
使用方式:运行 /opsx:sync 同步当前或推断出的变更;运行 /opsx:sync add-dark-mode 按名称同步指定变更。
执行过程:读取变更文件夹中的 delta 规格,解析 ADDED / MODIFIED / REMOVED 段落,将改动合并进 openspec/specs/,保留 delta 中未提及的既有内容,变更保持活动状态(不归档)。
输出与验证:openspec/specs/ 被更新并合并 delta 改动;变更仍保留在 openspec/changes/<name>/ 中。可在 openspec/specs/ 中检查更新后的规格。
后续步骤:继续处理该变更,完成后使用 openspec-archive。
限制与排错:若提示“No delta specs”,说明该变更没有 specs/ 目录,需先通过 openspec-continue 或 openspec-ff 创建规格;若与其他变更冲突,同步在需求级别进行合并,两个变更修改同一需求时以最近一次同步为准。