AI编程进阶实战：OpenSpec、BMAD与Skills融合构建高效开发流

许多开发者在体验AI编程的初期效率后，常会遭遇瓶颈：简单的代码生成飞快，但面对复杂业务逻辑时，AI往往出错，导致开发者抱怨模型工具或感觉AI变“智障”了。

项目在Chat中推进时，AI容易“失忆”，生成前后矛盾的代码，错误反复出现，最终还得手动修正。整体开发体验如同“抽卡”，依赖一次次重试Prompt，而非真正掌控AI辅助开发。

因此，长期使用AI工具后，我们需要突破瓶颈，从 Vibe Coding（直觉式编程） 进化到 Vibe Engineering（工程化编程）。本文将带你深入融合 OpenSpec（标准）、BMAD（方法论） 和 Skills（能力） 这三大利器，构建一套稳定、高效的AI开发体系。

1. 三大支柱的定位与关系

在进阶的AI开发体系中，这三个工具各司其职，缺一不可：

工具	定位	类比	核心作用
BMAD	道 (Dao) / 战略	包工头手册	指挥AI团队的分工与协作流程 (PM -> Arch -> Dev)
OpenSpec	法 (Fa) / 战术	施工图纸	定义人与AI、AI与AI之间沟通的 标准语言
Skills	术 (Shu) / 工具	瑞士军刀	赋予AI具体的 执行能力 (如联网、读库、特定编码技巧)

融合公式

高效 AI 开发 = BMAD (组织流程) + OpenSpec (明确需求) + Skills (强力执行)

2. 如何合理使用 BMAD (方法论)

BMAD (Breakthrough Method for Agile AI-Driven Development) 的核心是 分角色 与 分阶段。

合理的使用姿势

1. 拒绝“一把梭”

   • 不要上来就让AI“写一个电商网站”。
   • 合理做法：先用 PM Agent 拆解需求，再用 Architect Agent 设计技术方案，最后让 Developer Agent 动手编码。

2. 上下文隔离

   • 不要在一个Chat Session里从头聊到尾。
   • 合理做法：
     • Chat 1 (Planning)：产出PRD和Spec。
     • Chat 2 (Coding)：喂入Spec，开始编码。
   • 这样可以避免token过载导致AI“变笨”。

3. 按需裁剪

   • 重型任务（如新功能开发）：走全套BMAD流程 (PM -> Arch -> Dev)。
   • 轻型任务（如改个Bug、加个按钮）：可以直接跳过PM，直接扮演Dev角色。

3. 如何合理使用 OpenSpec (标准化)

OpenSpec 是解决“AI幻觉”和“需求遗漏”的特效药。它通过结构化文档（如Markdown）为AI提供清晰的“施工图纸”，这本质上是一种高效的 技术文档 实践。

合理的使用姿势

1. 核心逻辑必写Spec

   • 涉及 支付、权限、状态流转 等复杂逻辑，必须用标准的 ### Requirement 和 #### Scenario 格式。
   • 理由：Markdown的结构化数据能极大提高LLM的注意力聚焦。

2. 善用“@”引用

   • 在Cursor或Antigravity中，永远 不要把需求复制粘贴到对话框里。
   • 合理做法：写在 .md 文件里，通过 @specs/login.md 引用。这样既节省Prompt长度，又方便随时修改需求文档。

3. 让AI写Spec

   • 你不需要亲手写每一行Spec。
   • 合理做法：口述你的模糊想法，让 Architect Agent 帮你生成OpenSpec文档，你只需要负责Review和修补。

常见的误用

• 过度设计：连“修改字体颜色”都要写个Spec。
  • 修正：简单UI修改直接用口语对话即可。

4. 如何合理使用 Skills (能力扩展)

Skills (Agent Skills / MCP Tools) 是AI的“外挂系统”，赋予其连接和操作外部世界的能力。

合理的使用姿势

1. Hard Skills (MCP) - 连接世界

   • 当需要 获取实时信息 时（如“查阅最新的Next.js文档”），使用 Web Fetch Skill。
   • 当需要 操作外部系统 时（如“提一个GitHub Issue”），使用 GitHub Skill。
   • 注意：不要默认开启所有Tool，这会消耗Token并可能干扰AI判断。按需挂载。

2. Soft Skills (Code as Skill) - 沉淀经验

   • 如果你发现某个功能（如“写一个CRUD接口”）经常做，就把它封装成Skill。
   • 合理做法：
     • 创建一个Prompt模板或 .cursor rules 片段。
     • 或者编写一个脚本工具（如 generate-crud.js），让AI通过命令调用。

3. Skill的组合拳

   • 调试场景：组合 Terminal (运行代码) + File Read (读取报错) + Web Search (搜索报错解决方案)。

5. 融会贯通：一个进阶开发流案例

让我们把这三个工具结合起来，看一个 “开发用户注册功能” 的完整流程。

第一阶段：BMAD之规划 (Planning)

• 角色：User & PM Agent
• 动作：
  1. 你告诉PM Agent：“我要做一个注册功能，支持邮箱和Google登录。帮我生成需求文档”。
  2. PM Agent帮你完善细节，生成 docs/PRD-registration.md。

第二阶段：BMAD之设计 (Specifying) with OpenSpec

• 角色：Architect Agent
• 动作：
  1. 你输入：“@docs/PRD-registration.md 请把这个需求转化为OpenSpec。”
  2. Architect Agent生成 specs/auth-register.md，包含：
     • ### Requirement: 邮箱格式校验
     • #### Scenario: 邮箱已被占用
  3. 你Review文档，确认无误。

第三阶段：BMAD之执行 (Execution) with Skills

• 角色：Developer Agent
• 动作：
  1. 挂载Skills：为Agent启用 npm-search (查包) 和 file-write (写代码)。
  2. 指令：“@specs/auth-register.md 请根据Spec实现注册功能。技术栈参考 @project.md。”
  3. Agent思考与行动：
     • Skill调用：搜索 zod 库用于校验。
     • Coding：根据Spec编写 Register.vue 和 useAuth.ts。
     • Self-Correction：Agent写完后，自动读取Spec进行比对检查。

第四阶段：验证 (Verification)

• 角色：QA Agent
• 动作：
  1. 指令：“请为注册功能编写单元测试。”
  2. Agent根据Spec中的Scenarios生成测试用例。

上述流程展示了单个功能开发，整个项目开发均可依此范式执行，核心在于人为明确功能需求，AI负责高效执行。

6. 总结与核心建议

三大工具的核心价值回顾

• BMAD (方法论)：让你从“埋头写代码”转向“抬头看全局”。通过角色分工和阶段隔离，解决“AI失忆”和“需求混乱”。核心价值：拆解复杂项目，让AI各阶段聚焦。
• OpenSpec (标准化)：解决“AI幻觉”和“需求遗漏”。结构化需求文档成为可执行、可验证的资产。核心价值：提供精确的“施工图纸”。
• Skills (能力扩展)：AI的“外挂系统”。Hard Skills连接外部世界，Soft Skills沉淀可复用经验。核心价值：让AI完成开发闭环。

图：OpenSpec与Skills项目配置界面示例，可作为标准开发范本。

融会贯通的关键：理解它们的关系

这三个工具相互配合：

• BMAD决定流程：告诉你什么时候该做什么。
• OpenSpec提供标准：告诉你每个阶段该产出什么。
• Skills提供能力：告诉你AI在每个阶段能做什么。

组合起来，你就构建了一个 自驱动的AI开发系统：需求 → BMAD拆解 → OpenSpec标准化 → Skills执行 → 高质量代码。

核心建议：如何在实际项目中落地

1. 从“小实验”开始：不要一上来重构整个项目。先从小功能（如用户登录）完整走一遍BMAD流程，适应新工作习惯。
2. OpenSpec是“定义契约”：不只写文档，而是定义“什么是对的”和边界情况。无需追求完美，先写后完善，作为活文档更新。
3. Skills要“按需挂载”：避免配置过多Tool导致AI注意力分散。开发阶段用基础能力（file-read/write, terminal），调试时临时启用web-search。
4. 建立“私域知识库”：在项目中建立 specs/ 目录存放OpenSpec，prompts/ 目录沉淀Prompt模板，维护 .cursor rules 定义规范。这些数字资产提升长期效率。

进阶路径：从“会用”到“精通”

• 初级阶段（1-2周）：熟悉基本用法，用BMAD完成小功能，写几个OpenSpec，配置1-2个MCP Skills。
• 中级阶段（1-2个月）：建立自己的流程，维护 specs/ 和 prompts/ 目录，用BMAD处理中等复杂度功能。
• 高级阶段（3个月+）：成为“AI开发架构师”，为团队制定统一模板，开发自定义Soft Skills，解决复杂工程问题。

常见陷阱与避坑指南

• 陷阱1：过度依赖AI：保持对底层原理的理解，AI是助手。
• 陷阱2：Spec过于详细：只写核心逻辑和边界情况，UI细节口语沟通。
• 陷阱3：在一个Chat里聊完项目：严格分阶段，新Chat引用上一阶段产出。
• 陷阱4：Skills配置过多：按需挂载，少即是多。

下一步行动清单

1. 立即行动（今天）：创建 specs/ 目录，为一个小功能写OpenSpec文档。
2. 本周行动：完整走一遍BMAD流程，完成小功能；配置1-2个常用MCP Skills。
3. 本月行动：建立 prompts/ 目录沉淀模板，维护 .cursor rules，尝试中等复杂度功能。

最后的思考

当你熟练驾驭BMAD、OpenSpec和Skills，你将不再是单纯写代码的Coder，而是能 指挥AI军团的Software Commander。记住，工具是手段，解决实际问题才是目的。让工具服务于开发效率，助你成为AI时代的“超级个体”！

更多AI开发实战经验与资源，欢迎在 云栈社区 交流探讨。