SuperAPI AI 工具集

openspec-update-change

通用与其它

查看项目

更新于 10-15 21:47

技能介绍

用途:修订一个 OpenSpec 变更已有的规划产物(planning artifacts),并让它们彼此保持一致。该技能只处理规划文档,绝不编辑实现代码。

主要能力:读取变更当前状态,定位需要修改的产物,应用用户要求的修订,并检查其他已有产物是否因此产生矛盾、缺口或重复,必要时反向修订更早的产物。若变更本身已一致,则不做任何修改。

使用方式:可选指定变更名,未指定时从对话上下文推断;若含糊则运行 openspec list --json 列出最近修改的变更并让用户选择。用 openspec status --change "<name>" --json 获取产物状态与路径,编辑对象是 artifactPaths.<id>.existingOutputPaths 中已存在的具体文件。若涉及存储库,先运行 openspec store list --json 获取 id,并在读写规格与变更的命令上追加 --store <id>。需要大幅重写时先运行 openspec instructions "<artifact-id>" --change "<name>" --json 获取规则与模板。每次修改前需向用户展示并确认。

适用场景:用户明确要求修改某变更的设计或规划内容,或要求让变更的规划产物保持一致。

限制:只编辑已存在的文件,不创建新产物、不在 glob 产物下新建文件;不推进构建前沿;不编辑代码,若修订计划暗示代码改动,应指向 apply 流程。若请求改变的是变更意图而非细化,建议改用新建变更流程。产物 id 与路径以 openspec status 报告为准,不硬编码产物名。资料未提供具体收费、平台与效果信息。