用途:把某个变更下的 delta 规格同步到主规格(main specs),在用户不想归档变更时更新主规格。该操作为智能体驱动,由智能体读取 delta 规格并直接编辑主规格,从而实现智能合并,例如只添加一个场景而无需复制整个需求。
主要能力:支持 ADDED(新增)、MODIFIED(修改)、REMOVED(移除)、RENAMED(重命名)四类需求变更;可对部分内容做局部更新,delta 表示意图而非整体替换;若能力尚无主规格,则新建主规格文件并写入 Purpose 与 Requirements。
使用方式:变更名可选,若省略则从对话上下文推断,模糊或有歧义时必须提示选择。未提供变更名时运行 openspec list --json 获取可用变更,并用 AskUserQuestion 工具让用户选择;仅展示 specs/ 目录下含 delta 规格的变更,不得猜测或自动选择。随后查找 openspec/changes/<name>/specs/*/spec.md 中的 delta 规格,若未找到则告知用户并停止。对每个 delta 规格,读取 openspec/changes/<name>/specs/<capability>/spec.md 与主规格 openspec/specs/<capability>/spec.md(可能尚不存在),按意图应用变更;必要时创建 openspec/specs/<capability>/spec.md。完成后汇总更新了哪些能力、做了哪些增改删改名。
适用场景:需要把变更中的规格增量合并进主规格,同时保留变更仍处于活动状态。
限制与护栏:修改前须同时读取 delta 与主规格;保留 delta 未提及的既有内容;不清楚时请用户澄清;展示正在进行的变更;操作应幂等,运行两次结果相同。当前资料未提供收费、价格、平台或效果信息。