BMAD-METHOD 默认 BMM 智能体完全指南Skill ID、菜单触发器与工作流调用机制【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD本文以 BMAD-METHOD 仓库的 docs/ko-kr/reference/agents.md 为核心系统梳理 BMad MethodBMMAgile 套件随安装提供的五个默认智能体——分析家 Mary、产品经理 John、架构师 Winston、开发者 Amelia、UX 设计师 Sally 的 Skill ID、菜单触发器与主要 workflow。读完本文你将掌握每个智能体的身份设定、底层激活流程、全部触发码与对应技能的关系并能通过customize.toml三层覆盖机制自定义智能体行为在实际项目中直接上手调用。一、背景BMad Method 中的智能体即技能BMad MethodBMM将软件交付过程划分为四个阶段可选探索分析→ 规划 → 解决方案设计 → 实现各阶段以只补充当前工作所需的最小上下文为原则推进详见 工作流地图。在 BMM 中每个默认智能体并不是独立运行的程序而是由安装程序installer生成的一个技能skill。因此调用智能体的方式就是使用它的 Skill ID 直接调用对应技能。例如需要开发者 Amelia 时调用bmad-agent-dev技能即可。仓库中这五个智能体的技能实体位于skills/目录每个目录都包含一份SKILL.md定义人设与激活流程和一份customize.toml定义角色、原则、菜单等可配置内容智能体技能目录SKILL.md 路径Analyst (Mary)skills/bmad-agent-analyst/SKILL.mdProduct Manager (John)skills/bmad-agent-pm/SKILL.mdArchitect (Winston)skills/bmad-agent-architect/SKILL.mdDeveloper (Amelia)skills/bmad-agent-dev/SKILL.mdUX Designer (Sally)skills/bmad-agent-ux-designer/SKILL.md二、五个默认智能体速查表原文档给出了核心速查表五个智能体的 Skill ID、触发器与主要 workflow 对应关系如下智能体Skill ID触发器主要 workflow分析家 (Mary)bmad-agent-analystBP、MR、DR、TR、CB、WB、PC头脑风暴、市场调研、领域调研、技术调研、撰写产品简报、PRFAQ 挑战、项目上下文产品经理 (John)bmad-agent-pmPRD、CE、IR、CCPRD 创建/更新/验证、Epics 与 Stories 创建、实现就绪检查Sprint 计划门禁、方向修正架构师 (Winston)bmad-agent-architectCA、IR架构创建、实现就绪检查Sprint 计划门禁开发者 (Amelia)bmad-agent-devBD、QA、CR、SP、ERBuild、QA 测试生成、代码评审、Sprint 规划、Epic 回顾UX 设计师 (Sally)bmad-agent-ux-designerCUUX 设计创建注意QA 测试生成由bmad-qa-generate-e2e-tests这个 workflow 技能负责通过开发者智能体运行完整的 TEA测试架构师能力位于独立模块中详见后文第五节。三、逐个解读五个默认智能体3.1 Analyst (Mary) —— 业务分析家Mary 的技能描述为业务分析家负责市场调研、竞争分析与需求提炼擅长把模糊需求转化为可执行的规格并坚持基于证据的分析。她的role定位是在 BMAD-METHOD 的分析阶段帮助用户在投入项目之前进行构思、调研与分析。从 customize.toml 可以看出 Mary 的完整菜单配置触发码能力底层动作BP专家引导式头脑风暴调用bmad-brainstorming技能MR市场分析、竞争格局、客户需求与趋势以市场调研类型调用bmad-deep-recon跳过类型推断DR行业领域深潜、领域专业知识与术语以领域调研类型调用bmad-deep-reconTR技术格局、架构模式与实现现实以技术调研类型调用bmad-deep-reconTS技术/供应商/工具选型——决策矩阵与建议以 select 决策形态调用bmad-deep-reconCR对指定竞争对手的拆解——产品、定价、定位、路线以竞争调研类型调用bmad-deep-reconUV用户之声调研——评论、社区、JTBD以用户之声调研类型调用bmad-deep-reconCB通过引导式或自主式探索创建/更新产品简报调用bmad-product-brief技能WBWorking Backwards PRFAQ 挑战——锻造并压测产品概念调用bmad-prfaq技能PC设置或刷新本仓库的智能体指令setup/refresh/record/audit调用bmad-project-context技能可以看到文档速查表中列出的BP、MR、DR、TR、CB、WB、PC是 Mary 的核心菜单而从源码看完整菜单还包含TS、CR、UV三个追加的调研入口它们全部以prompt形式转发到bmad-deep-recon技能并预选调研类型。Mary 的principles价值准则包括每项发现都锚定可验证的证据、需求表述绝对精确、每个干系人的声音都被代表。3.2 Product Manager (John) —— 产品经理John 负责通过用户访谈、需求发现与干系人对齐来驱动 PRD 创建把产品愿景转化为开发可以交付的小步验证增量。其role定位在 BMAD-METHOD 的规划阶段把产品愿景转化为可执行的 PRD、Epics 与 Stories。John 的菜单customize.toml触发码能力底层动作PRD创建、更新或验证 PRD——直接说明意图或由技能引导提问调用bmad-prd技能CE创建驱动开发的 Epics 与 Stories 清单调用bmad-create-epics-and-stories技能IR检查实现就绪度——验证规划产物完整且对齐打开 Sprint 规划在门禁处停止或继续进入跟踪调用bmad-sprint-planning技能CC实现过程中发现重大变更需求时决定如何继续调用bmad-correct-course技能John 的原则强调了PRD 来自用户访谈而非模板填空交付能验证假设的最小事物用户价值优先技术可行性是约束。3.3 Architect (Winston) —— 系统架构师Winston 负责把产品需求与 UX 转化为能成功交付的技术架构偏好无聊的技术boring technology、开发者生产力并以权衡取舍trade-offs而非裁决verdicts作答。其role定位在 BMAD-METHOD 的解决方案设计阶段把 PRD 与 UX 转化为让实现保持在正轨上的技术架构决策。Winston 的菜单customize.toml非常精简触发码能力底层动作CA产出架构主干Architecture Spine让独立构建的单元保持一致的不变量调用bmad-architecture技能IR检查实现就绪度同 John 的 IR调用bmad-sprint-planning技能Winston 的原则抽象之前先遵循三原则Rule of Three、为了稳定性采用无聊的技术、开发者生产力本身就是架构。3.4 Developer (Amelia) —— 高级软件工程师Amelia 以测试先行纪律red, green, refactor执行已批准的 Stories交付满足每一条验收标准的、经验证的代码。她的沟通风格被设定为极度简洁用文件路径和验收标准 ID 说话每句话都可溯源。其role定位在 BMAD-METHOD 的实现阶段。Amelia 的菜单customize.toml触发码能力底层动作BD实现一个特性、修复或 Story调用bmad-build技能QA为现有特性生成 API 与 E2E 测试调用bmad-qa-generate-e2e-tests技能CR跨多个质量维度发起全面代码评审调用bmad-code-review技能SP生成或更新对任务排序的 Sprint 计划调用bmad-sprint-planning技能ER基于验收标准的证据型 Epic 回顾调用bmad-retrospective技能值得一提的是 Amelia 的principles包含一条工程规范禁止在源码中写入 Epic/Story 引用注释如# Epic: X、# Story: PROJ-42代码注释只解释为什么而非是什么生成的代码必须是生产就绪、干净、无 AI 噪声的。这与仓库中bmad-retrospective、bmad-build等实现技能的工程质量取向一致。3.5 UX Designer (Sally) —— UX 设计师Sally 负责把用户需求与 PRD 转化为 UX 设计规格进而指导架构与实现。她的role定位在 BMAD-METHOD 的规划阶段把用户需求与 PRD 转化为能指导架构与实现的 UX 设计规格。Sally 只有一个菜单项customize.toml触发码能力底层动作CU引导你把 UX 规划落地以指导架构与实现调用bmad-ux技能Sally 的原则每个决策都服务于真实的用户需求、从简单开始并随反馈演进、数据知情但始终保持创造性。四、触发器Trigger机制输入短码即可启动结构化 Workflow原文档明确指出触发器的本质智能体菜单触发器会加载结构化 workflow 文件。输入触发码后智能体启动对应 workflow并在每个步骤请求输入。也就是说PRD、CA、BD这类触发码并不是简单的宏命令而是把对应 workflow 技能如bmad-prd、bmad-architecture、bmad-build接入当前智能体会话的入口。例如输入PRD→ 进入 PRD 创建/更新/验证流程由bmad-prd技能分步提问细化需求输入CA→ 启动架构创建流程产出ARCHITECTURE-SPINE.md核心文档见 工作流地图 阶段 3输入BD→ 启动 Build 流程由 Amelia 按测试先行纪律实现一个 Story。菜单项的两种底层动作从各customize.toml的注释可以看到菜单项[[agent.menu]]的每个条目恰好包含skill或prompt二者之一skill型按名称直接调用已注册技能例如BP→skill bmad-brainstormingprompt型直接执行 prompt 文本例如MR→ 用预设调研类型调用bmad-deep-recon并跳过类型推断。菜单的合并与覆盖规则customize.toml顶部注释明确了菜单合并规则标量scalars覆盖方优先数组persistent_facts、principles、activation_steps_*追加带code/id键的表数组匹配项原位替换新条目追加。这意味着团队或个人覆盖文件可以按触发码精准增删改某个菜单项而不影响其他人设。五、智能体激活流程从 SKILL.md 到实际对话每个默认智能体的SKILL.md都定义了标准的八步激活流程以 bmad-agent-analyst/SKILL.md 为例其余四个智能体结构一致解析 Agent 块运行resolve_customization.py --skill {skill-root} --project-root {project-root} --key agent若脚本失败则按 base → team → user 顺序手动读取三个覆盖文件合并执行 Prepend 步骤按activation_steps_prepend依次执行可用于预加载、合规检查采纳人设以 Overview 中的身份为基底叠加role、identity、communication_style、principles的自定义层加载持久事实persistent_facts中的条目视为整个会话的基础上下文file:前缀条目按路径/glob 加载文件内容作为事实加载配置运行resolve_config.py --project-root {project-root} --key modules.bmm.planning_artifacts --key modules.bmm.project_knowledge分别用于定位输出/扫描规划产物与扫描项目知识问候用户以{agent.icon}前缀开头如 Mary 的、John 的、Winston 的️、Amelia 的、Sally 的并提示可随时调用bmad-help执行 Append 步骤按activation_steps_append依次执行分发或呈现菜单若用户首条消息已明确映射到某个菜单项如嘿 Mary我们来头脑风暴跳过菜单直接分发否则将{agent.menu}渲染为编号表格Code/Description/Action接受数字、菜单码或模糊描述匹配。三层覆盖base → team → user与底层合并实现激活流程第 1 步提及的合并规则其实现位于 skills/bmad/scripts/resolve_customization.py。该脚本从项目根目录的_bmad/custom/下读取覆盖文件合并顺序为{skill-root}/customize.toml—— 默认值base{project-root}/_bmad/custom/{skill-name}.toml—— 团队覆盖team{project-root}/_bmad/custom/{skill-name}.user.toml—— 个人覆盖user。缺失的文件直接跳过合并规则为标量覆盖、表深合并、带code/id键的表数组匹配替换并追加新条目、其余数组追加。从源码还可确认两个实现细节Python 版本要求脚本头部requires-python 3.11因为依赖标准库tomllib低于 3.11 会报错退出exit code 3。项目根定位find_project_root会向上查找最近的包含_bmad/的祖先目录优先于.git——这是为了避免子模块/嵌套仓库中.git干扰根目录判定确保_bmad/custom/归正确的项目所有。六、QA 测试生成与 TEA 的边界原文档特别提醒QA 测试生成由bmad-qa-generate-e2e-testsworkflow 技能处理可通过开发者智能体运行Amelia 菜单中的QA触发码底层即调用该技能而完整的 TEA测试架构师能力位于独立模块不在默认五智能体之内。仓库中 skills/bmad-qa-generate-e2e-tests/SKILL.md 即为该 workflow 技能的实现载体。七、关于 Paige项目上下文能力不受影响原文档中的说明框指出技术写作者Paige 正在休整未来将以更强的能力回归。在此期间项目上下文Project Context功能依然可用通过分析家 Mary 的PCProject Context触发器调用或直接调用bmad-project-context技能仓库中 skills/bmad-project-context/SKILL.md 即其载体。八、实战调用建议综合原文档与仓库实现在实际项目中调用默认智能体的推荐路径是按 Skill ID 直接调用如需要产品经理直接调用bmad-agent-pm需要开发者调用bmad-agent-dev。这是最确定、最可复现的方式。进入会话后使用触发码激活智能体后直接输入PRD、CA、BD等短码即可启动对应结构化 workflow按流程提示逐步提供信息。自然语言直达首条消息直接表达意图如嘿 Winston帮我把这个架构定下来智能体将跳过菜单直接分发到对应 workflow。不确定时使用bmad-help在任何智能体会话中均可调用bmad-help技能获取建议。九、相关参考工作流地图워크플로 맵BMM 四阶段、全部 workflow 技能与产出物一览技能参考Commands技能调用方式说明核心工具参考Core Tools激活流程中涉及的解析脚本与工具各智能体 customize.toml人设与菜单的完整可配置项resolve_customization.py三层覆盖合并的底层实现以上速查表与源码路径可直接作为你团队内部接入 BMM 默认智能体的操作手册先记住五个 Skill ID再按场景选用触发码最后通过customize.toml三层覆盖按团队规范定制菜单与人设。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 BMAD-METHOD 默认 BMM 智能体完全指南：Skill ID、菜单触发器与工作流调用机制
BMAD-METHOD 默认 BMM 智能体完全指南Skill ID、菜单触发器与工作流调用机制【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD本文以 BMAD-METHOD 仓库的 docs/ko-kr/reference/agents.md 为核心系统梳理 BMad MethodBMMAgile 套件随安装提供的五个默认智能体——分析家 Mary、产品经理 John、架构师 Winston、开发者 Amelia、UX 设计师 Sally 的 Skill ID、菜单触发器与主要 workflow。读完本文你将掌握每个智能体的身份设定、底层激活流程、全部触发码与对应技能的关系并能通过customize.toml三层覆盖机制自定义智能体行为在实际项目中直接上手调用。一、背景BMad Method 中的智能体即技能BMad MethodBMM将软件交付过程划分为四个阶段可选探索分析→ 规划 → 解决方案设计 → 实现各阶段以只补充当前工作所需的最小上下文为原则推进详见 工作流地图。在 BMM 中每个默认智能体并不是独立运行的程序而是由安装程序installer生成的一个技能skill。因此调用智能体的方式就是使用它的 Skill ID 直接调用对应技能。例如需要开发者 Amelia 时调用bmad-agent-dev技能即可。仓库中这五个智能体的技能实体位于skills/目录每个目录都包含一份SKILL.md定义人设与激活流程和一份customize.toml定义角色、原则、菜单等可配置内容智能体技能目录SKILL.md 路径Analyst (Mary)skills/bmad-agent-analyst/SKILL.mdProduct Manager (John)skills/bmad-agent-pm/SKILL.mdArchitect (Winston)skills/bmad-agent-architect/SKILL.mdDeveloper (Amelia)skills/bmad-agent-dev/SKILL.mdUX Designer (Sally)skills/bmad-agent-ux-designer/SKILL.md二、五个默认智能体速查表原文档给出了核心速查表五个智能体的 Skill ID、触发器与主要 workflow 对应关系如下智能体Skill ID触发器主要 workflow分析家 (Mary)bmad-agent-analystBP、MR、DR、TR、CB、WB、PC头脑风暴、市场调研、领域调研、技术调研、撰写产品简报、PRFAQ 挑战、项目上下文产品经理 (John)bmad-agent-pmPRD、CE、IR、CCPRD 创建/更新/验证、Epics 与 Stories 创建、实现就绪检查Sprint 计划门禁、方向修正架构师 (Winston)bmad-agent-architectCA、IR架构创建、实现就绪检查Sprint 计划门禁开发者 (Amelia)bmad-agent-devBD、QA、CR、SP、ERBuild、QA 测试生成、代码评审、Sprint 规划、Epic 回顾UX 设计师 (Sally)bmad-agent-ux-designerCUUX 设计创建注意QA 测试生成由bmad-qa-generate-e2e-tests这个 workflow 技能负责通过开发者智能体运行完整的 TEA测试架构师能力位于独立模块中详见后文第五节。三、逐个解读五个默认智能体3.1 Analyst (Mary) —— 业务分析家Mary 的技能描述为业务分析家负责市场调研、竞争分析与需求提炼擅长把模糊需求转化为可执行的规格并坚持基于证据的分析。她的role定位是在 BMAD-METHOD 的分析阶段帮助用户在投入项目之前进行构思、调研与分析。从 customize.toml 可以看出 Mary 的完整菜单配置触发码能力底层动作BP专家引导式头脑风暴调用bmad-brainstorming技能MR市场分析、竞争格局、客户需求与趋势以市场调研类型调用bmad-deep-recon跳过类型推断DR行业领域深潜、领域专业知识与术语以领域调研类型调用bmad-deep-reconTR技术格局、架构模式与实现现实以技术调研类型调用bmad-deep-reconTS技术/供应商/工具选型——决策矩阵与建议以 select 决策形态调用bmad-deep-reconCR对指定竞争对手的拆解——产品、定价、定位、路线以竞争调研类型调用bmad-deep-reconUV用户之声调研——评论、社区、JTBD以用户之声调研类型调用bmad-deep-reconCB通过引导式或自主式探索创建/更新产品简报调用bmad-product-brief技能WBWorking Backwards PRFAQ 挑战——锻造并压测产品概念调用bmad-prfaq技能PC设置或刷新本仓库的智能体指令setup/refresh/record/audit调用bmad-project-context技能可以看到文档速查表中列出的BP、MR、DR、TR、CB、WB、PC是 Mary 的核心菜单而从源码看完整菜单还包含TS、CR、UV三个追加的调研入口它们全部以prompt形式转发到bmad-deep-recon技能并预选调研类型。Mary 的principles价值准则包括每项发现都锚定可验证的证据、需求表述绝对精确、每个干系人的声音都被代表。3.2 Product Manager (John) —— 产品经理John 负责通过用户访谈、需求发现与干系人对齐来驱动 PRD 创建把产品愿景转化为开发可以交付的小步验证增量。其role定位在 BMAD-METHOD 的规划阶段把产品愿景转化为可执行的 PRD、Epics 与 Stories。John 的菜单customize.toml触发码能力底层动作PRD创建、更新或验证 PRD——直接说明意图或由技能引导提问调用bmad-prd技能CE创建驱动开发的 Epics 与 Stories 清单调用bmad-create-epics-and-stories技能IR检查实现就绪度——验证规划产物完整且对齐打开 Sprint 规划在门禁处停止或继续进入跟踪调用bmad-sprint-planning技能CC实现过程中发现重大变更需求时决定如何继续调用bmad-correct-course技能John 的原则强调了PRD 来自用户访谈而非模板填空交付能验证假设的最小事物用户价值优先技术可行性是约束。3.3 Architect (Winston) —— 系统架构师Winston 负责把产品需求与 UX 转化为能成功交付的技术架构偏好无聊的技术boring technology、开发者生产力并以权衡取舍trade-offs而非裁决verdicts作答。其role定位在 BMAD-METHOD 的解决方案设计阶段把 PRD 与 UX 转化为让实现保持在正轨上的技术架构决策。Winston 的菜单customize.toml非常精简触发码能力底层动作CA产出架构主干Architecture Spine让独立构建的单元保持一致的不变量调用bmad-architecture技能IR检查实现就绪度同 John 的 IR调用bmad-sprint-planning技能Winston 的原则抽象之前先遵循三原则Rule of Three、为了稳定性采用无聊的技术、开发者生产力本身就是架构。3.4 Developer (Amelia) —— 高级软件工程师Amelia 以测试先行纪律red, green, refactor执行已批准的 Stories交付满足每一条验收标准的、经验证的代码。她的沟通风格被设定为极度简洁用文件路径和验收标准 ID 说话每句话都可溯源。其role定位在 BMAD-METHOD 的实现阶段。Amelia 的菜单customize.toml触发码能力底层动作BD实现一个特性、修复或 Story调用bmad-build技能QA为现有特性生成 API 与 E2E 测试调用bmad-qa-generate-e2e-tests技能CR跨多个质量维度发起全面代码评审调用bmad-code-review技能SP生成或更新对任务排序的 Sprint 计划调用bmad-sprint-planning技能ER基于验收标准的证据型 Epic 回顾调用bmad-retrospective技能值得一提的是 Amelia 的principles包含一条工程规范禁止在源码中写入 Epic/Story 引用注释如# Epic: X、# Story: PROJ-42代码注释只解释为什么而非是什么生成的代码必须是生产就绪、干净、无 AI 噪声的。这与仓库中bmad-retrospective、bmad-build等实现技能的工程质量取向一致。3.5 UX Designer (Sally) —— UX 设计师Sally 负责把用户需求与 PRD 转化为 UX 设计规格进而指导架构与实现。她的role定位在 BMAD-METHOD 的规划阶段把用户需求与 PRD 转化为能指导架构与实现的 UX 设计规格。Sally 只有一个菜单项customize.toml触发码能力底层动作CU引导你把 UX 规划落地以指导架构与实现调用bmad-ux技能Sally 的原则每个决策都服务于真实的用户需求、从简单开始并随反馈演进、数据知情但始终保持创造性。四、触发器Trigger机制输入短码即可启动结构化 Workflow原文档明确指出触发器的本质智能体菜单触发器会加载结构化 workflow 文件。输入触发码后智能体启动对应 workflow并在每个步骤请求输入。也就是说PRD、CA、BD这类触发码并不是简单的宏命令而是把对应 workflow 技能如bmad-prd、bmad-architecture、bmad-build接入当前智能体会话的入口。例如输入PRD→ 进入 PRD 创建/更新/验证流程由bmad-prd技能分步提问细化需求输入CA→ 启动架构创建流程产出ARCHITECTURE-SPINE.md核心文档见 工作流地图 阶段 3输入BD→ 启动 Build 流程由 Amelia 按测试先行纪律实现一个 Story。菜单项的两种底层动作从各customize.toml的注释可以看到菜单项[[agent.menu]]的每个条目恰好包含skill或prompt二者之一skill型按名称直接调用已注册技能例如BP→skill bmad-brainstormingprompt型直接执行 prompt 文本例如MR→ 用预设调研类型调用bmad-deep-recon并跳过类型推断。菜单的合并与覆盖规则customize.toml顶部注释明确了菜单合并规则标量scalars覆盖方优先数组persistent_facts、principles、activation_steps_*追加带code/id键的表数组匹配项原位替换新条目追加。这意味着团队或个人覆盖文件可以按触发码精准增删改某个菜单项而不影响其他人设。五、智能体激活流程从 SKILL.md 到实际对话每个默认智能体的SKILL.md都定义了标准的八步激活流程以 bmad-agent-analyst/SKILL.md 为例其余四个智能体结构一致解析 Agent 块运行resolve_customization.py --skill {skill-root} --project-root {project-root} --key agent若脚本失败则按 base → team → user 顺序手动读取三个覆盖文件合并执行 Prepend 步骤按activation_steps_prepend依次执行可用于预加载、合规检查采纳人设以 Overview 中的身份为基底叠加role、identity、communication_style、principles的自定义层加载持久事实persistent_facts中的条目视为整个会话的基础上下文file:前缀条目按路径/glob 加载文件内容作为事实加载配置运行resolve_config.py --project-root {project-root} --key modules.bmm.planning_artifacts --key modules.bmm.project_knowledge分别用于定位输出/扫描规划产物与扫描项目知识问候用户以{agent.icon}前缀开头如 Mary 的、John 的、Winston 的️、Amelia 的、Sally 的并提示可随时调用bmad-help执行 Append 步骤按activation_steps_append依次执行分发或呈现菜单若用户首条消息已明确映射到某个菜单项如嘿 Mary我们来头脑风暴跳过菜单直接分发否则将{agent.menu}渲染为编号表格Code/Description/Action接受数字、菜单码或模糊描述匹配。三层覆盖base → team → user与底层合并实现激活流程第 1 步提及的合并规则其实现位于 skills/bmad/scripts/resolve_customization.py。该脚本从项目根目录的_bmad/custom/下读取覆盖文件合并顺序为{skill-root}/customize.toml—— 默认值base{project-root}/_bmad/custom/{skill-name}.toml—— 团队覆盖team{project-root}/_bmad/custom/{skill-name}.user.toml—— 个人覆盖user。缺失的文件直接跳过合并规则为标量覆盖、表深合并、带code/id键的表数组匹配替换并追加新条目、其余数组追加。从源码还可确认两个实现细节Python 版本要求脚本头部requires-python 3.11因为依赖标准库tomllib低于 3.11 会报错退出exit code 3。项目根定位find_project_root会向上查找最近的包含_bmad/的祖先目录优先于.git——这是为了避免子模块/嵌套仓库中.git干扰根目录判定确保_bmad/custom/归正确的项目所有。六、QA 测试生成与 TEA 的边界原文档特别提醒QA 测试生成由bmad-qa-generate-e2e-testsworkflow 技能处理可通过开发者智能体运行Amelia 菜单中的QA触发码底层即调用该技能而完整的 TEA测试架构师能力位于独立模块不在默认五智能体之内。仓库中 skills/bmad-qa-generate-e2e-tests/SKILL.md 即为该 workflow 技能的实现载体。七、关于 Paige项目上下文能力不受影响原文档中的说明框指出技术写作者Paige 正在休整未来将以更强的能力回归。在此期间项目上下文Project Context功能依然可用通过分析家 Mary 的PCProject Context触发器调用或直接调用bmad-project-context技能仓库中 skills/bmad-project-context/SKILL.md 即其载体。八、实战调用建议综合原文档与仓库实现在实际项目中调用默认智能体的推荐路径是按 Skill ID 直接调用如需要产品经理直接调用bmad-agent-pm需要开发者调用bmad-agent-dev。这是最确定、最可复现的方式。进入会话后使用触发码激活智能体后直接输入PRD、CA、BD等短码即可启动对应结构化 workflow按流程提示逐步提供信息。自然语言直达首条消息直接表达意图如嘿 Winston帮我把这个架构定下来智能体将跳过菜单直接分发到对应 workflow。不确定时使用bmad-help在任何智能体会话中均可调用bmad-help技能获取建议。九、相关参考工作流地图워크플로 맵BMM 四阶段、全部 workflow 技能与产出物一览技能参考Commands技能调用方式说明核心工具参考Core Tools激活流程中涉及的解析脚本与工具各智能体 customize.toml人设与菜单的完整可配置项resolve_customization.py三层覆盖合并的底层实现以上速查表与源码路径可直接作为你团队内部接入 BMM 默认智能体的操作手册先记住五个 Skill ID再按场景选用触发码最后通过customize.toml三层覆盖按团队规范定制菜单与人设。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考