SuperAPI AI 工具集

openspec-sync-specs

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:将某个变更的 delta 规格同步到主规格,且不归档该变更。这是智能体驱动的操作,由智能体读取 delta 规格并直接编辑主规格,从而支持智能合并(例如只新增一个场景,而不复制整个需求)。

主要能力:处理 ADDED、MODIFIED、REMOVED、RENAMED 四类需求变更;可创建尚不存在的主规格文件;保留 delta 中未提及的既有内容;操作具备幂等性,重复运行结果一致。

使用方式:可选指定变更名称,若省略则尝试从对话上下文推断,模糊时必须提示选择。先运行 openspec list --json 获取可用变更,并让用户选择(不得猜测或自动选择)。再运行 openspec status --change "<name>" --json 解析上下文;若 actionContext.mode 为 workspace-planning,则说明该切片不支持工作区规格同步并停止,不得回退到仓库本地路径或编辑关联仓库。使用状态 JSON 中的 artifactPaths.specs.existingOutputPaths 作为 delta 规格文件列表;若无 delta 规格则告知用户并停止。对每个仓库本地能力 delta 规格,读取 delta 与主规格 openspec/specs/<capability>/spec.md(可能尚不存在),按 ADDED/MODIFIED/REMOVED/RENAMED 规则智能应用;能力不存在时创建新主规格,加入 Purpose(可简略并标记 TBD)与 Requirements。最后汇总更新的能力及具体变更。

适用场景:需要把变更中的规格增量合并进主规格、但暂不归档变更时。

限制:不支持 workspace-planning 模式;不得自动选择变更;需先读取 delta 与主规格再修改;不明确时应请求澄清。