SuperAPI AI 工具集

openspec-update-change

编程与开发

查看项目

更新于 10-15 23:32

技能介绍

用途:修订某个 OpenSpec 变更已有的规划产物(planning artifacts),使各产物之间保持一致。该技能只处理规划文档,绝不编辑实现代码。

主要能力:可选择 store(本机注册的独立 OpenSpec 仓库),用 openspec store list --json 发现 store id,并在读取或写入 specs/changes 的命令上附加 --store <id>;未指定 store 时作用于最近的本地 openspec/ 根目录。可列出变更、查看状态与产物路径、读取并核对产物、按用户确认逐项写入修订。

使用方式:未提供变更名时,先运行 openspec list --json 获取按最近修改排序的变更,再用 AskUserQuestion 让用户选择,不猜测、不自动选择。随后运行 openspec status --change "<name>" --json 获取 schemaName、artifacts 状态、isComplete 以及 planningHome、changeRoot、artifactPaths、actionContext 等路径信息。要编辑的文件是 artifactPaths.<id>.existingOutputPaths,不要写入 resolvedOutputPath(glob 产物仍是通配模式)。需要大幅重写时先运行 openspec instructions <artifact-id> --change "<name>" --json 获取该产物的规则与模板。

适用场景:用户要求修订某变更的规划产物,或要求让产物彼此一致(一致性审查)。

限制:只编辑已存在的文件,不创建尚不存在的产物,也不在 glob 产物下新建文件,缺失部分应提示用户使用 /opsx:continue。每次写入前必须经用户确认,被拒绝的修订不写入。若修订涉及代码变更,应停止并指向 /opsx:apply;若请求改变变更意图而非细化,建议用 /opsx:new 重新开始。产物 id 与路径以 openspec status 报告为准,不硬编码产物名。