SuperAPI AI 工具集

openspec-sync-specs

通用与其它

查看项目

更新于 10-15 21:47

技能介绍

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

主要能力:处理 delta 规格中的 ADDED、MODIFIED、REMOVED、RENAMED 需求;保留 delta 未提及的既有内容;新建尚不存在的主规格文件;同步后运行 openspec validate --specs 校验;输出更新摘要。

使用方式:可选指定变更名,否则从上下文推断或让用户选择。先运行 openspec status --change "<name>" --json,用返回的 planningHome.root 定位主规格目录,用 artifactPaths.specs.existingOutputPaths 作为 delta 规格路径的唯一来源。若指定了 store,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>。首次写入主规格前,运行 openspec instructions specs --change "<name>" --json 获取一次规格规则快照(若由 archive 内联调用并已提供有效快照则复用)。随后逐个 delta 规格读取并合并到 <planningHome.root>/openspec/specs/<capability-path>/spec.md。

限制:主规格不得包含 delta 操作标题,所有需求须归入单一 ## Requirements 节。删除整个 spec.md 需同时满足多项条件(无剩余需求块、格式完整、变更的 .openspec.yaml 声明 retire_capabilities: true、路径位于真实 specs 根内等)。若 specs 条目缺失或 existingOutputPaths 为空,应报告无可同步内容并停止。校验失败时不得声称同步成功。操作应保持幂等。资料未提供具体收费、价格或平台信息。