告别命令焦虑：BMAD-METHOD AI代理交互速查手册
项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD 你是否还在为记不住复杂的AI代理命令而烦恼？是否经常在执行关键操作时因指令错误而中断工作流？本文将系统梳理BMAD-METHOD框架的核心交互命令，通过直观示例和场景化说明，帮你10分钟内掌握高效操作技巧，让AI代理真正成为生产力助手而非障碍。
基础环境准备
在开始使用BMAD-METHOD的命令系统前，需确保已完成基础环境配置。通过以下命令克隆官方仓库并安装核心依赖：
git clone https://gitcode.com/gh_mirrors/bm/BMAD-METHOD
cd BMAD-METHOD
npm install
项目核心命令入口位于tools/cli/bmad-cli.js，该文件负责加载所有命令模块并处理用户输入。通过node tools/cli/bmad-cli.js --help可随时查看完整命令列表。
核心命令速查表
安装与配置类命令
| 命令 | 功能描述 | 关键选项 | 适用场景 |
|---|---|---|---|
bmad install | 安装核心代理与模块 | --directory 指定安装路径 | 首次部署或添加新模块 |
bmad update | 更新现有安装 | --force 强制覆盖修改文件 | 版本升级或修复问题 |
bmad uninstall | 移除BMAD环境 | --force 跳过确认提示 | 完全清理或重装系统 |
安装命令tools/cli/commands/install.js支持四种操作模式：常规安装、代理编译、快速更新和重新安装。其中快速更新模式会保留用户配置，特别适合生产环境：
# 快速更新所有模块（保留配置）
bmad install --quick-update
状态查询与管理
bmad status命令提供当前系统的完整状态视图，包括安装路径、版本信息、已安装模块和配置的IDE列表。示例输出：
📊 BMAD Installation Status
Location: /data/projects/bmad
Version: 6.2.1
Core: ✓ Installed
Modules:
✓ bmb (v2.1.0)
✓ bmd (v3.4.2)
✓ cis (v1.8.5)
Configured IDEs:
✓ VS Code
✓ WebStorm
该命令实现于tools/cli/commands/status.js，通过解析安装目录下的元数据文件生成状态报告，是排查系统问题的首要工具。
模块管理命令
bmad list命令会扫描src/modules/目录并列出所有可用模块，包括模块ID、描述和版本信息。输出示例：
📦 Available BMAD Modules:
bmb
BMAD Builder Module - Agent workflow construction tools
Version: 2.1.0
bmd
BMAD Documentation Module - Automated documentation generation
Version: 3.4.2
模块元数据存储在每个模块目录下的install-config.yaml文件中，通过修改此文件可自定义模块属性。
高级操作技巧
命令组合使用范例
在实际开发中，常需组合使用多个命令完成复杂任务。例如，以下工作流实现"更新文档模块并验证状态"的完整流程：
# 更新文档模块
bmad update --module bmd --force
# 验证安装状态
bmad status
# 重新编译文档代理
bmad install --compile --only-agent doc-keeper
常见问题诊断
当命令执行异常时，可按以下步骤排查：
- 检查基础依赖：
npm ls确认所有包已正确安装 - 验证配置文件：
cat bmad/_cfg/manifest.yaml检查核心配置 - 查看日志文件：
tail -n 50 logs/bmad-cli.log分析错误详情
特别注意，修改核心模块后需执行bmad install --compile重新编译代理定义，否则更改不会生效。
实战场景应用
团队协作环境配置
在多人协作场景中，管理员可通过以下命令标准化开发环境：
# 列出可用模块
bmad list
# 安装团队标准模块集
bmad install --modules bmb,bmd,cis --directory /opt/bmad
# 验证所有成员环境一致性
bmad status --export > environment-report.txt
紧急故障恢复
当系统出现严重问题时，可通过组合命令快速恢复：
# 备份当前配置
cp -r bmad/_cfg ~/bmad-config-backup
# 强制更新核心系统
bmad update --force
# 恢复用户配置
cp ~/bmad-config-backup/*.yaml bmad/_cfg/
# 重新编译所有代理
bmad install --compile
命令扩展与定制
BMAD-METHOD支持通过tools/cli/commands/目录添加自定义命令。只需创建遵循相同模块结构的JS文件，系统会自动发现并加载新命令。例如，创建tools/cli/commands/deploy.js可添加自定义部署命令。
官方文档docs/BMad-Method-V6-Quick-Start.md提供了完整的命令开发指南，包括参数解析、错误处理和用户交互最佳实践。
总结与进阶学习
本文介绍的命令覆盖了80%的日常操作需求，完整命令列表可通过bmad --help查看。建议将本文收藏为速查手册，同时深入学习以下资源持续提升：
- 官方教程：README.md
- 高级命令技巧：docs/installers-bundlers/web-bundler-usage.md
- 命令开发指南：CONTRIBUTING.md
掌握这些命令不仅能提高日常操作效率，更能帮助你深入理解BMAD-METHOD的架构设计理念。下一篇我们将探讨模块开发与代理定制的高级技巧，敬请关注。
提示：定期执行
bmad update保持系统最新，获取持续优化的命令体验和新功能支持。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
