高效获取 BMad 答案的三层路径BMAD-METHOD 内置帮助、源码检索与社区求助实战指南【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD导读在 BMAD-METHODBreakthrough Method for Agile AI-Driven Development中遇到问题时的正确姿势不是盲目搜索或等待人工回复而是按“最快 → 最全面”的优先级依次使用三层资源内置的bmad-help智能引路人、可直接交给 AI 阅读的仓库源码、以及官方社区渠道。读完本文你将掌握bmad-help的调用语法与底层路由机制、让任何 agent 工具直接从源码回答问题的具体方法以及什么情况下才值得把问题抛给真人社区。一、先看全景三条答案路径的选择顺序官方文档 docs/vi-vn/how-to/get-answers-about-bmad.md 将获取答案的途径明确划分为三层顺序从“最快”到“最全面”层级途径速度适合场景第 1 层bmad-help内置 skill最快绝大多数使用问题文档称可覆盖 80% 以上提问第 2 层让 AI 直接读仓库源码快且深内部机制、历史沿革、架构问题或安装前调研第 3 层社区真人求助最慢前两层都未能解决、且问题已被充分收窄之后理解这条递进逻辑很重要每一层都会帮你把问题变得更具体、更清晰最后落到社区时你提的将是一个高质量的、别人愿意回答的问题而不是一句笼统的“这个工具怎么用”。二、第 1 层直接问 BMad-Help2.1 为什么它是最快入口bmad-help是 BMad 内置的核心 skill安装 BMad 后它直接出现在你的 AI 会话IDE中不需要记忆任何 workflow 名称或阶段编号。官方文档的定位是它会检查你的项目、看明白你已经完成了多少然后告诉你接下来应该做什么。在 docs/vi-vn/reference/core-tools.md 中bmad-help被定义为“智能引路人”người dẫn đường thông minh其工作流程为扫描项目查找现有 artifact如 PRD、architecture、stories 等探测已安装的模块及其可用 workflow按优先级推荐下一步——必做步骤在前、可选步骤在后每个推荐都附上对应的 skill 命令与简短说明。也就是说你不必知道“现在我该跑哪个 workflow”只要描述处境bmad-help会结合项目实际状态给出上下文相关的建议。2.2 调用语法与跨平台差异bmad-help接受可选的自然语言查询直接在 AI IDE 中键入 skill 名即可bmad-help Tôi có ý tưởng SaaS và đã biết tất cả tính năng. Tôi nên bắt đầu từ đâu? bmad-help Tôi có những lựa chọn nào cho thiết kế UX? bmad-help Tôi đang bị mắc ở workflow PRD对应英文场景下的常用形态bmad-help I have a SaaS idea and know all the features. Where do I start? bmad-help What are my options for UX design? bmad-help Im stuck on the PRD workflow跨平台提示官方 tip某些平台还支持/bmad-help或$bmad-help写法但只有裸写bmad-help是保证在所有平台都能生效的通用形式。如果你在某个 IDE 中看不到 skills 列表部分平台需要先在设置中手动启用 skills详见 docs/vi-vn/reference/commands.md 的故障排查一节。2.3 底层实现它到底怎么“知道答案”从源码看bmad-help并非预置了一堆 FAQ而是一个按需动态发现 知识文档路由的机制核心实现在 skills/bmad/SKILL.md每次请求都重新发现Fresh Discovery for Every Requestbmad-help不会复用上一次的扫描结果而是对每次请求重新扫描所有已暴露的 skill 根目录读取每个活动目录旁的module-manifest.toml。按 module 分组已安装的 skills 依据其 manifest 中的module键分组无法读取、非法 TOML 或缺少可用module的 manifest 会被跳过不影响其余模块。knowledge 路由读取每个合法 manifest 的knowledge字段一段自由文本说明该模块的知识存放在哪里然后只跟随问题所涉及模块的 knowledge 指向的文档去路由。以 hub 模块为例skills/bmad/module-manifest.toml 中声明module toolbox version 6.13.0-next knowledge references/help.md in the bmad skill也就是说method 与 toolbox 模块的知识文档就是 skills/bmad/references/help.md它是唯一的“路由指南”——bmad-help不会凭 skill 文件夹名称或通用知识去臆造流程顺序。回答形状Answer Shape先回答用户的实际问题再附上最少的定位信息——相关模块与当前状态含不确定性、与问题相关的已安装 skill用规范 id 平台提供的描述、下一个可用选项及其知识依据、限制因素。它不会倾倒一份“已装 vs 缺失”的目录清单。普通帮助是只读操作bmad-help的普通求助流程绝不触发bmad setup/bmad update/bmad doctor不写文件、不缓存发现结果、不创建任何_bmad目录下的遗留缓存同时仅从兄弟 skill 目录读取module-manifest.toml和 knowledge 指向的文档绝不打开其他 skill 的SKILL.md。这些约束含三条运维命令bmad update/bmad doctor/bmad setup的完整调用参数记录在 skills/bmad/references/setup.md 与 skills/bmad/scripts/setup.py如--project-root、--skill、--module-answers、--list-config-questions、--update、--doctor等命令行参数。小结bmad-help的“聪明”来自三个事实它读取你项目里真实安装的 skills 清单、跟随 knowledge 文档路由、并只依据知识文档推理下一步。它甚至能在每个 workflow 结束时自动运行告诉你确切的下一步参见 docs/vi-vn/tutorials/getting-started.md。三、第 2 层让 AI 直接读源码3.1 什么时候该用这一层bmad-help的答案基于你已安装的配置。当你需要了解 BMad 的内部实现、历史沿革、架构设计或者你还没有安装、正在安装前做调研时正确做法是把 AI 直接指向源码仓库。操作方式很简单克隆或打开 BMAD-METHOD 仓库然后在任何支持 agent 的工具如 Claude Code、Cursor、Windsurf 等中向你的 AI 提问它可以直接读取源码并基于代码事实回答。3.2 一个官方示例问答官方文档给出了一个典型问答直观展示“让 AI 读源码”能获得什么Q:“请告诉我用 BMad 构建东西的最快方式”A:运行bmad-build。直接把意图、issue、spec 或已规划好的 story 交给它workflow 会利用现有上下文自主选择所需的澄清、规划、实现与 review 深度。这个回答的底气来自源码在 skills/bmad/references/help.md 的知识文档中bmad-build被描述为“所有路径共用的实现单元”——一个会话级交付单元澄清意图、按需规划、实现、review 并呈现结果。同文档还给出了完整的 skill 全景与流程位置塑形与规划类bmad-spec、bmad-product-brief、bmad-prfaq、bmad-prd、bmad-ux、bmad-architecture、bmad-create-epics-and-stories、bmad-sprint-planning、bmad-project-context实现与质量类bmad-build、bmad-build-auto、bmad-code-review、bmad-walkthrough、bmad-qa-generate-e2e-tests、bmad-retrospective、bmad-correct-course可选 agent personabmad-agent-analyst、bmad-agent-architect、bmad-agent-dev、bmad-agent-pm、bmad-agent-ux-designer独立支撑类bmad-brainstorming、bmad-forge-idea、bmad-deep-recon、bmad-advanced-elicitation、bmad-review、bmad-party-mode、bmad-customize。当你向 AI 提出“现在该做什么”这类问题时它会遵循 help.md 中的“answering whats next”准则先读取状态存在哪些规划 artifact、代码库/git 历史/用户陈述完成了什么再推荐当前路径中下一个未完成的阶段而不是建议从头重跑注意status: done之类的标记本身并不能证明完成。当问题超出知识文档覆盖范围时文档指引 AI 去抓取官方文档站点的llms.txt索引而仓库源码始终是“任何行为实际如何运作”的最终权威。3.3 拿到更好答案的两个技巧官方文档特别强调两点问得越具体越好——“PRD workflow 的第 3 步做什么”远胜于“PRD 是怎么工作的”。具体问题能引导 AI 精准定位到对应的 skill 文件与步骤文档。验证听起来可疑的答案——LLM 偶尔会犯错。当回答与直觉相悖时请回到源码文件核对或在社区频道见下一节交叉确认。这也呼应了 help.md 中“以磁盘上的 manifest 为准、以知识文档为准”的设计哲学任何 AI 给出的路由结论都可以回到仓库里验证。3.4 没有 agent 可用用文档站点如果你的 AI 工具无法读取本地文件例如 ChatGPT、Claude.ai 这类云端网页产品官方提供托管文档站点作为替代入口其中收录了与仓库 docs 目录同步的多语言文档英语、简体中文、越南语、韩语、捷克语、法语等包括本文所基于的 docs/vi-vn/how-to/get-answers-about-bmad.md 以及英文原版 docs/start/get-answers-about-bmad.md。四、第 3 层问真人社区渠道4.1 什么时候才该走到这一步官方文档给出的判断标准很明确当bmad-help和源码都未能回答你的问题时此时你已经拥有一个比最初具体得多的好问题值得拿去问社区。换句话说社区不是第一站而是验证与兜底——直接空手去问“BMad 怎么用”远不如带着“我在 PRD workflow 第 3 步遇到 X源码里 Y 处似乎与文档 Z 矛盾”这类问题有效。4.2 官方渠道与用途渠道用途help-requests论坛提问求助#suggestions-feedback频道想法与功能建议此外官方维护Discord 服务器与GitHub Issues两个社区入口Discord 适合即时交流与快速讨论GitHub Issues 适合可追踪、需要沉淀的问题与缺陷反馈。你可以从仓库主页与安装输出中获取最新的社区入口信息bmad-help在知识文档不足时也会指引到官方文档站点的llms.txt索引作为补充。4.3 求助前自查清单结合前三节把问题抛给真人之前请先确认已用bmad-help问过且把它的回答贴进问题背景已让 AI 读过对应源码文件如 skills/bmad/references/help.md、对应模块的SKILL.md确认过可疑结论问题已收窄到某个具体 skill、具体步骤或具体行为差异。五、总结三层路径的决策准则先问bmad-help——它内置、最快、基于你的实际安装状态处理绝大多数问题且每个 workflow 结束时都会自动提示下一步再读源码——涉及内部机制、架构、历史或安装前调研时把仓库交给任何支持 agent 的工具并遵循“问具体、验证可疑”两条准则最后问社区——前两层仍未解决时带着被充分收窄的问题进入help-requests论坛、Discord 或 GitHub Issues。这套“机器优先、人工兜底”的路径设计贯穿 BMAD-METHOD 的哲学源码就在那里清晰可见——先让机器读懂它再决定是否值得占用一个真人的时间。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 高效获取 BMad 答案的三层路径：BMAD-METHOD 内置帮助、源码检索与社区求助实战指南
高效获取 BMad 答案的三层路径BMAD-METHOD 内置帮助、源码检索与社区求助实战指南【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD导读在 BMAD-METHODBreakthrough Method for Agile AI-Driven Development中遇到问题时的正确姿势不是盲目搜索或等待人工回复而是按“最快 → 最全面”的优先级依次使用三层资源内置的bmad-help智能引路人、可直接交给 AI 阅读的仓库源码、以及官方社区渠道。读完本文你将掌握bmad-help的调用语法与底层路由机制、让任何 agent 工具直接从源码回答问题的具体方法以及什么情况下才值得把问题抛给真人社区。一、先看全景三条答案路径的选择顺序官方文档 docs/vi-vn/how-to/get-answers-about-bmad.md 将获取答案的途径明确划分为三层顺序从“最快”到“最全面”层级途径速度适合场景第 1 层bmad-help内置 skill最快绝大多数使用问题文档称可覆盖 80% 以上提问第 2 层让 AI 直接读仓库源码快且深内部机制、历史沿革、架构问题或安装前调研第 3 层社区真人求助最慢前两层都未能解决、且问题已被充分收窄之后理解这条递进逻辑很重要每一层都会帮你把问题变得更具体、更清晰最后落到社区时你提的将是一个高质量的、别人愿意回答的问题而不是一句笼统的“这个工具怎么用”。二、第 1 层直接问 BMad-Help2.1 为什么它是最快入口bmad-help是 BMad 内置的核心 skill安装 BMad 后它直接出现在你的 AI 会话IDE中不需要记忆任何 workflow 名称或阶段编号。官方文档的定位是它会检查你的项目、看明白你已经完成了多少然后告诉你接下来应该做什么。在 docs/vi-vn/reference/core-tools.md 中bmad-help被定义为“智能引路人”người dẫn đường thông minh其工作流程为扫描项目查找现有 artifact如 PRD、architecture、stories 等探测已安装的模块及其可用 workflow按优先级推荐下一步——必做步骤在前、可选步骤在后每个推荐都附上对应的 skill 命令与简短说明。也就是说你不必知道“现在我该跑哪个 workflow”只要描述处境bmad-help会结合项目实际状态给出上下文相关的建议。2.2 调用语法与跨平台差异bmad-help接受可选的自然语言查询直接在 AI IDE 中键入 skill 名即可bmad-help Tôi có ý tưởng SaaS và đã biết tất cả tính năng. Tôi nên bắt đầu từ đâu? bmad-help Tôi có những lựa chọn nào cho thiết kế UX? bmad-help Tôi đang bị mắc ở workflow PRD对应英文场景下的常用形态bmad-help I have a SaaS idea and know all the features. Where do I start? bmad-help What are my options for UX design? bmad-help Im stuck on the PRD workflow跨平台提示官方 tip某些平台还支持/bmad-help或$bmad-help写法但只有裸写bmad-help是保证在所有平台都能生效的通用形式。如果你在某个 IDE 中看不到 skills 列表部分平台需要先在设置中手动启用 skills详见 docs/vi-vn/reference/commands.md 的故障排查一节。2.3 底层实现它到底怎么“知道答案”从源码看bmad-help并非预置了一堆 FAQ而是一个按需动态发现 知识文档路由的机制核心实现在 skills/bmad/SKILL.md每次请求都重新发现Fresh Discovery for Every Requestbmad-help不会复用上一次的扫描结果而是对每次请求重新扫描所有已暴露的 skill 根目录读取每个活动目录旁的module-manifest.toml。按 module 分组已安装的 skills 依据其 manifest 中的module键分组无法读取、非法 TOML 或缺少可用module的 manifest 会被跳过不影响其余模块。knowledge 路由读取每个合法 manifest 的knowledge字段一段自由文本说明该模块的知识存放在哪里然后只跟随问题所涉及模块的 knowledge 指向的文档去路由。以 hub 模块为例skills/bmad/module-manifest.toml 中声明module toolbox version 6.13.0-next knowledge references/help.md in the bmad skill也就是说method 与 toolbox 模块的知识文档就是 skills/bmad/references/help.md它是唯一的“路由指南”——bmad-help不会凭 skill 文件夹名称或通用知识去臆造流程顺序。回答形状Answer Shape先回答用户的实际问题再附上最少的定位信息——相关模块与当前状态含不确定性、与问题相关的已安装 skill用规范 id 平台提供的描述、下一个可用选项及其知识依据、限制因素。它不会倾倒一份“已装 vs 缺失”的目录清单。普通帮助是只读操作bmad-help的普通求助流程绝不触发bmad setup/bmad update/bmad doctor不写文件、不缓存发现结果、不创建任何_bmad目录下的遗留缓存同时仅从兄弟 skill 目录读取module-manifest.toml和 knowledge 指向的文档绝不打开其他 skill 的SKILL.md。这些约束含三条运维命令bmad update/bmad doctor/bmad setup的完整调用参数记录在 skills/bmad/references/setup.md 与 skills/bmad/scripts/setup.py如--project-root、--skill、--module-answers、--list-config-questions、--update、--doctor等命令行参数。小结bmad-help的“聪明”来自三个事实它读取你项目里真实安装的 skills 清单、跟随 knowledge 文档路由、并只依据知识文档推理下一步。它甚至能在每个 workflow 结束时自动运行告诉你确切的下一步参见 docs/vi-vn/tutorials/getting-started.md。三、第 2 层让 AI 直接读源码3.1 什么时候该用这一层bmad-help的答案基于你已安装的配置。当你需要了解 BMad 的内部实现、历史沿革、架构设计或者你还没有安装、正在安装前做调研时正确做法是把 AI 直接指向源码仓库。操作方式很简单克隆或打开 BMAD-METHOD 仓库然后在任何支持 agent 的工具如 Claude Code、Cursor、Windsurf 等中向你的 AI 提问它可以直接读取源码并基于代码事实回答。3.2 一个官方示例问答官方文档给出了一个典型问答直观展示“让 AI 读源码”能获得什么Q:“请告诉我用 BMad 构建东西的最快方式”A:运行bmad-build。直接把意图、issue、spec 或已规划好的 story 交给它workflow 会利用现有上下文自主选择所需的澄清、规划、实现与 review 深度。这个回答的底气来自源码在 skills/bmad/references/help.md 的知识文档中bmad-build被描述为“所有路径共用的实现单元”——一个会话级交付单元澄清意图、按需规划、实现、review 并呈现结果。同文档还给出了完整的 skill 全景与流程位置塑形与规划类bmad-spec、bmad-product-brief、bmad-prfaq、bmad-prd、bmad-ux、bmad-architecture、bmad-create-epics-and-stories、bmad-sprint-planning、bmad-project-context实现与质量类bmad-build、bmad-build-auto、bmad-code-review、bmad-walkthrough、bmad-qa-generate-e2e-tests、bmad-retrospective、bmad-correct-course可选 agent personabmad-agent-analyst、bmad-agent-architect、bmad-agent-dev、bmad-agent-pm、bmad-agent-ux-designer独立支撑类bmad-brainstorming、bmad-forge-idea、bmad-deep-recon、bmad-advanced-elicitation、bmad-review、bmad-party-mode、bmad-customize。当你向 AI 提出“现在该做什么”这类问题时它会遵循 help.md 中的“answering whats next”准则先读取状态存在哪些规划 artifact、代码库/git 历史/用户陈述完成了什么再推荐当前路径中下一个未完成的阶段而不是建议从头重跑注意status: done之类的标记本身并不能证明完成。当问题超出知识文档覆盖范围时文档指引 AI 去抓取官方文档站点的llms.txt索引而仓库源码始终是“任何行为实际如何运作”的最终权威。3.3 拿到更好答案的两个技巧官方文档特别强调两点问得越具体越好——“PRD workflow 的第 3 步做什么”远胜于“PRD 是怎么工作的”。具体问题能引导 AI 精准定位到对应的 skill 文件与步骤文档。验证听起来可疑的答案——LLM 偶尔会犯错。当回答与直觉相悖时请回到源码文件核对或在社区频道见下一节交叉确认。这也呼应了 help.md 中“以磁盘上的 manifest 为准、以知识文档为准”的设计哲学任何 AI 给出的路由结论都可以回到仓库里验证。3.4 没有 agent 可用用文档站点如果你的 AI 工具无法读取本地文件例如 ChatGPT、Claude.ai 这类云端网页产品官方提供托管文档站点作为替代入口其中收录了与仓库 docs 目录同步的多语言文档英语、简体中文、越南语、韩语、捷克语、法语等包括本文所基于的 docs/vi-vn/how-to/get-answers-about-bmad.md 以及英文原版 docs/start/get-answers-about-bmad.md。四、第 3 层问真人社区渠道4.1 什么时候才该走到这一步官方文档给出的判断标准很明确当bmad-help和源码都未能回答你的问题时此时你已经拥有一个比最初具体得多的好问题值得拿去问社区。换句话说社区不是第一站而是验证与兜底——直接空手去问“BMad 怎么用”远不如带着“我在 PRD workflow 第 3 步遇到 X源码里 Y 处似乎与文档 Z 矛盾”这类问题有效。4.2 官方渠道与用途渠道用途help-requests论坛提问求助#suggestions-feedback频道想法与功能建议此外官方维护Discord 服务器与GitHub Issues两个社区入口Discord 适合即时交流与快速讨论GitHub Issues 适合可追踪、需要沉淀的问题与缺陷反馈。你可以从仓库主页与安装输出中获取最新的社区入口信息bmad-help在知识文档不足时也会指引到官方文档站点的llms.txt索引作为补充。4.3 求助前自查清单结合前三节把问题抛给真人之前请先确认已用bmad-help问过且把它的回答贴进问题背景已让 AI 读过对应源码文件如 skills/bmad/references/help.md、对应模块的SKILL.md确认过可疑结论问题已收窄到某个具体 skill、具体步骤或具体行为差异。五、总结三层路径的决策准则先问bmad-help——它内置、最快、基于你的实际安装状态处理绝大多数问题且每个 workflow 结束时都会自动提示下一步再读源码——涉及内部机制、架构、历史或安装前调研时把仓库交给任何支持 agent 的工具并遵循“问具体、验证可疑”两条准则最后问社区——前两层仍未解决时带着被充分收窄的问题进入help-requests论坛、Discord 或 GitHub Issues。这套“机器优先、人工兜底”的路径设计贯穿 BMAD-METHOD 的哲学源码就在那里清晰可见——先让机器读懂它再决定是否值得占用一个真人的时间。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考