SuperAPI AI 工具集

openspec-sync

通用与其它

查看项目

更新于 10-16 03:15

技能介绍

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

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

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

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

前提与限制:需要一个活跃变更,且其 specs/ 目录中存在 delta 规格。若提示“No delta specs”,说明该变更没有 specs/ 目录,需先用 openspec-continue 或 openspec-ff 创建规格。同步不会归档变更;完成后可继续处理该变更,或使用 openspec-archive 归档。

参考:OpenSpec 命令 /opsx:sync;OpenSpec 概念 Delta Specs。