mcpField
O
openspec-apply

openspec-apply

github.com/partme-aiAgent 工作流39 次安装
代码仓库

关于 openspec-apply

openspec-apply 是供编码 Agent 实施 OpenSpec 变更的技能。它读取 tasks.md，依次完成未勾选任务并更新清单，也可在中断后继续执行。

主要功能

  1. 01读取 tasks.md 中未完成的任务
  2. 02逐项实施任务
  3. 03创建和修改代码文件
  4. 04按需运行测试
  5. 05勾选已完成任务

适用场景

  1. 01实施已完成规划材料的变更
  2. 02中断后继续实现工作
  3. 03实现中发现问题时更新设计材料

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/partme-ai/openspec-skills --skill openspec-apply

安装后在 Claude Code 中输入/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 是迭代式的。

参考资料

评论

支持 Markdown