SuperAPI AI 工具集

openspec-sync

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:将某个变更(change)中的增量规格(delta specs)合并进主规格目录 openspec/specs/,同时保持该变更处于活动状态,不执行归档。该步骤是可选的,openspec-archive 在归档时会自动完成同步。

主要能力:读取变更文件夹中的增量规格,解析 ADDED / MODIFIED / REMOVED 三类段落,把改动合并到 openspec/specs/,并保留增量中未提及的既有内容。合并按需求(requirement)级别处理;若两个变更修改同一需求,以最近一次同步为准。

使用方式:运行 /opsx:sync 同步当前或推断出的变更;运行 /opsx:sync <change-name> 同步指定变更。完成后可在 openspec/specs/ 中检查更新结果,变更仍保留在 openspec/changes/<name>/ 下。

适用场景:长期运行的变更希望在归档前先更新主规格;多个并行变更需要更新基础规格;希望在归档前单独审查或预览合并结果。

前提与限制:需要一个处于活动状态、且 specs/ 中包含增量规格的变更。若提示“No delta specs”,说明该变更没有 specs/ 目录,需先通过 openspec-continue 或 openspec-ff 创建规格。同步不会归档变更,后续可继续修改,完成后可使用 openspec-archive。