BMAD-METHOD 答疑指南从 bmad-help 技能到源码问答与社区渠道的三层求助体系【免费下载链接】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-METHOD 仓库源码让任意 agent 工具直接读源回答最后才把此时已经打磨得更好的问题抛给社区。本文完整走查这条路径并结合 bmad 技能定义 与 知识路由文档 的源码说明 bmad-help 为什么能检查你的项目、看到你已经完成了什么、并告诉你接下来做什么。一、答疑总览三级路径层级手段适用场景速度1bmad-help技能日常问题从哪开始、有哪些选项、卡在某个工作流最快会话内直接回答2源码问答BMad 内部机制、历史、架构或安装前的调研中等需要 agent 能读本地文件3社区渠道前两层都答不上来的问题最慢但问题已经聚焦核心思想是先让机器回答。内置帮助覆盖绝大多数日常问题它依赖的是你实际安装的配置所以答案是针对你的环境的。只有当问题超出已安装配置的知识范围例如询问 BMad 本身的实现细节、演进历史才升级到读源码最后才是问人。二、第一级直接问 bmad-helpbmad-help是最快的回答方式。它直接运行在你的 AI 会话里官方文档称其能处理 80% 以上的问题——它会检查你的项目状态看到你已经完成了哪些阶段然后告诉你下一步该做什么。典型的问法如下原文档给出的示例法语版文档docs/fr/how-to/get-answers-about-bmad.md中的英文原版见 docs/start/get-answers-about-bmad.mdbmad-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中文语境下等价于我有个 SaaS 想法功能都想清楚了从哪开始、UX 设计我有哪些选项、我在 PRD 工作流上卡住了。调用方式提示不同平台上可以写bmad-help、/bmad-help或$bmad-help但单独写bmad-help在任何平台上都应该能工作。2.1 bmad-help 在源码中是什么bmad-help并不是一段独立的问答脚本而是仓库中的bmad技能。其 frontmatter 描述精确界定了触发时机Analyzes current state and user query to answer BMad questions or recommend the next skill(s) to use. Use when user asks for help, bmad help, what to do next, or what to start with in BMad. Also when the user asks to set up, update, or doctor this BMad installation.也就是说它负责两类请求日常的该干什么咨询以及帮我设置/更新/体检这套 BMad 安装后者会转入 references/setup.md 中对应的流程且源码明确要求 setup / update / doctor 三条命令彼此独立不能互相混用路由。2.2 每次请求都做全新发现skills/bmad/SKILL.md#L22-L45 定义了 bmad-help 回答任何问题前必须执行的发现流程使用宿主Claude Code、Cursor 等已暴露在上下文中的项目技能根目录和当前技能清单从不要求用户自己提供宿主元数据若清单缺失说明缺失的能力并停止而不是换一个来源凑数。每次请求都重新扫描不复用之前的扫描结果项目级技能遮蔽用户级技能出现同分重复时如实说明而不是任选其一。收集每个技能目录的module-manifest.toml忽略没有清单的目录跳过无法解析或缺少module键的清单带着仍然健康的模块继续。按module键对已安装技能分组——磁盘上的module键就是成员名单。读取每个健康清单的knowledge值自由文本说明该模块的知识在哪里顺着它指向的文档进行路由。那些知识文档是唯一的路由依据其他清单键一律不用于路由。以bmad技能自身为例module-manifest.toml 只有四行却点明了路由落点module toolbox version 6.13.0-next update_source github:bmad-code-org/BMAD-METHOD/skills knowledge references/help.md in the bmad skill2.3 知识文档技能目录与规模分级路由knowledge指向的 references/help.md 就是 bmad-help 回答该走哪条路的权威依据。它把所有技能按流程阶段分组塑形与规划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-courseagent 人设可选bmad-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——它们不属于任何路径或阶段任何时候觉得有用就建议但绝不呈现为必需步骤。路由的核心判据写在 help.md 的 How to use BMad 一节先问一个实现会话能否合理地理解、实现、评审并收尾这次变更规模只是其中一个信号——高风险、需求不清、架构波及面大或需要多人协作都会把工作往上一档推。对应四个档位档位判据路径Trivial改动显而易见且低风险直接改不用任何 BMad 技能One session一个连贯意图能装进一个会话直接交给bmad-build无需先跑规划技能Epic-sized一个连贯结果需要多个会话bmad-spec定 what必要时生成 architecture/UX 伴随文件→ 拆故事 → 每个故事跑一次bmad-build有风险的用bmad-build决策稳定后可编排bmad-build-auto循环→ 收尾跑bmad-retrospectiveProject-sized10–100 个编码会话完整规划链bmad-product-brief或bmad-prfaq→bmad-prd→ 必要时bmad-ux→bmad-architecture→bmad-create-epics-and-stories→bmad-sprint-planning之后每个 epic 按 Epic-sized 执行但不重复跑 spec对于接下来干什么类问题help.md 的 Answering whats next? 一节 给了明确的纪律先读状态已有哪些规划产物、代码库/git 历史/用户陈述显示完成了什么故事文件里写着status: done并不证明真正完成中途卡住就推荐所选路径上下一个未完成阶段而不是从头再来sprint 状态不清时用bmad-sprint-planning的 status 动作Build 之后bmad-code-review只是可选附加关卡且同一变更上超过两轮 agentic review 往往是变更之外的问题规划差、代码库乱的症状。一次运行算完成的条件是意图被满足、选定的检查通过、选定的评审不再留下实质性未决发现而不是所有技能都走过一遍。2.4 bmad-help 的只读约束SKILL.md 的 Ordinary Help Is Read-Only 一节 规定了普通求助请求下的硬约束不读写_bmad下的遗留配置 CSV 或模块缓存不运行resolve_config.py不把 setup/update/doctor 当副作用触发不写文件、不缓存发现结果、不修复清单从兄弟技能目录只允许读module-manifest.toml和模块knowledge指向的文档绝不打开兄弟目录的SKILL.md。这保证了问一句下一步永远是一次廉价的只读操作这也是它最快的底层原因。三、第二级指向源码深问BMad-Help 依赖的是你已安装的配置它能看到你装了哪些技能、项目走到哪一步但它答不了 BMad 本身的内部机制、历史或架构问题。另一类场景是安装前的调研——你还没装 BMad自然没有可发现的技能。这两种情况官方建议直接把 AI 指向 BMAD-METHOD 仓库源码。操作方式克隆或打开 BMAD-METHOD 仓库仓库是只读的文章仅说明查看与提问方式需要 clone 时才使用仓库地址然后对你的 AI 提问。任何具备 agent 能力的工具Claude Code、Cursor、Windsurf 等都能读源码并直接回答。原文档给了一对典型问答Q告诉我用 BMad 最快构建东西的方式A跑bmad-build。给它一个直接意图、一个 issue、一份规格或一条已规划的故事它会利用可用上下文自行选择所需的澄清、规划、实现与评审深度。这一答案与 help.md 中的路由表 完全一致——one coherent intent that fits an implementation session: hand it straight tobmad-build说明知识文档与技能实现是同源的。获得更好回答的两条技巧原文档原文建议要具体——PRD 工作流的第 3 步做什么比PRD 是怎么工作的效果好得多核实出人意料的说法—— LLM 偶尔会出错。去查源文件或到社区渠道求证。3.1 帮助链的最终兜底文档站 llms 索引值得一提的细节bmad-help 自身也有知识不够时的升级路径。help.md 的 When this document is not enough 一节 写明对于method/toolbox模块的问题若本节与已安装技能都答不了就抓取文档站提供的llms.txt索引并跟随其中与问题相关的链接——该索引覆盖整个文档站并注明源码仓库是一切实际行为的最终权威。也就是说BMad 的答疑体系本身是分层递进的本地知识文档 → 文档站 llms 索引 → 源码仓库与用户侧help → 源码 → 社区的三级路径同构。3.2 你的 AI 读不了本地文件用文档站如果所用 AI 无法读取本地文件如纯聊天界面的模型官方建议改用 BMad 文档站。文档站的源码就在本仓库中——docs-site/ 目录是一个 Astro 站点工程包含多语言内容docs/zh-cn/、docs/fr/、docs/ko-kr/、docs/vi-vn/、docs/cs/ 等、i18n 资源与链接校验脚本如 validate-doc-links.js、validate-locale-coverage.mjs可以推断文档站即由这些内容构建发布。四、第三级问人如果 bmad-help 和源码都没能回答你此时已经拥有一个打磨得更好的问题——前两层本身就是提问前的准备过程。官方给出的社区渠道分工如下原文档表格完整保留渠道用于help-requests论坛提问#suggestions-feedback想法与功能请求DiscordBMad 官方 Discord 社区#suggestions-feedback频道在其中GitHub IssuesBMAD-METHOD 仓库的 Issues 区用于缺陷报告与更正式的问题跟踪。原文档结尾附有一首小诗核心意象与本文结论一致别在队列里等——源码就在那里把机器指过去让它读、让它答。五、小结把答疑当成一个工作流把三级路径串起来就是一个可复制的求助工作流会话内bmad-help 你的问题——它基于磁盘上的module-manifest.toml做全新发现按knowledge路由到 references/help.md全程只读秒级给出当前状态 下一步仓库内对 BMAD-METHOD 源码提问回答内部机制与架构类问题提问要具体回答要对着源文件核实。仓库内可继续深入的材料包括 docs/reference/skills-and-agents.md、docs/plan/ 各规划指南、skills/ 下各技能的SKILL.md与customize.toml以及 CHANGELOG.md 中的版本演进记录社区带着已收敛的问题去help-requests论坛、Discord 或 Issues。关键认知是BMAD-METHOD 的帮助不是静态 FAQ而是一套以已安装技能清单为事实来源、以知识文档为路由依据、以源码为最终权威的活系统——这也是它的答疑体验能检查你的项目并告诉你该干什么的原因所在。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考