mcpField
B
bmad-help

bmad-help

github.com/aj-geddesAgent 工作流49390 次安装19 周前更新
代码仓库

关于 bmad-help

bmad-help 是 BMAD 会话的路由技能，会识别项目规划状态并推荐下一项技能。它适合不确定后续步骤的团队，本身不生成规划文档。

主要功能

  1. 01检测已有规划产物
  2. 02推断阶段与项目轨道
  3. 03推荐一项后续技能
  4. 04说明跳过的可选阶段
  5. 05读取项目上下文与决策日志

适用场景

  1. 01开始 BMAD 会话时了解项目状态
  2. 02暂停后确定如何继续
  3. 03工作流不明确时选择技能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aj-geddes/claude-code-bmad-skills --skill bmad-help

安装后在 Claude Code 中输入/bmad-help确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

REFERENCE.md
scripts/
detect-state.sh
recommend-next.sh

详细介绍

BMAD 帮助 — 编排主干

一个精简的路由器。它只回答一个问题：接下来该运行什么？ 它会检测规划状态、推断阶段和轨道，并指向下一个技能。它会自动调用来帮助会话确定方向，取代重量级的主控／编排 Agent。

此技能不会生成任何规划文档。 它会读取状态并给出建议。所有产物都由它路由到的专用规划技能生成。

适用场景

  • 用户询问“下一步是什么”“我进行到哪了”“我的状态如何”“继续”或“恢复”。
  • 任何 BMAD 会话开始时，在开展规划工作前先确定方向。
  • 用户不确定该调用哪个技能。

阶段图

Analysis  ──►  Planning  ──►  Solutioning  ──►  Implementation-handoff
(optional)     (required)     (conditional)     (required: ready-for-dev stories)
阶段产物技能
分析（可选）product-brief、research、brainstormbmad-product-brief / bmad-research / bmad-brainstorm
规划（必需）prd.md 或 tech-spec.md、epics.mdbmad-prd / bmad-tech-spec / bmad-epics-and-stories
规划 — UX（仅限 UI）ux-design.mdbmad-ux
解决方案设计（取决于轨道）architecture.mdbmad-architecture
实施交接（必需）{epic}.{story}.{slug}.story.md (ready-for-dev)bmad-epics-and-stories → bmad-sprint-planning

贯穿每个阶段的文件：project-context.md（项目的“章程”）和 decision-log.md（在不同工作流之间传递的决策）。如果缺少这些文件， 始终优先建议建立它们。

实施本身（编写代码、运行测试）不在范围内。此插件生成的最后一项产物是 ready-for-dev 故事文件或交接清单，并交由外部开发工具处理。

轨道（自适应规模 — 不使用编号级别）

启发式规则可根据故事数量建议轨道；由用户确认。

轨道范围必需规划可选
Quick Flow1–15 个故事tech-spec + storiesanalysis、ux
BMad Method10–50+ 个故事prd + architecture + epics + storiesanalysis；ux（如果有 UI）
Enterprise30+ 个故事prd + architecture + security + devops + epics + storiesanalysis

各轨道必需与可选步骤的详细说明：参见 REFERENCE.md。

工作原理

  1. 检测状态。 运行检测器，列出已存在的产物以及推断出的阶段：

    bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-help/scripts/detect-state.sh [output-folder]

    默认输出文件夹为 bmad-output/。它会打印产物检查清单（已存在或缺失）、 检测到的轨道（如果 decision-log 中有记录）以及推断出的阶段。

  2. 建议下一步。 将检测到的状态映射到下一个技能：

    bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-help/scripts/recommend-next.sh [output-folder]

    它会打印唯一一个要运行的下一个技能，以及原因和跳过的可选阶段。

  3. 呈现建议，用通俗文字告知用户。询问是否要调用推荐的技能。如果轨道仍有歧义， 未经确认不得自动运行规划技能。

如果 project-context.md 尚不存在，则将项目视为尚未初始化：建议先运行 bmad-init（如果用户想先进行可选的分析阶段，也可以运行 bmad-product-brief）， 以建立项目背景并选择轨道。

路由逻辑（摘要）

按顺序评估；为当前轨道推荐第一个尚未完成的步骤。

  1. 没有 project-context.md → 建立项目上下文（运行 bmad-init；如果用户选择进行分析，则运行 bmad-product-brief）。确认轨道。
  2. 没有 prd.md 和 tech-spec.md →
    • Quick Flow → bmad-tech-spec（tech-spec）。
    • BMad Method / Enterprise → bmad-prd（PRD）。
  3. 项目包含 UI，且没有 ux-design.md（BMad/Enterprise）→ bmad-ux。
  4. 轨道需要架构，且没有 architecture.md（BMad/Enterprise）→ bmad-architecture。（Quick Flow 跳过架构。）
  5. Enterprise 且没有安全/DevOps 规划 → bmad-architecture（安全 + DevOps 部分 / 交接）。
  6. 没有 epics.md（BMad/Enterprise）→ bmad-epics-and-stories（拆分史诗）。
  7. stories/ 下没有故事文件 → bmad-epics-and-stories（创建可供开发的故事）。
  8. 故事已存在，但部分仍处于 backlog 状态 / 尚未达到 ready-for-dev 状态 → bmad-epics-and-stories （完成故事上下文对象的整理）；然后运行 bmad-sprint-planning 来安排各波次。
  9. 所有必需的产物都已准备就绪，且故事处于 ready-for-dev 状态 → 交接 完成。 建议将这些故事交给外部开发工具。无需再做规划。

跳过规则： 分析始终是可选的，不要因此阻塞流程。只有项目包含 UI 时才建议进行 UX 设计。Quick Flow 跳过架构。

包含边缘情况的完整决策表：REFERENCE.md。

给 Claude 的说明

  • 这是入口点。提出建议前，始终先检测状态。
  • 只推荐一个后续技能。建议要具体、可执行。
  • 不要在此处生成规划文档，应转交给负责该任务的技能。
  • 绝不要建议运行测试、构建、代码检查工具或编写代码——这些完全不属于此插件的范围。
  • 遵守锁定部分：故事文件中的验收标准、开发说明和测试由规划技能负责，下游不得编辑。
  • 使用 decision-log.md 读取已确认的轨道；如果该文件不存在，先请用户确认轨道，再推荐特定于该轨道的步骤。

属于 BMAD Planning & Orchestrator 插件——由 BMAD Code Organization 为 BMAD Method 打造的 Claude Code 支撑工具（https://github.com/bmad-code-org/BMAD-METHOD）。体现了 bmad-help 的理念。所有方法论的功劳均归于 BMAD Code Organization。

评论

支持 Markdown