用途:修订某个已有 OpenSpec 变更的规划产物(如规格、设计、任务等),使它们与用户的新要求保持内部一致。不创建尚不存在的产物,那是 /openspec-continue-change 的职责。
主要能力:选定要修改的变更;通过 openspec status --change "<name>" --json 读取当前产物状态与路径;读取受影响的产物及其他已有产物,草拟修改并检查各产物间的矛盾、缺失与重复(任何方向都可能需要联动修订);在用户逐项确认后写入文件。也支持 glob 产物(如 specs/**/*.md)中已部分填充时补建符合约束的新文件。
使用方式:可指定变更名,未指定则从上下文推断或自动选择唯一活跃变更;有歧义时用 openspec list --json 列出最近修改的几个变更供选择。若使用 store,先运行 openspec store list --json 获取 id,并在读取/写入规格与变更的命令上附加 --store <id>,且保持粘性。首次写入前用 openspec list --json 检查 root:为 null 表示项目未初始化,不得因副作用创建 openspec/ 目录。需要规则与模板时运行 openspec instructions "<artifact-id>" --change "<name>" --json。每次写入前均需用户确认。
适用场景:用户明确要求修订某变更的现有计划,或仅要求“让它一致”而需要做一致性审查。
限制:只改规划产物,绝不编辑实现代码;若修订后的计划意味着代码改动,应转向 /openspec-apply-change。使用 openspec status 报告的产物 id 与路径,不硬编码产物名。只写 existingOutputPaths 中的具体文件,不写 glob 的 resolvedOutputPath。不改 skipped 产物。若请求改变变更意图而非细化它,建议用 /openspec-new-change 重新开始。其他更细的收费、价格、平台等信息暂未提供。