SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-16 10:53

技能介绍

用途

openspec-apply-change 用于实现 OpenSpec 变更(change)中的任务。当用户想要开始实现、继续实现或逐项完成某个 OpenSpec 变更的任务时,可使用该技能。

输入与变更选择

输入可以可选地指定变更名称。如果省略,技能会根据以下方式处理:

  • 从对话上下文中推断用户是否提及了某个变更
  • 如果只有一个活跃变更,则自动选择
  • 如果模糊或有歧义,则运行 openspec list --json 获取可用变更,并使用 AskUserQuestion 工具让用户选择

选定后需宣布:"Using change: " 以及如何覆盖(例如 /opsx:apply <other>)。

执行流程

  1. 检查状态以了解 schema:运行 openspec status --change "<name>" --json,解析 JSON 以了解 schemaName(使用的工作流,例如 "spec-driven"),以及哪个制品包含任务(spec-driven 通常为 "tasks",其他 schema 需检查状态)。

  2. 获取 apply 指令:运行 openspec instructions apply --change "<name>" --json。返回内容包括上下文文件路径(随 schema 而异,可能是 proposal/specs/design/tasks 或 spec/tests/implementation/docs)、进度(总数、已完成、剩余)、带状态的任务列表,以及基于当前状态的动态指令。

    处理状态:

    • 如果 state: "blocked"(缺少制品):显示消息,建议使用 openspec-continue-change
    • 如果 state: "all_done":祝贺,并建议归档
    • 其他情况:继续进入实现
  3. 读取上下文文件:读取 apply 指令输出中列出的 contextFiles。文件取决于所用 schema:spec-driven 为 proposal、specs、design、tasks;其他 schema 按 CLI 输出的 contextFiles 执行。

  4. 显示当前进度:展示所用 schema、"N/M tasks complete" 进度、剩余任务概览,以及来自 CLI 的动态指令。

  5. 实现任务(循环直到完成或被阻塞):对每个待处理任务,显示正在处理的任务、进行所需代码修改、保持修改最小且聚焦、在任务文件中将 - [ ] 标记为 - [x],然后继续下一个任务。

    遇到以下情况暂停:

    • 任务不清晰 → 请求澄清
    • 实现揭示设计问题 → 建议更新制品
    • 遇到错误或阻塞 → 报告并等待指引
    • 用户中断
  6. 完成或暂停时显示状态:展示本次会话完成的任务、整体进度 "N/M tasks complete"。如果全部完成,建议归档;如果暂停,解释原因并等待指引。

输出格式

实现过程中:

## Implementing: <change-name> (schema: <schema-name>)

Working on task 3/7: <task description>
[...implementation happening...]
✓ Task complete

完成时:

## Implementation Complete

**Change:** <change-name>
**Schema:** <schema-name>
**Progress:** 7/7 tasks complete ✓

### Completed This Session
- [x] Task 1
- [x] Task 2

暂停时:

## Implementation Paused

**Change:** <change-name>
**Schema:** <schema-name>
**Progress:** 4/7 tasks complete

### Issue Encountered
<description of the issue>

**Options:**
1. <option 1>
2. <option 2>
3. Other approach

约束与护栏

  • 持续推进任务直到完成或被阻塞
  • 开始前始终读取上下文文件(来自 apply 指令输出)
  • 如果任务含糊,先暂停询问再实现
  • 如果实现揭示问题,暂停并建议更新制品
  • 保持代码修改最小,并限定在每个任务范围内
  • 完成每个任务后立即更新任务复选框
  • 遇到错误、阻塞或需求不清时暂停,不要猜测
  • 使用 CLI 输出中的 contextFiles,不要假设具体文件名

流体工作流集成

该技能支持 "actions on a change" 模型:可在任意时间调用(所有制品完成前,若任务已存在)、部分实现之后,或与其他动作交错进行;允许更新制品——如果实现揭示设计问题,建议更新制品,不受阶段锁定,可流畅工作。