SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 11-02 01:06

技能介绍

用途:该技能用于“实现 OpenSpec 变更中的任务”,即当用户希望开始实施、继续实施或逐项推进任务时,按照 OpenSpec 变更中定义的任务清单执行开发工作。

主要能力:

  • 变更选择:可使用用户提供的变更名称;若未提供,则从对话上下文推断;若仅有一个活动变更则自动选择;若存在歧义,则列出可用变更并请用户选择。选定后会提示所用变更及如何切换。
  • 状态与指令读取:通过 openspec status 获取 schemaName、planningHome、changeRoot、actionContext 等规划范围与编辑约束信息,并确定承载任务的产物;通过 openspec instructions apply 获取上下文文件路径、进度(总数、完成数、剩余数)、带状态的任务列表、动态指令,以及可选的项目指令上下文和操作指导。
  • 状态处理:若状态为 blocked(缺少产物),会提示使用 continue-change 技能或给出查看下一产物与创建方式的命令;若状态为 all_done,则祝贺并建议归档;其余情况进入实施。
  • 实施流程:读取所有上下文文件,展示当前 schema、进度与剩余任务概览,然后逐项实施。每个任务保持改动最小且聚焦,完成后立即在任务文件中将 - [ ] 改为 - [x],再进入下一任务。
  • 暂停条件:任务不明确时请求澄清;实施中发现设计问题建议更新产物;遇到错误或阻塞时报告并等待指示;用户中断时暂停。
  • 输出格式:提供实施中、全部完成、暂停三类输出模板,分别展示当前任务、完成情况、整体进度、本次完成的任务以及问题与可选项。

使用方式:

  • 可选传入变更名称,例如 $openspec-apply-change (Codex) 或 /openspec-apply-change (other agents) add-auth;省略时依上下文推断或询问。
  • 若使用已注册的 store,先运行 openspec store list --json 获取 store id,并在读取或写入规格与变更的相关命令上追加 --store <id>,该标志在后续工作流中保持粘性;未指定 store 时命令作用于最近的本地 openspec/ 根目录。
  • 依次执行 openspec status --change "<name>" --json 与 openspec instructions apply --change "<name>" --json,读取 contextFiles 中列出的所有文件,然后逐项实施并勾选任务。

适用场景:已完成 OpenSpec 提案、规格、设计等规划后进入实施阶段;需要继续推进部分已完成的任务;在变更生命周期中与其他操作交错进行,属于“对变更执行操作”的流畅工作流模型,不受阶段锁定限制。

限制与约束:该技能依赖 OpenSpec CLI 及已注册的 store 或本地 openspec/ 根目录;上下文与操作指导属于提示层面的行为约束,不能作为任务完成的证据,也不能绕过 blocked 状态;上下文与内置指令、用户明确选择或 CLI 控制值冲突时,需报告冲突并保留控制值;不明确的指导不应遵循并需说明原因;不得将运行时上下文或操作指导原样复制到实施文件或规划产物中;遇到错误、阻塞或需求不清时应暂停而非猜测。