SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-22 09:57

技能介绍

用途:该技能用于实现 OpenSpec 变更中的任务。当用户希望开始实现、继续实现或逐项完成某个变更的任务时使用。

主要能力:

  1. 选择变更:可指定变更名称;若未提供,则从对话上下文推断;若只有一个活跃变更则自动选择;若含糊不清,则通过 openspec list --json 获取可用变更并让用户选择。选定后播报“Using change: <名称>”及覆盖方式(如 /opsx-apply <other>)。
  2. 检查状态:运行 openspec status --change "<name>" --json,解析 schemaName(如 spec-driven)及包含任务的工件。
  3. 获取执行指令:运行 openspec instructions apply --change "<name>" --json,返回上下文文件路径、进度(总数/完成/剩余)、带状态的任务列表及基于当前状态的动态指令。
  4. 状态处理:若为 blocked(缺少工件),提示使用 openspec-continue-change;若为 all_done,恭喜并建议归档;否则进入实现。
  5. 阅读上下文文件:按 CLI 输出中的 contextFiles 读取(spec-driven 下为 proposal、specs、design、tasks;其他 schema 以 CLI 输出为准)。
  6. 展示进度:显示所用 schema、进度“N/M tasks complete”、剩余任务概览及 CLI 动态指令。
  7. 循环实现任务:逐项展示正在处理的任务,做所需代码修改,保持改动最小且聚焦,并在任务文件中将 - [ ] 改为 - [x],然后继续下一项。

暂停条件:任务不明确时请求澄清;实现中发现设计问题建议更新工件;遇到错误或阻塞时报告并等待指示;用户中断。

完成或暂停时输出状态:列出本次会话完成的任务、整体进度;全部完成则建议归档;暂停则说明原因并等待指示。输出格式包括实现中、完成、暂停三种模板(实现中显示“Implementing: <change-name> (schema: <schema-name>)”与任务序号;完成显示进度与已完成任务清单;暂停显示问题与选项)。

约束:持续处理任务直到完成或被阻塞;开始前必须阅读上下文文件;任务含糊须先暂停询问;实现暴露问题须暂停并建议更新工件;代码改动最小且限定于每个任务;每完成一项立即更新复选框;遇错误、阻塞或需求不清须暂停而非猜测;使用 CLI 输出的 contextFiles,不假设具体文件名。

工作流特性:支持“对变更执行操作”模型,可在任意时间调用(工件未全部完成但已有任务时、部分实现后、与其他操作交错);允许工件更新,实现中发现设计问题建议更新工件,不锁定阶段、灵活进行。