用途
openspec-apply-change 用于实现 OpenSpec 变更(change)中的任务。当用户想要开始实现、继续实现或逐项完成某个 OpenSpec 变更的任务时,可使用该技能。
输入与变更选择
输入可以可选地指定变更名称。如果省略,技能会根据以下方式处理:
- 从对话上下文中推断用户是否提及了某个变更
- 如果只有一个活跃变更,则自动选择
- 如果模糊或有歧义,则运行
openspec list --json获取可用变更,并使用 AskUserQuestion 工具让用户选择
选定后需宣布:"Using change: " 以及如何覆盖(例如 /opsx:apply <other>)。
执行流程
-
检查状态以了解 schema:运行
openspec status --change "<name>" --json,解析 JSON 以了解schemaName(使用的工作流,例如 "spec-driven"),以及哪个制品包含任务(spec-driven 通常为 "tasks",其他 schema 需检查状态)。 -
获取 apply 指令:运行
openspec instructions apply --change "<name>" --json。返回内容包括上下文文件路径(随 schema 而异,可能是 proposal/specs/design/tasks 或 spec/tests/implementation/docs)、进度(总数、已完成、剩余)、带状态的任务列表,以及基于当前状态的动态指令。处理状态:
- 如果
state: "blocked"(缺少制品):显示消息,建议使用 openspec-continue-change - 如果
state: "all_done":祝贺,并建议归档 - 其他情况:继续进入实现
- 如果
-
读取上下文文件:读取 apply 指令输出中列出的 contextFiles。文件取决于所用 schema:spec-driven 为 proposal、specs、design、tasks;其他 schema 按 CLI 输出的 contextFiles 执行。
-
显示当前进度:展示所用 schema、"N/M tasks complete" 进度、剩余任务概览,以及来自 CLI 的动态指令。
-
实现任务(循环直到完成或被阻塞):对每个待处理任务,显示正在处理的任务、进行所需代码修改、保持修改最小且聚焦、在任务文件中将
- [ ]标记为- [x],然后继续下一个任务。遇到以下情况暂停:
- 任务不清晰 → 请求澄清
- 实现揭示设计问题 → 建议更新制品
- 遇到错误或阻塞 → 报告并等待指引
- 用户中断
-
完成或暂停时显示状态:展示本次会话完成的任务、整体进度 "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" 模型:可在任意时间调用(所有制品完成前,若任务已存在)、部分实现之后,或与其他动作交错进行;允许更新制品——如果实现揭示设计问题,建议更新制品,不受阶段锁定,可流畅工作。