SuperAPI AI 工具集

openspec-sync-specs

通用与其它

查看项目

更新于 10-16 03:17

技能介绍

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

主要能力:处理 ADDED、MODIFIED、REMOVED、RENAMED 四类需求变更;对已存在的 ADDED 需求按隐式 MODIFIED 处理;MODIFIED 可只添加或修改场景、修改需求描述,并保留 delta 未提及的内容;REMOVED 删除整个需求块;RENAMED 按 FROM/TO 重命名;若能力尚不存在则新建主规格文件,包含 Purpose(可标 TBD)与 Requirements 段。

使用方式:可选指定变更名;若省略则尝试从对话上下文推断,模糊时必须提示选择。未提供变更名时运行 openspec list --json 获取可用变更,并用 AskUserQuestion 工具让用户选择,只展示 specs/ 目录下含 delta 规格的变更,禁止猜测或自动选择。delta 规格位于 openspec/changes/<name>/specs/*/spec.md,主规格位于 openspec/specs/<capability>/spec.md。逐个能力应用变更后输出摘要,说明更新了哪些能力以及新增、修改、删除、重命名了哪些需求。

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

限制与护栏:修改前须同时阅读 delta 与主规格;保留 delta 未提及的既有内容;不清楚时询问澄清;操作应幂等,运行两次结果相同;未找到 delta 规格时告知用户并停止。官方文档未提供更多安装或配置信息。