用途
该技能用于从 OpenSpec 变更中实施任务。它把一份变更所描述的计划转化为实际代码改动,并按任务清单逐步推进。适用时机为用户希望开始实施、继续实施或逐项完成 OpenSpec 变更中的任务。
主要能力
- 变更选择:支持显式指定变更名称;未指定时从对话上下文推断;只有一个活跃变更时自动选择;出现歧义或模糊时通过
openspec list --json获取可用变更,并借助 AskUserQuestion 工具让用户选择。选定后会播报“Using change: <名称>”,并说明覆盖方式(例如 /opsx:apply <other>)。 - 状态与结构检查:通过
openspec status --change "<name>" --json读取 schemaName(例如 “spec-driven”)以及承载任务的产物(spec-driven 下通常是 tasks,其他 schema 需查阅状态)。 - 获取实施指引:通过
openspec instructions apply --change "<name>" --json获取 contextFiles(产物 ID 到具体文件路径数组的映射,随 schema 不同可能是 proposal/specs/design/tasks,或 spec/tests/implementation/docs)、进度(总数、已完成、剩余)、带状态的任务列表,以及基于当前状态的动态指令。 - 状态处理:状态为 blocked(缺少产物)时,提示并建议使用 openspec-continue-change;状态为 all_done 时,表示祝贺并建议归档;其余情况进入实施流程。
- 实施循环:在开始前读取 apply 指令输出中 contextFiles 列出的每个文件路径;展示所用 schema、进度 “N/M tasks complete” 与剩余任务概览;随后逐项处理待办任务,展示当前任务、进行必要代码改动、保持改动最小且聚焦、完成后在任务文件中把
- [ ]标记为- [x],再进入下一项。 - 暂停条件:任务含义不清时请求澄清;实施中发现设计问题、遇到错误或阻塞、用户打断时暂停并等待指引。
- 汇总输出:完成或暂停时展示本次会话完成的任务、整体进度 “N/M tasks complete”;全部完成则建议归档,暂停则说明原因并等待指引。
使用方式
按技能描述中的流程执行:先选择并播报变更,再查询状态与实施指引,读取上下文文件,展示进度,然后循环实施任务并即时勾选,最后输出完成或暂停总结。相关命令保持原样,包括 openspec list --json、openspec status --change "<name>" --json、openspec instructions apply --change "<name>" --json。
实施过程输出示例
## 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
完成时输出结构
包含变更名、schema、进度(如 7/7 tasks complete ✓)、本次会话已完成的任务列表,并提示所有任务已完成、可以归档该变更。
暂停时输出结构
包含变更名、schema、进度(如 4/7 tasks complete)、遇到的问题描述、可选项列表(含“其他方式”),并询问用户希望如何处理。
适用场景
适用于 OpenSpec 变更驱动的开发流程,尤其是采用 spec-driven 等 schema、任务记录在 tasks 产物中的变更。该技能支持“对变更执行动作”的模型:可在所有产物完成前(若任务已存在)、部分实施后,或与其他动作交替调用;允许在实施中发现设计问题时建议更新产物,不锁定阶段,工作方式较为灵活。
约束与限制
- 实施前必须读取 apply 指令输出中的上下文文件。
- 任务含义不清时先暂停询问,不猜测实现。
- 实施暴露问题时暂停并建议更新产物。
- 代码改动保持最小且限定在单个任务范围内。
- 每完成一项任务立即更新任务复选框。
- 遇到错误、阻塞或需求不清时暂停,不擅自臆断。
- 使用 CLI 输出中的 contextFiles,不假定具体文件名。
- 其他细节(如具体支持哪些 schema、除上述命令外的扩展能力)暂未提供。