用途 该技能用于将某个变更中的增量规格(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 段。
使用方式
- 若未提供变更名,先运行 openspec list --json 获取可用变更,用 AskUserQuestion 让用户选择,仅展示 specs/ 目录下带增量规格的变更;不得猜测或自动选择。
- 在 openspec/changes/<name>/specs/*/spec.md 查找增量规格;未找到则告知用户并停止。
- 逐个能力项读取增量规格与主规格,按上述规则智能合并。
- 完成后汇总被更新的能力项及新增、修改、删除、重命名的需求。
适用场景 需要在实现完成前把变更意图同步进主规格、并保持变更仍处于活动状态时使用。
限制与原则
- 该操作由智能体驱动,依赖判断进行智能合并;增量表达的是意图而非整体替换。
- 修改前须同时阅读增量与主规格,保留增量未提及的既有内容。
- 遇到不清晰处应请求澄清。
- 操作应保持幂等,运行两次结果一致。
- 成功后提示主规格已更新、变更仍处于活动状态,实现完成后可归档。
输出示例格式:Specs Synced: <change-name>,随后按能力项列出新增、修改(如新增 1 个场景)、删除、重命名及新建规格文件等。