mcpField
B
bmad-init

bmad-init

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

关于 bmad-init

bmad-init 用于初始化 BMAD 规划工作区，面向需要为项目选择规划轨道并建立基础文档的团队。它支持 Quick Flow、BMad Method 和 Enterprise 轨道，并保留已有文档内容。

主要功能

  1. 01创建规划工作区目录
  2. 02生成配置与种子文档
  3. 03选择三种规划轨道
  4. 04验证或更新工作区

适用场景

  1. 01为新项目初始化规划空间
  2. 02根据项目范围选择规划轨道
  3. 03验证已有工作区结构

安装

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

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

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

包含的文件

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

REFERENCE.md
scripts/
init-project.sh
select-track.sh
templates/
config.template.yaml
decision-log.template.md
project-context.template.md

详细介绍

BMAD Init — 工作区脚手架

设置规划工作区，并选择决定其余 BMAD 规划工作流规模的 TRACK。这是一项规划技能：它只会创建文件夹和初始文档，不会编写应用程序代码、运行测试或构建任何内容。

生成内容

在配置的输出文件夹下（默认为 bmad-output/）：

bmad-output/
├── config.yaml          # project name, track, output paths, languages
├── decision-log.md      # empty threaded decision log (grows across workflows)
├── project-context.md   # the project "constitution" loaded by every later skill
└── stories/             # empty; future story files land here

config.yaml 是唯一事实来源，其他技能会读取它来查找输出文件夹和所选轨道。

三种 TRACK（绝不编号为等级）

轨道故事数量规划工件
Quick Flow1–15 个故事仅 tech-spec
BMad Method10–50+ 个故事PRD + Architecture（+ 可选 UX）
Enterprise30+ 个故事PRD + Architecture + Security + DevOps 规划

轨道选择取决于规划需求，而非点数或速度。故事数量只是粗略信号；应根据范围、跨团队协调和风险来决定。启发式规则可以建议默认选项，但始终由用户确认。

工作流

  1. 检查是否已有工作区。 搜索 bmad-output/config.yaml（或用户指定的自定义输出文件夹）。如果存在，读取它并询问是保留、幂等地重新运行（安全——现有文件会保留），还是更改轨道。不要覆盖已有内容的 decision-log.md 或 project-context.md。

  2. 在对话中收集大致的范围信号（不要盘问）：

    • 一句话描述项目。
    • 大致有多少个不同的工作项或故事？（可以给出范围）
    • 有多个团队，还是只有一位构建者？
    • 是否有强制的合规、安全或基础设施要求？

  3. 建议轨道。 运行辅助程序，打印三种轨道和建议的默认选项，然后说明你的建议并请用户确认或改选：

    bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/select-track.sh" --stories <N> --teams <one|many> --compliance <yes|no>

    辅助程序使用的启发式规则（你可以结合实际情况灵活判断）：

    • 合规/基础设施 = 是，或 30+ 个故事 → Enterprise
    • 10+ 个故事，或显然需要 PRD/架构 → BMad Method
    • 其他情况 → Quick Flow

  4. 搭建脚手架。 用户确认名称和轨道后，运行：

    bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/init-project.sh" \
  --name "<project name>" \
  --track <quick-flow|bmad-method|enterprise> \
  --output "bmad-output"

    脚本是幂等的：它会创建缺失的文件夹并填充缺失的模板文件，但如果 decision-log.md 或 project-context.md 已有内容，则绝不会覆盖。它始终会（重新）写入 config.yaml。

  5. 打开章程。 引导用户填写 project-context.md 的前几个部分（项目目标、主要用户、约束、非目标）。这是所有下游技能都会加载的文档，因此在这里写几句翔实的内容会很有帮助。将所选轨道及其理由记录为 decision-log.md 的第一条记录。

  6. 交接。 根据轨道推荐下一步规划：

    • Quick Flow → tech-spec，然后进行 sprint-planning / 创建故事。
    • BMad Method → product brief → PRD → architecture。
    • Enterprise → product brief → PRD → architecture（+ 安全和 DevOps 规划）。

三种意图

  • 创建 — 新建工作区（最常见的情况）。
  • 更新 — 更改轨道或重命名项目：编辑 config.yaml，并将变更及日期和原因追加到 decision-log.md。不要清除其他文件。
  • 验证 — 确认工作区格式正确： 
    bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/init-project.sh" --validate --output "bmad-output"

护栏

  • 任何地方都不得出现编号等级——只能使用三个命名轨道。
  • 不使用故事点、速率或燃尽图。交付采用基于数量的度量（剩余故事数／完成率）。故事的规模目标：小到可在一个 Agent 会话中完成（约 2–8 小时）；更大的故事都要拆分。
  • 此技能止步于脚手架搭建。它会移交给其他规划技能；不会实施、测试、检查代码风格或构建。

完整的配置架构、轨道决策详情和项目上下文章节指南，请参阅 REFERENCE.md。

属于 BMAD Planning & Orchestrator 插件——由 BMAD Code Organization 提供、适用于 BMAD Method 的 Claude Code 框架（https://github.com/bmad-code-org/BMAD-METHOD）。其实现体现了 bmad-init 的理念。所有方法论的荣誉均归于 BMAD Code Organization。

评论

支持 Markdown