用途:将 OpenSpec 变更中的 delta 规格同步到主规格,使主规格反映变更内容,同时保持该变更处于活动状态(不归档)。
主要能力:智能合并而非覆盖。支持 ADDED(新增需求,若已存在则视为隐式 MODIFIED)、MODIFIED(修改需求,可新增或修改场景,保留 delta 未提及的内容)、REMOVED(删除整条需求块)、RENAMED(按 FROM/TO 重命名)。新能力仅允许 ADDED,并会创建新的主规格文件。
使用方式:先确认项目已使用 OpenSpec,可运行 openspec list --json 查看 root;若指定 store,先运行 openspec store list --json 获取 id,并在读取或写入规格的命令上追加 --store <id>。用 openspec status --change "<name>" --json 解析上下文,delta 路径只取 artifactPaths.specs.existingOutputPaths。写入前获取一次规格规则快照:openspec instructions specs --change "<name>" --json。主规格位于 <planningHome.root>/openspec/specs/<capability-path>/spec.md。完成后运行 openspec validate --specs 校验,并输出变更摘要。
适用场景:需要把变更中的规格改动提前反映到主规格,而不立即归档变更时。
限制:不存在的 delta 规格不得推断;调用方指定的路径子集不得扩大;规格指令返回非零或无效 JSON 时必须停止写入;不得把 delta 文件原样复制为主规格,主规格不得保留 ADDED/MODIFIED/REMOVED/RENAMED 等 delta 操作标题;不得写入空的 Requirements 段;能力退役需满足多项条件(含 retire_capabilities: true)。操作应幂等。资料未提供具体收费、平台与效果信息。