用途:该技能把某个变更(change)中的增量规格同步到项目主规格,用于在实现过程中提前更新主规格,而不归档该变更。
主要能力:支持增量规格中的四类操作——ADDED(新增需求)、MODIFIED(修改需求,可只添加新场景而不复制既有场景)、REMOVED(删除需求)、RENAMED(重命名需求,使用 FROM/TO 格式)。合并由智能体判断执行,属于智能合并而非整体替换,增量表达的是意图,未提及的内容会被保留;若主规格中尚无对应能力,会新建 specs/<capability>/spec.md,包含 Purpose(可标为 TBD)和 Requirements 部分。
使用方式:可选指定变更名称;若省略,则尝试从对话上下文推断,若模糊或歧义则必须提示用户从可用变更中选择,不得猜测或自动选择。通过 openspec list --json 获取带增量规格(specs/ 目录下)的变更,通过 openspec status --change "<name>" --json 解析变更上下文,若 actionContext.mode 为 workspace-planning,则说明该切片不支持工作区规格同步并停止,不回退到仓库本地路径,也不编辑关联仓库。增量规格文件路径取自状态 JSON 的 artifactPaths.specs.existingOutputPaths;若无增量规格则告知用户并停止。随后逐个读取增量规格与对应主规格 openspec/specs/<capability>/spec.md(可能尚不存在),应用变更,最后汇总更新的能力及新增、修改、删除、重命名的需求。
适用场景:需要在变更归档前把规格改动同步到主规格;需要局部更新(例如仅新增一个场景)而非整体覆盖;需要为尚不存在的能力创建主规格文件。
限制与约束:必须先读取增量规格与主规格再修改;保留增量未提及的既有内容;不清楚时询问澄清;操作应幂等,运行两次结果一致;不支持工作区规格同步模式。安装命令与具体调用入口暂未提供。