SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 11-16 16:10

技能介绍

用途

openspec-apply-change 用于按照 OpenSpec 变更中定义的任务列表逐项实施开发工作。它面向“对一个变更执行操作”的工作流模型,可以在所有产出物完成前、部分实现之后,或与其他操作交替调用,不强制绑定固定阶段。

主要能力

  • 确定目标变更:支持直接传入变更名称;未提供时从对话上下文推断,或在只有一个活跃变更时自动选择;若存在歧义,则通过 openspec list --json 获取可用变更并让用户选择。
  • 读取状态与指令:调用 openspec status --change "<name>" --json 获取 schemaName(如 spec-driven)以及包含任务的任务工件;调用 openspec instructions apply --change "<name>" --json 获取上下文文件路径、进度(总数、已完成、剩余)、含状态的任务列表和基于当前状态的动态指令。
  • 状态处理:若状态为 blocked(缺少工件),提示并使用 openspec-continue-change;若为 all_done,则祝贺并建议归档;否则进入实现。
  • 读取上下文文件:读取 apply 指令输出中 contextFiles 列出的文件,文件内容随 schema 而定(如 spec-driven 为 proposal、specs、design、tasks)。
  • 展示进度:显示所用 schema、进度“N/M tasks complete”、剩余任务概览和 CLI 动态指令。
  • 逐项实现:对每个待办任务,说明正在处理的任务,进行所需代码修改,保持改动最小且聚焦,完成后在任务文件中将 - [ ] 改为 - [x],再继续下一项。
  • 暂停条件:任务不明确时请求澄清;实现暴露设计问题时建议更新工件;遇到错误或阻塞时报告并等待指示;用户中断时暂停。
  • 完成或暂停时输出状态:列出本次会话完成的任务、整体进度;全部完成时建议归档;暂停时说明原因并等待指示。

使用方式

通过技能调用触发,可选传入变更名称。典型流程为:选择变更 → openspec status --change "<name>" --json 了解 schema → openspec instructions apply --change "<name>" --json 获取指令 → 读取上下文文件 → 展示进度 → 循环实现任务直至完成或阻塞。

适用场景

  • 用户希望开始实现某个 OpenSpec 变更。
  • 用户希望继续此前未完成的实现工作。
  • 用户希望逐项推进变更中的任务清单。

限制与约束

  • 开始前必须读取 apply 指令输出中的上下文文件,不假设具体文件名。
  • 任务含糊时先暂停询问,不猜测。
  • 代码改动保持最小并限定在单个任务范围内。
  • 每完成一个任务立即更新任务复选框。
  • 遇到错误、阻塞或需求不清时暂停,不擅自继续。
  • 若实现中发现设计问题,建议更新工件而非绕开。

暂未提供

资料未说明该技能的收费方式、支持的平台、安装命令、具体效果或性能指标。