SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 11-06 17:04

技能介绍

openspec-apply-change 是 OpenSpec 变更流程中的一个实现型技能,用途是从指定的 OpenSpec 变更中落实任务清单。资料给出的触发场景为:用户希望开始实现、继续实现或逐项处理任务。

一、用途 该技能面向“把变更任务转化为代码改动”的环节,按任务列表推进实现,并在每个任务完成后同步更新任务文件中的完成标记。

二、主要能力

  1. 选择变更:若用户提供名称则直接使用;否则尝试从对话上下文推断;若仅有一个活动变更则自动选择;若含糊或存在歧义,运行 openspec list --json 获取可用变更并通过 AskUserQuestion 工具让用户选择。选择后始终提示“Using change: ”以及覆盖方式(例如 /opsx:apply <other>)。
  2. 检查状态:运行 openspec status --change "<name>" --json,解析 JSON 获取 schemaName(如 spec-driven)以及包含任务的产物(spec-driven 通常为 tasks)。
  3. 获取执行说明:运行 openspec instructions apply --change "<name>" --json,返回 contextFiles(产物 ID 到具体文件路径的映射)、进度(总数、完成、剩余)、带状态的任务列表以及基于当前状态生成的动态说明。
  4. 处理状态:若 state 为 blocked(缺少产物),给出提示并建议使用 openspec-continue-change;若为 all_done,表示祝贺并建议归档;否则进入实现。
  5. 读取上下文文件:读取 apply 说明中 contextFiles 列出的每个文件路径。spec-driven 模式包括 proposal、specs、design、tasks;其他 schema 以 CLI 输出为准。
  6. 展示进度:显示所用 schema、进度“N/M tasks complete”、剩余任务概览以及 CLI 给出的动态说明。
  7. 实现任务:逐个处理待办任务,显示当前任务,进行所需代码修改,保持最小且聚焦,完成后将任务文件中的 - [ ] 改为 - [x],继续下一个任务。
  8. 暂停条件:任务不明确时请求澄清;实现中发现设计问题则建议更新产物;遇到错误或阻塞则报告并等待指引;用户中断时也暂停。
  9. 阶段输出:实现过程中输出当前变更名、schema 及正在处理的任务;全部完成时输出实现完成摘要、本次完成的任务及总进度,并建议归档;暂停时输出已完成进度、遇到的问题与可选方案,询问用户下一步。

三、使用方式 该技能通过调用触发,可按名称指定变更,也可依赖上下文推断。核心依赖 OpenSpec CLI 命令:openspec list --json、openspec status --change "<name>" --json、openspec instructions apply --change "<name>" --json。实现前必须读取 contextFiles 中的全部文件,不假设具体文件名。

四、适用场景 适用于需要按 OpenSpec 变更任务清单推进编码工作的场景,包括首次开始实现、中断后继续实现、在多个任务之间逐步推进,以及与其他“对变更执行动作”的操作交错进行。它也允许在产物尚未全部完成但已存在任务时调用,并在实现暴露出设计问题时建议更新产物,而非严格按阶段锁定。

五、限制与约束 任务不明确时应暂停询问而非猜测;实现应保持最小且聚焦于当前任务;每完成一个任务立即更新复选框;遇到错误、阻塞或需求不清时暂停;不得假定上下文文件名,应使用 CLI 输出的 contextFiles。该技能本身不定义具体代码内容、安装方式或价格信息,资料中暂未提供。