BMad 技能Skills体系完全指南从 SKILL.md 到 IDE 工作流【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHODBMad 的技能Skill是驱动整套 Agile AI 开发方法落地的核心机制——它是预先编写好的提示词文件SKILL.md让用户能在 IDE 中一键加载专业 Agent 人格、运行多步骤工作流或执行独立任务。本文基于 BMAD-METHOD 仓库中 docs/ko-kr/reference/commands.md 这一技能参考文档展开并结合仓库内skills/目录下的真实技能实现与安装脚本讲解技能的定义、生成机制、文件位置、分类体系、命名规范与常见排障方法。读完本文你将能理解 BMad 技能从安装生成到在 IDE 中调用的完整链路并掌握如何区分与选择 Agent 技能、工作流技能和工具技能。什么是 BMad 技能在 BMad 中技能是预写好的提示词prompt用于在 IDE 内加载一个 Agent、运行一个工作流或处理一项任务。BMad 安装程序installer会在安装时根据你选择的模块module生成对应的一组技能。如果在之后新增、移除或更改了模块需要重新运行安装程序来同步技能参见本文的问题排查一节。技能的本质是一个包含SKILL.md文件的文件夹。SKILL.md告诉 AI 加载相应的源文件并遵循其中指示。以仓库中的实际技能为例skills/bmad-agent-dev/SKILL.md 定义了Amelia —— 高级软件工程师的完整人格、激活步骤与菜单分发逻辑skills/bmad-prd/SKILL.md 定义了 PRD 生成/更新/校验的完整工作流skills/bmad/SKILL.md 则是bmad-help智能向导的实现规定了每次请求都重新扫描已安装技能的发现机制。从源码结构看每个技能目录还附带一个module-manifest.toml清单文件声明其所属模块与知识文档位置例如 skills/bmad/module-manifest.toml 声明module toolbox、knowledge references/help.md而 skills/bmad-agent-dev/module-manifest.toml 声明module method。这份清单是安装程序与bmad-help判断哪些技能属于哪个模块的依据。技能 vs Agent 菜单触发器BMad 提供两种启动任务的途径二者的目的与调用方式不同请根据场景选用方式调用方法发生什么技能Skill在 IDE 中输入技能名称例如bmad-help直接加载 Agent或运行工作流或处理任务Agent 菜单触发器Menu Trigger先加载 Agent再输入短代码例如BDAgent 保持其人格persona解读代码并启动匹配的工作流两者的选择原则很清晰Agent 菜单触发器需要一个已激活的 Agent 会话如果你已经知道想要哪个工作流直接使用技能如果你正在与某个 Agent 协作、不想离开当前对话就想切换任务则使用触发器。docs/ko-kr/reference/agents.md给出了完整的默认 Agent 与触发器对照例如开发者 AgentAmelia的技能 ID 为bmad-agent-dev菜单触发器包括BDBuild、QAQA 测试生成、CR代码评审、SP冲刺规划、ER史诗回顾产品经理 AgentJohn的技能 ID 为bmad-agent-pm触发器包括PRD、CE、IR、CC。详见 Agent 参考。技能是如何生成的运行安装命令npx bmad-method install安装程序会执行以下动作读取所有已选模块的module-manifest.toml清单为每个模块中的每个 Agent、工作流、任务和工具生成一个对应的技能每个技能都是一个包含SKILL.md的文件夹SKILL.md会引导 AI 加载对应源文件并遵循指示。安装程序按技能类型使用不同的生成模板各类型生成文件的职责如下技能类型生成文件的职责Agent 执行器Agent Runner加载 Agent 人格文件、激活菜单、保持人格工作流技能Workflow Skill加载工作流配置并遵循各步骤执行任务技能Task Skill加载独立运行的任务文件并遵循指示工具技能Tool Skill加载独立运行的工具文件并遵循指示注意重新运行安装程序如果你新增或移除了模块请重新运行安装程序。它会根据当前模块选择重新生成全部技能文件确保技能集合与模块选择保持一致。这一生成机制在仓库源码中可以得到印证。skills/bmad/scripts/render_skill.py是技能渲染器的核心实现其main()函数接受--project-root、--skill、--overrides与--set参数见 render_skill.py它读取技能目录下除SKILL.md之外的所有 Markdown 源文件将customize.toml中的配置值如{project-root}、{workflow.name}等占位符解析替换后渲染出可执行的workflow.md入口文件。同时skills/bmad/scripts/setup.py负责检查已安装的清单manifest并在_bmad目录下物化或修复项目运行时doctor 模式为只读检查不会改动文件。也就是说技能文件既可以在安装时由npx bmad-method install一次性生成也可以在运行期由渲染脚本按需解析定制配置。技能文件的位置安装程序会将技能文件写入项目内的IDE 专属目录确切路径取决于安装时选择的 IDEIDE / CLI技能目录Claude Code.claude/skills/Cursor.agents/skills/Windsurf.agents/skills/其他 IDE以安装程序输出的目标路径为准每个技能都是包含SKILL.md的文件夹。以 Claude Code 安装为例目录结构如下.claude/skills/ ├── bmad-help/ │ └── SKILL.md ├── bmad-prd/ │ └── SKILL.md ├── bmad-agent-dev/ │ └── SKILL.md └── ...目录名决定 IDE 中的技能名。例如bmad-agent-dev/目录会注册为bmad-agent-dev技能。这与仓库内skills/目录的命名约定完全一致——仓库源码中的每个技能目录名bmad-agent-dev、bmad-prd、bmad-ux、bmad-code-review等就是安装后 IDE 中可直接调用的技能 ID。如何调用技能在 IDE 中输入技能名称即可调用例如直接输入bmad-help。需要注意部分平台要求先在设置中显式启用技能技能才会出现在候选列表中。如果你不确定下一步该做什么可以运行bmad-help它会根据你的具体情境给出指引。快速探索技巧项目内生成的技能目录就是最可靠的一手清单。用文件管理器打开技能目录可以看到所有技能及其说明description一目了然。从源码看bmad-help的实现skills/bmad/SKILL.md非常强调基于已安装技能的实时发现它要求每次请求都重新扫描宿主暴露的技能根目录只把带有有效module-manifest.toml的文件夹视为已安装技能按module键分组并只依据清单中knowledge字段指向的知识文档进行路由——绝不凭空编造流程、菜单代码或未安装的技能。技能分类BMad 技能按用途分为三大类Agent 技能、工作流技能与任务/工具技能。Agent 技能Agent 技能加载一个具备明确角色、沟通风格和工作流菜单的专业 AI 人格。加载后Agent 会保持该人格并响应菜单触发器。仓库中的默认 BMM敏捷产品套件Agent 技能示例如下示例技能Agent角色bmad-agent-devAmelia开发者严格遵循规格实现故事Storybmad-agent-pmJohn产品经理PRD 生成与校验bmad-agent-architectWinston架构师系统架构设计完整的默认 Agent 与触发器列表见 Agent 参考。以仓库中真实存在的 skills/bmad-agent-dev/SKILL.md 为例可以看到 Agent 技能的典型实现结构先通过resolve_customization.py解析自定义配置agent块按 base → team → user 三层合并规则覆盖然后执行激活步骤activation_steps_prepend、采纳人格role、identity、communication_style、principles、加载持久事实persistent_facts与项目配置最后以{agent.icon}前缀问候用户并渲染{agent.menu}数字菜单等待用户输入菜单代码或模糊描述来分发任务。工作流技能工作流技能不预先加载 Agent 人格而是执行结构化的多步骤流程加载工作流配置并依次遵循各步骤。示例技能目的bmad-product-brief生成或更新产品简介——概念明确时通过分步提问将其具体化bmad-prfaq对产品概念进行压力测试的工作反向 PRFAQ挑战bmad-prd产品需求文档PRD的生成、更新与校验bmad-ux用户体验设计bmad-architecture系统架构设计bmad-create-epics-and-stories史诗Epic与故事Story创建bmad-build实现用户直接给出的意图、问题、功能、修复或已规划的故事bmad-code-review执行代码评审bmad-build-auto无人干预地自动执行一次 Build 实现模型逐步的完整工作流参考见 工作流地图。工作流技能的源码实现同样可以在仓库中找到。例如 skills/bmad-prd/SKILL.md 展示了一个典型工作流技能的完整生命周期激活时解析workflow配置块、按意图区分Create / Update / Validate三种模式运行时通过memlog.py维护运行记忆与审计轨迹.memlog.md、通过子代理subagent完成资料提取与评审最后执行 Finalize 流程记忆审计 → 输入对账 → 评审门 → 开放项分诊 → 润色 → 外部交接 → 关闭并在prd.md前端元数据中标记status: final。任务与工具技能任务与工具tasks tools是不需要 Agent 或工作流上下文的独立操作。BMad 帮助智能向导bmad-help是寻找下一步做什么的默认入口。它会检查项目状态、理解自然语言请求然后基于已安装的模块推荐下一步的必需步骤或可选步骤。示例bmad-help bmad-help 我有一个 SaaS 想法功能都清楚了该从哪里开始 bmad-help UX 设计有哪些选择其他核心任务与工具核心模块core module内置了 8 个工具涵盖帮助、评审、改进、自定义与思考类技能头脑风暴、想法锤炼、派对模式等。完整列表见 核心工具。根据 核心工具 文档这些内置工具包括bmad-help根据项目状态与已完成工作按优先级推荐下一步必需步骤在前、可选步骤在后bmad-advanced-elicitation通过迭代精化技法让 LLM 重新审视并打磨最近的输出支持苏格拉底式提问、第一性原理、事前验尸pre-mortem、红队等命名技法bmad-review用多种透镜lens评审 diff、文档与产出物——代码用对抗性adversarial、边缘用例edge-case-hunter、验证空白verification-gap透镜文档用结构structure、文字表达prose透镜bmad-customize在_bmad/custom/下生成并校验定制化覆盖文件无需手写 TOML思考技能bmad-brainstorming交互式头脑风暴、bmad-deep-recon三类模式的研究、bmad-forge-idea对想法进行压力测试直至锤炼成形、证明可行或低成本否决、bmad-party-mode多 Agent 小组讨论。值得注意的是bmad-review、bmad-deep-recon等技能经历了合并演进旧的bmad-editorial-review系列与bmad-review-*系列统一并入bmad-review旧的bmad-market-research、bmad-domain-research、bmad-technical-research统一并入bmad-deep-recon旧 ID 仍会以兼容方式指向新技能。命名规则所有技能都遵循bmad-前缀 描述性名称的命名规则例如bmad-agent-dev、bmad-prd、bmad-help。可用模块列表见 模块。这一规则保证了技能在 IDE 中可被稳定识别与检索也方便安装程序按前缀批量生成与用户按前缀快速联想。问题排查Troubleshooting症状一安装后看不到技能。部分平台需要在设置中显式启用技能。请查阅 IDE 文档或直接向 AI 助手询问如何启用技能。有时还需要重启 IDE 或刷新窗口才能生效。症状二缺少预期中的技能。安装程序只会生成所选模块对应的技能。请重新运行npx bmad-method install并确认模块选择然后检查预期目录下是否存在对应的技能文件。症状三已移除模块的技能仍然存在。安装程序不会自动删除过期的技能文件。请在 IDE 技能目录中手动移除旧目录或者删除整个技能目录后重新运行安装程序从而得到一套干净的技能集合。深入理解SKILL.md 的渲染与定制机制理解技能的底层机制有助于你更好地使用与排查。仓库中的渲染器 skills/bmad/scripts/render_skill.py 揭示了技能文件的生成细节渲染器会收集技能目录下除SKILL.md外的所有 Markdown 源文件_load_sources并要求入口文件workflow.md存在它支持命令行传参--overrides TOML文件传入仅本次调用生效的定制配置--set KEYVALUE直接赋值两者都会并入默认配置渲染时会解析{project-root}等占位符_resolve_config_value并把customize.toml中声明的键值注入渲染上下文持久化覆盖层_bmad/custom/skill.toml与skill.user.toml只能设置技能在customize.toml中已声明的键拼写错误或过期键会直接中止渲染_check_persistent_layers这正是模块变更后需重新安装/同步这一建议的底层原因。每个技能的customize.toml如 skills/bmad-agent-dev/customize.toml是定制的入口无论是调整 Agent 人格agent块、修改工作流行为workflow块还是配置菜单项都可以通过bmad-customize技能或直接编写覆盖文件来实现更完整的定制方法参见 如何定制 BMad。小结BMad 技能体系把加载人格、执行流程、处理任务三种能力统一为bmad-前缀的可调用技能并通过npx bmad-method install与SKILL.md渲染机制实现模块选择 → 技能生成 → IDE 调用的闭环。理解技能与 Agent 菜单触发器的分工、掌握三类技能的分类与调用方式、熟悉技能目录结构与排障手段是高效使用 BMad 进行 Agile AI 驱动开发的第一步。当你不确定下一步时随时运行bmad-help——它会基于你当前真实安装的技能集合给出下一步建议。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考