用途:BMAD Help 是 BMAD Planning & Orchestrator 插件的编排主干与路由入口,回答“下一步运行什么”。它检测规划状态、推断阶段与 track,并指向下一个技能,常被自动调用来为会话定向,取代重量级 master/orchestrator 智能体。本技能不产出任何规划文档,只读状态并推荐;所有交付物由被路由到的专门规划技能生成。
使用场景:用户问“下一步是什么”“我在哪”“状态如何”“继续”“恢复”;任何 BMAD 会话开始时用于定向;用户不确定该调用哪个技能时。
阶段地图(按顺序评估,推荐当前 track 下第一个未完成步骤):Analysis(可选,product-brief/research/brainstorm)→ Planning(必需,prd.md 或 tech-spec.md、epics.md)→ Planning-UX(仅限有 UI 时,ux-design.md)→ Solutioning(按 track 决定,architecture.md)→ Implementation-handoff(必需,ready-for-dev 故事文件)。贯穿各阶段的是 project-context.md 与 decision-log.md,缺失时首选建议先建立它们。实现本身(写代码、跑测试)不在范围内。
Tracks(按规模自适应):Quick Flow(1–15 个故事,tech-spec + stories)、BMad Method(10–50+,prd + architecture + epics + stories)、Enterprise(30+,附加 security 与 devops)。可由故事数启发式建议,但需用户确认。
用法:先检测状态,再推荐下一步。检测脚本:bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-help/scripts/detect-state.sh [output-folder],默认输出目录 bmad-output/,打印工件清单、检测到的 track 与推断阶段。推荐脚本:bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-help/scripts/recommend-next.sh [output-folder],打印唯一的下一个技能、原因及被跳过的可选阶段。用平实语言向用户呈现,并提议调用推荐的技能;track 仍不明确时不要未经确认自动运行规划技能。若 project-context.md 不存在,则视为未初始化,建议先运行 bmad-init(或先走可选的 Analysis 用 bmad-product-brief)。
路由逻辑摘要:无 project-context.md → 建立项目上下文并确认 track;无 prd.md 且无 tech-spec.md → Quick Flow 用 bmad-tech-spec,BMad Method/Enterprise 用 bmad-prd;有 UI 且无 ux-design.md → bmad-ux;需要架构且无 architecture.md → bmad-architecture(Quick Flow 跳过架构);Enterprise 无安全/运维规划 → bmad-architecture;无 epics.md → bmad-epics-and-stories;无 stories/ 下故事文件 → bmad-epics-and-stories;故事存在但仍有 backlog/未 ready-for-dev → bmad-epics-and-stories,再 bmad-sprint-planning 排波次;全部就绪 → 交接完成,交给外部开发工具。Analysis 始终可选;UX 仅在项目有 UI 时推荐。
限制:只推荐一个下一技能;不在此产出规划文档;不推荐运行测试、构建、linter 或写代码;故事文件中的 Acceptance Criteria、Dev Notes、Testing 属锁定区,下游不得编辑;从 decision-log.md 读取已确认 track,缺失时先请用户确认。