用途
openspec-apply-change 是一个用于“实施 OpenSpec 变更任务”的技能。当用户希望开始实施、继续实施或逐项完成某个 OpenSpec 变更中的任务时,可调用该技能。它围绕 OpenSpec 的工作流,读取变更状态、获取实施指令、逐一完成任务并更新任务清单。
主要能力
- 选择变更:支持用户直接指定变更名称;若未指定,可从对话上下文推断,或在仅有一个活跃变更时自动选择;若存在歧义,则列出可用变更并请用户选择。
- 存储选择:当用户指定某个 store(在本机注册的独立 OpenSpec 仓库)或工作位于其中时,可通过
openspec store list --json发现已注册的 store id,并在读取或写入 specs/changes 的命令上追加--store <id>;选定后该标志在整个工作流中保持粘性。未指定 store 时,命令作用于最近的本地openspec/根目录。 - 状态检查:运行
openspec status --change "<name>" --json获取 schema、规划范围、编辑约束以及包含任务清单的产物信息。 - 获取实施指令:运行
openspec instructions apply --change "<name>" --json,获得上下文文件路径、进度(总数、已完成、剩余)、任务列表及状态、动态指令,以及可选的项目指令输入和操作指导。 - 状态处理:若状态为 blocked(缺少产物),提示使用 continue-change 技能或相关命令创建缺失产物;若状态为 all_done,则祝贺并建议归档;否则进入实施。
- 上下文与指导处理:将 context 视为必需的项目级输入,应用相关项目事实、约定与约束;将 operationGuidance 视为可选附加建议,逐条考虑并遵循适用且兼容的条目;两者与 CLI 返回状态分离,不作为任务完成的证据,不允许绕过 blocked 状态。
- 读取上下文文件:读取 apply 指令输出中 contextFiles 列出的每个文件路径(如 spec-driven schema 下的 proposal、specs、design、tasks)。
- 展示进度:显示所用 schema、进度“N/M tasks complete”、剩余任务概览及 CLI 动态指令。
- 循环实施任务:逐个处理待办任务,展示当前任务,进行必要且最小化的代码修改,在任务文件中将
- [ ]改为- [x],然后继续下一任务。 - 暂停条件:任务不明确时询问澄清;实施中发现设计问题则建议更新产物;遇到错误或阻塞则报告并等待指导;用户中断时暂停。
- 完成或暂停时输出状态:展示本次会话完成的任务、整体进度;全部完成时建议归档;暂停时说明原因并等待指导。
使用方式
可选择性传入变更名称,例如 $openspec-apply-change (Codex) 或 /openspec-apply-change (other agents) add-auth。若省略,则尝试从对话上下文推断;若模糊不清,则提示用户从可用变更中选择。技能会依次执行状态检查、获取实施指令、读取上下文文件、展示进度、循环实施任务,并在完成或暂停时给出相应输出。
适用场景
适用于已有 OpenSpec 变更且需要按任务清单推进实施的开发场景,包括:开始实施新变更、继续之前未完成的实施、在多个产物阶段之间穿插实施,以及在实施过程中发现设计问题需要回头更新产物。
限制与约束
- 必须从 apply 指令输出的 contextFiles 读取文件,不假设特定文件名。
- 代码修改应保持最小化并聚焦于当前任务。
- 任务不明确、发现设计问题、遇到错误或阻塞时应暂停,不得猜测。
- 不得将上下文或操作指导作为任务完成的证据。
- 不得将运行时上下文或操作指导逐字复制到实施文件或规划产物中,除非用户另行要求。
- 必须保留 CLI 控制的 blocked/ready/all-done 行为与完成标准。
- 若上下文与内置指令、用户明确选择或 CLI 控制值冲突,应报告冲突并保留控制值;若指导不适用或冲突,不遵循并解释原因。
- 该技能支持“对变更执行操作”的流动模型,可在任意时间调用,不锁定阶段。
暂未提供
该技能的安装方式、收费模式、支持平台与具体运行环境要求,资料中暂未提供。