SuperAPI AI 工具集

openspec-apply

通用与其它

查看项目

更新于 10-16 03:15

技能介绍

OpenSpec Apply 是 OpenSpec 工作流中的实现阶段技能,通过 /opsx:apply 命令执行变更中的任务。

用途:在规划产物完成后,把 tasks.md 中的任务清单实际落地为代码;也用于中断后恢复实现。触发说法包括 implement、apply、start coding、execute tasks。

前提:规划产物已完成,至少存在 tasks.md(由 openspec-ff 或 openspec-continue 创建)。

主要能力与用法:/opsx:apply 应用当前或推断出的变更;/opsx:apply <change-name> 应用指定变更。执行时读取 tasks.md,找出未勾选的 [ ] 任务,逐项读取相关 specs、design 与现有代码,编写代码、创建或修改文件、按需运行测试,并在 tasks.md 中将完成项标记为 [x]。

若任务暴露设计错误,可直接编辑 design.md 等产物并继续;OpenSpec 支持在实现过程中迭代更新产物。若执行中断,再次运行 /opsx:apply,会根据复选框状态从上次位置继续。

输出:实现任务的代码改动(新增、修改文件),以及 tasks.md 中被勾选的完成项。

后续步骤:用 openspec-verify 校验实现与产物是否一致;用 openspec-archive 归档已完成的变更。

限制与故障处理:若提示"Change not found",需显式指定变更名,如 /opsx:apply add-dark-mode。若任务清单有误,可在应用前编辑 tasks.md,或用 /opsx:continue 重新生成。若实现偏离设计,按需编辑 design.md 或 specs/。官方文档参考 OpenSpec Commands(/opsx:apply)与 OpenSpec Concepts(Artifacts)。