23 KiB
23 KiB
BMad 帮助目录（中文版）
本文档由 _bmad/_config/bmad-help.csv 翻译并整理，便于中文读者检索 菜单码、技能 与用途。
技能调用方式（斜杠命令 / 自然语言等）以本机 npx bmad-method install 与 Cursor 集成为准。
表列说明
| 列 | 含义 |
|---|---|
| 码 | 菜单快捷码（不同模块下可能重复，以技能名列区分） |
| 显示名称 | CSV 英文显示名（与上游一致，便于对照） |
| 技能 | 技能标识 / 工作流名 |
| 说明 | 对「sequence」列的中文释义 |
| 阶段 | 工作流阶段或触发时机（anytime 等为随时） |
| 前置 | 建议先完成的技能或条件（CSV 中错位字段已尽量还原） |
| 必选 | 是否后期阶段强制项（true / false） |
| 产出 | 主要输出位置或产物类型（保留英文路径占位符） |
BMad 构建器
| 码 | 显示名称 | 技能 | 说明 | 阶段 | 前置 | 必选 | 产出 |
|---|---|---|---|---|---|---|---|
| BA | Build an Agent | bmad-agent-builder |
通过对话式梳理，创建、编辑或重建 Agent 技能。 | 随时 | bmad-agent-builder:quality-analysis | false | bmad_builder_output_folder / agent skill |
| AA | Analyze an Agent | bmad-agent-builder |
对既有 Agent 做质量分析：结构、内聚、提示词工艺与改进空间。 | 随时 | — | false | bmad_builder_reports / quality report |
| SB | Setup Builder Module | bmad-bmb-setup |
安装或更新 BMad Builder 模块配置与帮助条目。 | 随时 | — | false | {project-root}/_bmad / config.yaml and config.user.yaml |
| IM | Ideate Module | bmad-module-builder |
头脑风暴并规划 BMad 模块：创意、架构与构建计划。 | 随时 | bmad-module-builder:create-module | false | bmad_builder_reports / module plan |
| CM | Create Module | bmad-module-builder |
将模块基础设施脚手架化为可安装的 BMad 模块技能。 | 随时 | — | false | bmad_builder_output_folder / setup skill |
| VM | Validate Module | bmad-module-builder |
检查模块结构是否完整、准确，且能力均已正确注册。 | 随时 | — | false | bmad_builder_reports / validation report |
| BW | Build a Workflow | bmad-workflow-builder |
创建、编辑或重建工作流或工具型技能。 | 随时 | bmad-workflow-builder:quality-analysis | false | bmad_builder_output_folder / workflow skill |
| AW | Analyze a Workflow | bmad-workflow-builder |
对既有工作流/技能做质量分析：结构、效率与改进空间。 | 随时 | — | false | bmad_builder_reports / quality report |
| CW | Convert a Skill | bmad-workflow-builder |
将任意技能转换为符合 BMad 的成果导向形态，并生成前后对比 HTML 报告。 | 随时 | — | false | bmad_builder_reports / converted skill + comparison report |
BMad 方法
| 码 | 显示名称 | 技能 | 说明 | 阶段 | 前置 | 必选 | 产出 |
|---|---|---|---|---|---|---|---|
| WD | Write Document | bmad-agent-tech-writer |
详细描述需求，由代理按文档最佳实践撰写；可多轮对话并子流程做调研/审阅。 | 随时 | — | false | project-knowledge / document |
| US | Update Standards | bmad-agent-tech-writer |
若发现文档惯例缺失，把你的偏好写入代理记忆中的 documentation-standards.md。 | 随时 | — | false | _bmad/_memory/tech-writer-sidecar / standards |
| MG | Mermaid Generate | bmad-agent-tech-writer |
根据描述生成 Mermaid 图；未指定类型时会建议合适的图类。 | 随时 | — | false | planning_artifacts / mermaid diagram |
| VD | Validate Document | bmad-agent-tech-writer |
对照文档规范与最佳实践审查指定文档，按优先级给出可执行的改进建议。 | 随时 | — | false | planning_artifacts / validation report |
| EC | Explain Concept | bmad-agent-tech-writer |
为复杂概念撰写清晰技术说明，附示例与图示。 | 随时 | — | false | project_knowledge / explanation |
| BP | Brainstorm Project | bmad-brainstorming |
专家引导，使用一种或多种技法进行项目头脑风暴。 | 阶段 1 · 分析 | — | false | planning_artifacts / brainstorming session |
| IR | Check Implementation Readiness | bmad-check-implementation-readiness |
确保 PRD、UX、架构与 Epic/Story 彼此对齐。 | 阶段 3 · 方案设计 | bmad-create-epics-and-stories | true | planning_artifacts / readiness report |
| CR | Code Review | bmad-code-review |
故事循环：若有问题退回 DS；通过后进入下一 CS，或 Epic 完成时走 ER。 | 阶段 4 · 实现 | bmad-dev-story | false | — |
| CC | Correct Course | bmad-correct-course |
在重大变更时纠偏：可能建议重来、更新 PRD、重做架构/冲刺规划或修正 Epic 与 Story。 | 随时 | — | false | planning_artifacts / change proposal |
| CA | Create Architecture | bmad-create-architecture |
引导式产出技术决策文档（架构）。 | 阶段 3 · 方案设计 | — | true | planning_artifacts / architecture |
| CE | Create Epics and Stories | bmad-create-epics-and-stories |
在架构文档（CA）之后创建 Epic 与用户故事。 | 阶段 3 · 方案设计 | bmad-create-architecture | true | planning_artifacts / epics and stories |
| CP | Create PRD | bmad-create-prd |
专家引导完成产品需求文档（PRD）。 | 阶段 2 · 规划 | — | true | planning_artifacts / prd |
| CS | Create Story | bmad-create-story |
故事循环起点：准备冲刺计划中「下一个」待做 Story，或指定 Epic/Story。 | 阶段 4 · 实现 | bmad-create-story:validate | true | implementation_artifacts / story |
| VS | Validate Story | bmad-create-story |
在开发开始前校验 Story 是否就绪、完整。 | 阶段 4 · 实现 | bmad-dev-story | false | implementation_artifacts / story validation report |
| CU | Create UX | bmad-create-ux-design |
落实 UX 方案；若项目以 UI 为主，强烈建议使用。 | 阶段 2 · 规划 | bmad-create-prd | false | planning_artifacts / ux design |
| DS | Dev Story | bmad-dev-story |
故事循环：执行 Story 实现与测试，经 CR，如需修复回到 DS。 | 阶段 4 · 实现 | bmad-create-story:validate | true | — |
| DP | Document Project | bmad-document-project |
分析现有项目并产出可用文档。 | 随时 | — | false | project-knowledge / * |
| DR | Domain Research | bmad-domain-research |
行业领域深度研究、专业术语与知识沉淀。 | 阶段 1 · 分析 | — | false | planning_artifacts · project_knowledge / research documents |
| EP | Edit PRD | bmad-edit-prd |
在通过 PRD 校验流程后，编辑并改进指定路径的 PRD。 | 阶段 2 · 规划 | bmad-validate-prd | false | planning_artifacts / updated prd |
| GPC | Generate Project Context | bmad-generate-project-context |
扫描代码库生成精简、面向 LLM 的 project-context.md；棕地项目尤其重要。 | 随时 | — | false | output_folder / project context |
| MR | Market Research | bmad-market-research |
市场、竞品、客户需求与趋势分析。 | 阶段 1 · 分析 | — | false | planning_artifacts · project-knowledge / research documents |
| CB | Create Brief | bmad-product-brief |
引导式厘清产品创意与核心价值。 | 阶段 1 · 分析 | — | false | planning_artifacts / product brief |
| QA | QA Automation Test | bmad-qa-generate-e2e-tests |
为已实现代码生成自动化 API 与 E2E 测试；非代码评审或 Story 校验（请用 CR）。 | 阶段 4 · 实现 | bmad-dev-story | false | implementation_artifacts / test suite |
| Quick Dev | bmad-quick-dev |
统一「意图进、代码出」：澄清、实现、审阅与交付展示。 | 随时 | — | false | implementation_artifacts / spec and project implementation | |
| ER | Retrospective | bmad-retrospective |
可选：在 Epic 结束时回顾成果与经验，规划下一 Epic；重大问题考虑走 CC。 | 阶段 4 · 实现 | bmad-code-review | false | implementation_artifacts / retrospective |
| SP | Sprint Planning | bmad-sprint-planning |
启动实现阶段：生成实现代理将按序执行的冲刺计划。 | 阶段 4 · 实现 | — | true | implementation_artifacts / sprint status |
| SS | Sprint Status | bmad-sprint-status |
随时总结 Sprint 状态并路由到下一工作流。 | 阶段 4 · 实现 | bmad-sprint-planning | false | — |
| TR | Technical Research | bmad-technical-research |
技术可行性、架构选项与实现路径研究。 | 阶段 1 · 分析 | — | false | planning_artifacts · project_knowledge / research documents |
| VP | Validate PRD | bmad-validate-prd |
在创建 PRD（CP）之后校验 PRD 质量。 | 阶段 2 · 规划 | bmad-create-prd | false | planning_artifacts / prd validation report |
核心
| 码 | 显示名称 | 技能 | 说明 | 阶段 | 前置 | 必选 | 产出 |
|---|---|---|---|---|---|---|---|
| BSP | Brainstorming | bmad-brainstorming |
在创意早期或思路卡住时做头脑风暴。 | 随时 | — | false | {output_folder}/brainstorming / brainstorming session |
| DG | Distillator | bmad-distillator |
生成节省 token 的蒸馏文，保留供下游 LLM 使用的关键信息。 | — | — | adjacent to source document or specified output_path | distillate markdown file(s) |
| EP | Editorial Review - Prose | bmad-editorial-review-prose |
成稿后润色正文表达。 | — | — | report located with target document | three-column markdown table with suggested fixes |
| ES | Editorial Review - Structure | bmad-editorial-review-structure |
当文档由多段子流程拼成或结构需加强时，做结构性编辑审阅。 | — | — | report located with target document | — |
| BH | BMad Help | bmad-help |
判断当前所处 BMad 流程位置并回答问题；推荐下一步技能与调用方式。 | 随时 | — | false | — |
| ID | Index Docs | bmad-index-docs |
在不加载全部文件的前提下为目录生成/更新索引，便于掌握文档地图。 | 随时 | — | false | — |
| PM | Party Mode | bmad-party-mode |
编排多代理/多视角讨论与协作。 | 随时 | — | false | — |
| AR | Adversarial Review | bmad-review-adversarial-general |
在定稿前做对抗性质量审查；其他模块的代码审也可自动调用，亦适用于文档。 | — | — | — | |
| ECH | Edge Case Hunter Review | bmad-review-edge-case-hunter |
与对抗审搭配，从边界场景做正交补充，重方法而非「挑刺态度」。 | — | — | — | |
| SD | Shard Document | bmad-shard-doc |
当单份文档过大（常为 >500 行）时拆分为可管理片段。 | — | — | — |
创意智能套件（CIS）
| 码 | 显示名称 | 技能 | 说明 | 阶段 | 前置 | 必选 | 产出 |
|---|---|---|---|---|---|---|---|
| BS | Brainstorming | bmad-brainstorming |
用一种或多种技法主持头脑风暴会话。 | 随时 | — | false | output_folder / brainstorming session results |
| DT | Design Thinking | bmad-cis-design-thinking |
以同理心驱动的人本设计流程指导。 | 随时 | — | false | output_folder / design thinking |
| IS | Innovation Strategy | bmad-cis-innovation-strategy |
识别颠覆机会并设计商业模式创新。 | 随时 | — | false | output_folder / innovation strategy |
| PS | Problem Solving | bmad-cis-problem-solving |
运用系统化问题解决方法拆解复杂挑战。 | 随时 | — | false | output_folder / problem solution |
| ST | Storytelling | bmad-cis-storytelling |
用成熟叙事框架与技巧撰写故事/叙述。 | 随时 | — | false | output_folder / narrative/story |
游戏开发工作室（GDS）
| 码 | 显示名称 | 技能 | 说明 | 阶段 | 前置 | 必选 | 产出 |
|---|---|---|---|---|---|---|---|
| QP | Quick Prototype | bmad-gds-quick-prototype |
快速游戏原型，验证机制与创意。 | 随时 | — | false | — |
| BG | Brainstorm Game | gds-brainstorm-game |
在游戏语境下主持头脑风暴。 | 前期制作 | — | false | output_folder / brainstorming session |
| IR | Check Implementation Readiness | gds-check-implementation-readiness |
在投产前确保 GDD、UX、架构与 Epic/Story 对齐。 | 技术 | gds-create-epics-and-stories | true | planning_artifacts / readiness report |
| CR | Code Review | gds-code-review |
对标记为「待评审」的 Story 做干净上下文的 QA 代码审查。 | 制作 | gds-dev-story | false | — |
| CC | Correct Course | gds-correct-course |
游戏开发冲刺偏离路线时进行纠偏。 | 随时 | — | false | planning_artifacts / change proposal |
| CE | Create Epics and Stories | gds-create-epics-and-stories |
依据 GDD 需求创建 Epic 与 Story 列表，作为开发规格驱动。 | 技术 | gds-game-architecture | true | planning_artifacts / epics and stories |
| GB | Game Brief | gds-create-game-brief |
交互式游戏简报，引导用户明确游戏愿景。 | 前期制作 | — | false | output_folder / game brief |
| GDD | Game Design Document | gds-create-gdd |
撰写游戏设计文档 GDD：机制、系统、进度与实现指引。 | 设计 | — | false | planning_artifacts / gdd |
| ND | Narrative Design | gds-create-narrative |
为剧情向游戏撰写叙事文档：结构、人物弧与世界观。 | 设计 | gds-create-gdd | false | planning_artifacts / narrative design |
| CP | Create PRD | gds-create-prd |
从 GDD 或从零撰写 PRD，供 bmad-assist 等外部工具使用。 | 设计 | gds-create-gdd | false | planning_artifacts / prd |
| CS | Create Story | gds-create-story |
为开发代理准备上下文充分的 Story。 | 制作 | gds-sprint-planning | true | implementation_artifacts / story |
| CU | Create UX Design | gds-create-ux-design |
落实游戏 UX/UI；若 UI 是核心，强烈建议使用。 | 设计 | gds-create-gdd | false | planning_artifacts / ux design |
| DS | Dev Story | gds-dev-story |
执行 Dev Story：按任务与测试实现。 | 制作 | gds-create-story | true | — |
| DP | Document Project | gds-document-project |
分析现有游戏项目并产出文档。 | 随时 | — | false | project_knowledge / project documentation |
| DR | Domain Research | gds-domain-research |
游戏产业领域深度研究与术语沉淀。 | 前期制作 | — | false | planning_artifacts / research documents |
| ES | E2E Scaffold | gds-e2e-scaffold |
搭建 E2E 测试基础设施脚手架。 | 游戏测试 | gds-test-automate | false | — |
| EP | Edit PRD | gds-edit-prd |
改进并增强既有 PRD。 | 设计 | gds-validate-prd | false | planning_artifacts / updated prd |
| GA | Game Architecture | gds-game-architecture |
产出可伸缩游戏架构：引擎、系统、网络与技术设计。 | 技术 | — | true | planning_artifacts / game architecture |
| PC | Project Context | gds-generate-project-context |
生成适配所选智能体工具一致性的 project-context.md。 | 技术 | — | false | — |
| MR | Market Research | gds-market-research |
游戏市场、竞品与玩家需求分析。 | 前期制作 | — | false | planning_artifacts / research documents |
| PT | Performance Test | gds-performance-test |
设计性能测试策略。 | 游戏测试 | gds-playtest-plan | false | planning_artifacts / performance strategy |
| PP | Playtest Plan | gds-playtest-plan |
撰写结构化试玩/测试计划。 | 游戏测试 | gds-e2e-scaffold | false | planning_artifacts / playtest plan |
| QD | Quick Dev | gds-quick-dev |
兼顾游戏特性的灵活开发流程。 | 随时 | — | false | — |
| Quick Dev New Preview | gds-quick-dev-new-preview |
实验性一体化快捷流：单工作流内完成澄清、计划、实现、审阅与展示。 | 随时 | — | false | — | |
| TS | Quick Spec | gds-quick-spec |
小需求、小改动、简单应用/工具，无需冗长规划。 | 随时 | — | false | planning_artifacts / tech spec |
| ER | Retrospective | gds-retrospective |
在游戏开发 Epic 完成后组织团队回顾。 | 制作 | gds-code-review | false | implementation_artifacts / retrospective |
| SP | Sprint Planning | gds-sprint-planning |
由 Epic 文件生成或更新 sprint-status.yaml。 | 制作 | — | true | implementation_artifacts / sprint status |
| SS | Sprint Status | gds-sprint-status |
查看冲刺进度、暴露风险并给出下一步行动建议。 | 制作 | gds-sprint-planning | false | — |
| TR | Technical Research | gds-technical-research |
游戏引擎选项与实现路径的技术可行性研究。 | 前期制作 | — | false | planning_artifacts / research documents |
| TA | Test Automate | gds-test-automate |
生成自动化游戏测试。 | 游戏测试 | — | false | — |
| TD | Test Design | gds-test-design |
设计覆盖流程与质量要求的游戏测试场景。 | 技术 | gds-test-framework | false | planning_artifacts / test design |
| TF | Test Framework | gds-test-framework |
为 Unity / Unreal / Godot 等项目初始化游戏测试框架架构。 | 技术 | — | false | — |
| TR | Test Review | gds-test-review |
评审测试质量与覆盖。 | 游戏测试 | gds-performance-test | false | — |
| VP | Validate PRD | gds-validate-prd |
按外部工具兼容标准校验 PRD。 | 设计 | gds-create-prd | false | planning_artifacts / prd validation report |
测试架构企业版（TEA）
| 码 | 显示名称 | 技能 | 说明 | 阶段 | 前置 | 必选 | 产出 |
|---|---|---|---|---|---|---|---|
| TMT | Teach Me Testing | bmad-teach-me-testing |
TEA 学院：通过 7 次课讲授测试基础（含进度与证书相关产出）。 | 阶段 0 · 学习 | — | false | test_artifacts / progress file · session notes · certificate |
| AT | ATDD | bmad-testarch-atdd |
生成失败用例（TDD 红灯阶段）。 | 阶段 4 · 实现 | — | false | test_artifacts / atdd tests |
| TA | Test Automation | bmad-testarch-automate |
扩展自动化测试覆盖。 | 阶段 4 · 实现 | bmad-testarch-atdd | false | test_artifacts / test suite |
| CI | CI Setup | bmad-testarch-ci |
配置 CI/CD 质量流水线。 | 阶段 3 · 方案设计 | bmad-testarch-framework | false | test_artifacts / ci config |
| TF | Test Framework | bmad-testarch-framework |
初始化生产级测试框架脚手架。 | 阶段 3 · 方案设计 | bmad-testarch-test-design | false | test_artifacts / framework scaffold |
| NR | NFR Assessment | bmad-testarch-nfr |
非功能需求（NFR）评估。 | 阶段 4 · 实现 | bmad-testarch-automate | false | test_artifacts / nfr report |
| TD | Test Design | bmad-testarch-test-design |
基于风险的测试规划。 | 阶段 3 · 方案设计 | — | false | test_artifacts / test design document |
| RV | Test Review | bmad-testarch-test-review |
质量审计（0–100 分制）。 | 阶段 4 · 实现 | bmad-testarch-automate | false | test_artifacts / review report |
| TR | Traceability | bmad-testarch-trace |
覆盖度可追溯与质量门禁决策。 | 阶段 4 · 实现 | bmad-testarch-test-review | false | test_artifacts / traceability matrix · gate decision |
网页设计工作室（WDS）
| 码 | 显示名称 | 技能 | 说明 | 阶段 | 前置 | 必选 | 产出 |
|---|---|---|---|---|---|---|---|
| AD | Agentic Development | bmad-wds-agentic-development |
带设计日志与浏览器验证的迭代「构建—验证」循环。 | WDS · 构建/验证 | bmad-wds-design-delivery | false | _progress/agent-experiences / experience-documents |
| AS | Alignment & Signoff | bmad-wds-alignment |
干系人共识 pitch 与服务协议；若做自有产品可跳过。 | WDS · 宣讲/对齐 | — | false | design_artifacts/A-Product-Brief / pitch service-agreement signoff |
| CS | Conceptual Sketching | bmad-wds-conceptual-sketching |
详细规格前的快速视觉草图探索；直接场景可跳过。 | WDS · 设计 | bmad-wds-outline-scenarios | false | design_artifacts/C-UX-Scenarios / sketches |
| SP | Conceptual Specifications | bmad-wds-conceptual-specs |
逐页逐元素记录设计决策，开发可直接据此实现。 | WDS · 设计 | bmad-wds-outline-scenarios | true | design_artifacts/C-UX-Scenarios / page-specs scenario-specs |
| DD | Design Delivery | bmad-wds-design-delivery |
校验规格完整并打包为 DD yaml，供开发交接。 | WDS · 设计 | bmad-wds-conceptual-specs | true | design_artifacts/E-PRD/Design-Deliveries / delivery-package acceptance-criteria |
| DS | Design System | bmad-wds-design-system |
管理组件库与设计令牌；设计系统模式为「无」时跳过。 | WDS · 设计 | bmad-wds-functional-components | false | design_artifacts/D-Design-System / components/ design-tokens.md |
| FREYA | Wake Freya | bmad-wds-freya |
第 3–4 阶段 UX 设计师代理 Freya：检查前置条件并给出下一步。 | WDS · 唤醒代理 | — | false | — |
| FI | Functional Components | bmad-wds-functional-components |
从规格抽取可复用模式为组件定义；无设计系统时跳过。 | WDS · 设计 | bmad-wds-conceptual-specs | false | design_artifacts/C-UX-Scenarios / component-candidates |
| IDUN | Wake Idun | bmad-wds-idun |
治理代理 Idun：访谈组织以配置 Agent Space 与权限模型。 | WDS · 唤醒代理 | — | false | — |
| OS | Outline Scenarios | bmad-wds-outline-scenarios |
以「人设 + 目标 + 结果」定义用户旅程，并与触发图驱动力关联。 | WDS · 设计 | bmad-wds-trigger-mapping | true | design_artifacts/C-UX-Scenarios / scenario-overview.md |
| PR | Platform Requirements | bmad-wds-platform-requirements |
平台、设备、集成与约束等技术边界；简单落地页可跳过。 | WDS · 策略 | bmad-wds-project-brief | false | design_artifacts/A-Product-Brief / platform-requirements.md |
| PE | Product Evolution | bmad-wds-product-evolution |
持续改进：反馈 → 触发图 → 规格 → 代码 → 验证。 | WDS · 构建/验证 | bmad-wds-usability-testing | false | design_artifacts / updated-artifacts |
| PB | Project Brief | bmad-wds-project-brief |
定义产品愿景、定位与成功标准，设计决策应可追溯至此。 | WDS · 策略 | — | true | design_artifacts/A-Product-Brief / project-brief.md |
| SAGA | Wake Saga | bmad-wds-saga |
第 1–2 阶段战略分析师代理 Saga：扫描仓库并建议下一步。 | WDS · 唤醒代理 | — | false | — |
| SB | Storyboarding | bmad-wds-storyboarding |
跨界面串联用户旅程与入口、过渡、异常路径；简单场景可跳过。 | WDS · 设计 | bmad-wds-outline-scenarios | false | design_artifacts/C-UX-Scenarios / storyboards |
| TM | Trigger Mapping | bmad-wds-trigger-mapping |
将业务目标映射到用户心理：人设、功能与驱动力打分。 | WDS · 策略 | bmad-wds-project-brief | true | design_artifacts/B-Trigger-Map / trigger-map.md personas/ feature-impact-analysis.md |
| AT | Acceptance Testing | bmad-wds-usability-testing |
在真实用户环境中做可用性测试与回顾式出声思考。 | WDS · 构建/验证 | bmad-wds-agentic-development | false | design_artifacts/F-Testing / test-results findings |
| VD | Visual Design | bmad-wds-visual-design |
将规格转为带样式的 HTML 原型，可与 Figma 往返。 | WDS · 设计 | bmad-wds-conceptual-specs | false | design_artifacts/C-UX-Scenarios / html-prototypes visual-designs |
生成脚本：scripts/render_bmad_help_zh_cn.py（修改译文表后重新运行以更新本文档。）