openspec-apply-change

用途

openspec-apply-change 用于实现 OpenSpec 变更（change）中的任务。当用户希望开始实现、继续实现，或逐项推进某个变更的任务时，可调用该技能。

主要能力

选择变更：可显式指定变更名称；若未指定，则尝试从对话上下文推断，或在仅有一个活跃变更时自动选择；若含糊不清，则运行 openspec list --json 获取可用变更并通过 AskUserQuestion 工具让用户选择。选定后会提示“Using change: ”以及如何覆盖（例如 /opsx:apply <other>）。
检查状态：运行 openspec status --change "<name>" --json，解析 JSON 以了解所用工作流（schemaName，例如 "spec-driven"）以及哪个产物包含任务（spec-driven 通常为 "tasks"）。
获取应用指令：运行 openspec instructions apply --change "<name>" --json，返回上下文文件路径、进度（总数、已完成、剩余）、带状态的任务列表，以及基于当前状态的动态指令。
处理状态：若 state 为 "blocked"（缺少产物），显示消息并建议使用 /opsx:propose <name> 补全缺失产物；若为 "all_done"，表示祝贺并建议归档；否则进入实现。
读取上下文文件：读取应用指令输出中 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

Working on task 4/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
...

All tasks complete! Ready to archive this change.

暂停（遇到问题）时的输出示例：

## 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

What would you like to do?

适用场景

开始实现某个 OpenSpec 变更中的任务。
继续之前未完成的实现。
逐项推进变更任务清单。

限制与护栏

持续处理任务直至完成或被阻塞。
开始前始终读取上下文文件（来自应用指令输出）。
若任务含糊，先暂停询问再实现。
若实现暴露问题，暂停并建议更新产物。
保持代码改动最小，并限定在每个任务范围内。
每完成一个任务后立即更新任务复选框。
遇到错误、阻塞或需求不清时暂停，不要猜测。
使用 CLI 输出中的 contextFiles，不要假设具体文件名。

技能介绍

用途

主要能力

使用方式

适用场景

限制与护栏