SuperAPI AI 工具集

openspec-sync-specs

通用与其它

查看项目

更新于 10-16 07:27

技能介绍

用途:把某个变更的 delta 规格同步进 openspec/specs/ 下的长期主规格,且不归档该变更。

主要能力:读取 delta 规格并直接编辑主规格以应用其意图,支持部分更新,例如只新增一个场景而不复制整个需求。

使用方式:先选择变更;若未指定,运行 openspec list --json,展示 specs/ 下带 delta 规格的变更,让用户选择,不要猜测。delta 规格位于 openspec/changes/<name>/specs/*/spec.md,可能包含 ## ADDED Requirements、## MODIFIED Requirements、## REMOVED Requirements、## RENAMED Requirements(FROM:/TO: 格式);若未找到则告知用户并停止。对每个带 delta 规格的能力,读取 delta 与主规格 openspec/specs/<capability>/spec.md(可能尚不存在),然后智能应用:ADDED 若为新则添加,若已存在则更新为一致(视为隐式 MODIFIED);MODIFIED 找到需求并应用变更,可新增场景、修改已有场景或改描述,保留 delta 未提及的内容;REMOVED 删除整个需求块;RENAMED 找到 FROM 需求并重命名为 TO。若该能力尚无主规格,则创建 openspec/specs/<capability>/spec.md,包含 Purpose 段(简短,可为 TBD)与 ADDED 需求。最后展示摘要:更新了哪些能力及具体变化。

关键原则:智能合并。delta 代表意图而非整体替换;要新增场景,只需在 MODIFIED 下包含该场景,不要复制已有场景。操作应保持幂等,运行两次结果相同。

限制与护栏:修改前先读 delta 与主规格;保留 delta 未提及的现有内容;意图不清时请求澄清而非猜测;过程中展示正在变更的内容。完成条件:第 2 步找到的每个 delta 规格都已应用到主规格(或已创建新主规格),摘要列出所有涉及的能力,且对相同输入再次运行同步不会产生进一步变更。