SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-16 00:22

技能介绍

用途:从某个 OpenSpec change 出发,实际实现其中的任务,适合开始实现、继续实现或推进待办任务的场景。

主要能力:选择变更(可用名称,或从对话上下文推断;只有一个活跃变更时自动选择;含糊时执行 openspec list --json 获取可用变更并让用户选择),并提示“Using change: ”及覆盖方式如 /opsx:apply <other>。通过 openspec status --change "<name>" --json 了解 schemaName(如 spec-driven)以及承载任务的 artifact;通过 openspec instructions apply --change "<name>" --json 获取 contextFiles(artifact ID 到具体文件路径的映射,随 schema 不同)、进度(total、complete、remaining)、任务状态列表和动态指令。随后读取 contextFiles 中列出的每个文件;spec-driven 通常为 proposal、specs、design、tasks,其他 schema 以 CLI 输出为准。展示所用 schema、进度 N/M 和剩余任务后,逐项实现:改动保持最小并聚焦,完成后立即在 tasks 文件把 - [ ] 改为 - [x]。

状态处理:state 为 blocked(缺少 artifact)时提示改用 openspec-continue-change;state 为 all_done 时祝贺并建议归档;否则进入实现。

限制与护栏:开始前必须读 contextFiles,不假设具体文件名。任务含糊、实现暴露设计问题、出现错误或阻塞时暂停并询问,不猜测;用户中断时暂停。结束时展示本次完成的任务与整体进度,暂停时说明原因。

本技能支持“对变更执行动作”的流动模型,可在所有 artifact 未完成时(若已有任务)、部分实现后或与其他动作交错时调用;若实现发现设计问题,建议更新 artifact,而非锁定阶段。

暂未提供:具体安装方式、收费信息、依赖版本要求及平台限制。