SuperAPI AI 工具集

openspec-sync-specs

编程与开发

查看项目

更新于 10-22 09:57

技能介绍

用途 该技能用于将某个变更中的增量规格(delta specs)同步到主规格(main specs),而不归档该变更。它适合在实现过程中先更新主规格、稍后再归档变更的场景。

主要能力

  • 从 openspec/changes/<name>/specs/*/spec.md 读取增量规格,识别 ADDED Requirements、MODIFIED Requirements、REMOVED Requirements、RENAMED Requirements(FROM:/TO: 格式)四类章节。
  • 对每个能力项,读取对应的主规格 openspec/specs/<capability>/spec.md(可能尚不存在),并智能应用变更。
  • ADDED:主规格中不存在则新增;已存在则按修改处理。
  • MODIFIED:定位需求并应用改动,可新增场景、修改已有场景或调整需求描述,保留增量中未提及的场景与内容。
  • REMOVED:从主规格中删除整个需求块。
  • RENAMED:将 FROM 需求重命名为 TO。
  • 若能力项尚无主规格,则创建 openspec/specs/<capability>/spec.md,写入 Purpose 段(可简写并标记 TBD)与包含 ADDED 需求的 Requirements 段。

使用方式

  1. 若未提供变更名,先运行 openspec list --json 获取可用变更,用 AskUserQuestion 让用户选择,仅展示 specs/ 目录下带增量规格的变更;不得猜测或自动选择。
  2. 在 openspec/changes/<name>/specs/*/spec.md 查找增量规格;未找到则告知用户并停止。
  3. 逐个能力项读取增量规格与主规格,按上述规则智能合并。
  4. 完成后汇总被更新的能力项及新增、修改、删除、重命名的需求。

适用场景 需要在实现完成前把变更意图同步进主规格、并保持变更仍处于活动状态时使用。

限制与原则

  • 该操作由智能体驱动,依赖判断进行智能合并;增量表达的是意图而非整体替换。
  • 修改前须同时阅读增量与主规格,保留增量未提及的既有内容。
  • 遇到不清晰处应请求澄清。
  • 操作应保持幂等,运行两次结果一致。
  • 成功后提示主规格已更新、变更仍处于活动状态,实现完成后可归档。

输出示例格式:Specs Synced: <change-name>,随后按能力项列出新增、修改(如新增 1 个场景)、删除、重命名及新建规格文件等。