如何把 BMAD-METHOD 从 v4 升级到 v6清理旧目录并迁移规划产物【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD如果你的项目里还装着 BMad v4安装目录通常叫.bmad-method而你已经写好了规划文档或进行中的开发工作这篇文章给出从 v4 迁移到 v6 的完整路径用npx bmad-method install安装程序识别并清理旧目录把规划产物Brief/PRD/UX/Architecture迁移到 v6 的_bmad-output/planning-artifacts/目录最后用bmad-help验证迁移结果。适用前提来自 升级指南Node.js 20.12安装程序必需现有 BMad v4 安装项目里有要保留的规划产物或进行中的开发工作开始之前先做一件事如果仓库里还有未提交的重要变更先完成提交或备份再执行升级。1. 运行安装程序在项目根目录执行npx bmad-method install安装程序会自动检测现有安装。v4 会被识别出来安装程序提供迁移辅助。完整的交互流程选择安装位置、AI 工具、模块见安装说明如果安装的是预发布版本则改用npx bmad-methodnext install。判断是否正常的标准安装结束时安装程序会显示BMAD is ready to use!并给出 BMad 的安装路径如有未处理的警告也会一并列出。缺失uv只产生警告、不阻断安装但依赖uv的技能在补装uv之前无法使用。2. 处理旧的 v4 安装目录当安装程序检测到 v4 时你有两种处理方式允许安装程序自动备份并删除.bmad-method先退出安装流程之后手动清理旧目录注意一个例外如果你把 BMad Method 目录改成了其他名字安装程序无法自动处理需要你自己手动定位并删除。3. 清理 IDE 命令与技能目录v4 的 IDE 命令/技能不会随安装程序自动清除需要手动删除。以 Claude Code 为例到.claude/commands/目录下删除所有以bmad开头的嵌套目录。v6 的新技能会安装到.claude/skills/两个目录用途不同不要混淆。这一步的意义如果遗留了旧版bmad-*条目你的 AI 工具可能会同时显示新旧两套重复命令删除后重复现象消失。4. 迁移规划产物已有规划文档Brief/PRD/UX/Architecture的情况把这些文档移动到_bmad-output/planning-artifacts/并使用可读的文件名PRD 文档的文件名包含PRD其他文档按类型包含brief、architecture或ux-design分片文档可以放在命名清晰的子目录中规划仍在进行中的情况文档建议直接用 v6 工作流重启规划把现有文档作为输入而不是强行搬运半成品文档。5. 迁移进行中的开发工作可选分支只有在你已经创建或实现了部分用户故事story时才需要这一步完成 v6 安装将epics.md或epics/epic*.md放入_bmad-output/planning-artifacts/运行 Developer 的bmad-sprint-planning工作流告知智能体哪些史诗/故事已经完成没有进行中的故事时跳过此节不影响升级结果。迁移后的目录结构升级完成后项目呈现 v6 统一结构your-project/ ├── _bmad/ # 单一安装目录 │ ├── _config/ # 你的自定义配置 │ │ └── agents/ # 智能体自定义文件 │ ├── core/ # 通用核心框架 │ ├── bmm/ # BMad Method 模块 │ ├── bmb/ # BMad Builder │ └── cis/ # Creative Intelligence Suite └── _bmad-output/ # 输出目录v4 时代常见为 doc 目录几个容易踩坑的旧名/新名差异概念v4旧v6新迁移提示核心框架_bmad-core实际上承载的是 BMad Method_bmad/core/变成通用框架层迁移时不要再把_bmad/core/当成 Method 本体方法模块_bmad-method_bmad/bmm/旧脚本、路径引用需同步更新到bmm配置方式直接改模块文件每个模块通过config.yaml管理优先改配置不要直接改生成文件文档读取需要手动区分分片/非分片自动扫描完整文档与分片入口只有在兼容性场景下才建议手动分片另外如果你之前装过这些 v4 模块升级后它们的去向是v4 模块v6 状态.bmad-2d-phaser-game-dev已集成到 BMGD 模块.bmad-2d-unity-game-dev已集成到 BMGD 模块.bmad-godot-game-dev已集成到 BMGD 模块.bmad-infrastructure-devops已弃用 — 新的 DevOps 智能体即将推出.bmad-creative-writing未适配 — 新的 v6 模块即将推出依赖后两个模块的工作流在升级后不可用规划后续工作时需要留意。验证升级结果按 升级指南 给出的后续建议做三件事运行bmad-help确认可用工作流与下一步建议——如果 AI 工具能识别并运行该技能说明工具集成正常如果是既有项目补充或更新project-context.md减少后续实现偏差参考管理项目上下文在继续开发前先做一次关键链路验证安装、命令触发、文档读取bmad-help会确认安装正常工作、列出已安装模块的可用内容并推荐第一步操作遇到报错时把安装程序输出交给 AI 助手处理即可。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考