SuperAPI AI 工具集

openspec-sync-specs

通用与其它

查看项目

更新于 10-16 06:47

技能介绍

用途:将某个变更的 delta 规格同步到主规格,不归档该变更。由智能体驱动,读取 delta 规格并直接编辑主规格,实现智能合并,例如只添加一个场景而无需复制整条需求。

主要能力:处理 ADDED、MODIFIED、REMOVED、RENAMED 四类需求变更;对已存在的 ADDED 需求按隐式 MODIFIED 处理;MODIFIED 可只写新增或修改的场景,保留 delta 未提及的原有内容;REMOVED 删除整条需求块;RENAMED 按 FROM/TO 重命名;能力不存在时创建 openspec/specs/<capability>/spec.md,并加入 Purpose(可标 TBD)与 Requirements。

使用方式:可选指定变更名;未提供时先运行 npx openspec list --json 获取可用变更,用 AskUserQuestion 让用户选择,不得猜测或自动选择。delta 规格位于 openspec/changes/<name>/specs/*/spec.md,主规格位于 openspec/specs/<capability>/spec.md。逐个能力读取 delta 与主规格后应用变更,最后汇总更新的能力及新增/修改/删除/重命名的需求。

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

限制:操作应幂等,运行两次结果相同;修改前须同时阅读 delta 与主规格;保留 delta 未提及的现有内容;不明确时询问澄清;过程中展示正在做的更改;未找到 delta 规格则告知用户并停止。输出格式与 delta 规格格式参考见原始资料。