openspec-apply

OpenSpec 应用技能

使用 /opsx:apply 实现变更中的任务。Agent 会读取 tasks.md，逐项处理任务、编写代码、创建文件、按需运行测试，并使用 [x] 标记已完成的项目。

使用时机

• 所有规划文档均已完成，用户希望开始实现。
• 用户说“实现”“应用”“开始编码”或“执行任务”。
• 中断后恢复实现。

前提条件

• 规划文档已完成——至少存在 tasks.md（通过 openspec-ff 或 openspec-continue 创建）。

工作流

1. 开始实现

   • /opsx:apply — 应用当前或推断出的变更。
   • /opsx:apply <change-name> — 应用指定变更。

2. 读取任务

   • Agent 读取 tasks.md，找出未完成的任务（未勾选的 [ ] 项）。

3. 逐项处理任务

   • 对每项任务：阅读相关规范、设计和现有代码；编写代码；创建或修改文件；运行测试。
   • 在 tasks.md 中用 [x] 标记每项已完成的任务。

4. 处理问题

   • 如果某项任务表明设计有误，请编辑文档（例如 design.md）并继续。
   • OpenSpec 具有灵活性——实现过程中更新文档是预期且值得鼓励的。

5. 中断后恢复

   • 再次运行 /opsx:apply；它会根据复选框状态从上次中断处继续。

输出

• 实现任务的代码变更（新文件、修改的文件）。
• 更新后的 tasks.md，其中已完成的任务标记为 [x]。

后续步骤

• 使用 openspec-verify 验证实现是否符合文档。
• 使用 openspec-archive 归档已完成的变更。

故障排除

• “找不到变更”：指定变更名称：/opsx:apply add-dark-mode。
• 任务似乎有误：应用前编辑 tasks.md（或使用 /opsx:continue 重新生成）。
• 实现偏离设计：按需编辑 design.md 或 specs/；OpenSpec 是迭代式的。

参考资料

• OpenSpec 命令：/opsx:apply
• OpenSpec 概念：文档