SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:从 OpenSpec 变更中实现任务,适合用户想开始实现、继续实现或逐项推进任务时使用。

主要能力:选择变更(可用名称,或从对话上下文推断;仅一个活跃变更时自动选择;含糊时运行 openspec list --json 并用 AskUserQuestion 让用户选择,并提示可用 /opsx:apply <other> 覆盖);用 openspec status --change "<name>" --json 查看 schemaName 及承载任务的产物;用 openspec instructions apply --change "<name>" --json 获取上下文文件路径、进度(总数、完成、剩余)、任务列表与状态及动态指令。

使用方式:读取 apply 指令给出的 contextFiles(spec-driven 为 proposal、specs、design、tasks;tdd 为 spec、tests、implementation、docs;其他 schema 以 CLI 输出为准),展示所用 schema、进度与剩余任务,然后循环实现:显示当前任务、做最小且聚焦的代码改动、在任务文件中把 - [ ] 改为 - [x],继续下一项。状态为 blocked 时提示使用 openspec-continue-change;all_done 时建议归档。

限制与护栏:开始前必须读上下文文件;任务含糊、发现设计问题、遇到错误或阻塞、用户中断时暂停并等待指示,不猜测;改动保持最小并限定在单个任务内;完成后立即更新复选框;使用 CLI 输出的 contextFiles,不假设文件名。该技能支持“对变更执行动作”的流动模型,可在产物未全部完成、部分实现后或与其他动作交错时调用,并允许建议更新产物。