SuperAPI AI 工具集

bmad-init

智能体与模型

查看项目

更新于 10-15 19:53

技能介绍

用途:为 BMAD 规划流程初始化工作区,并选择决定后续工作流规模的 TRACK。属于规划类技能,只创建文件夹和种子文档,不会编写应用代码、运行测试或构建。

主要产物(默认输出目录 bmad-output/):config.yaml(项目名、track、输出路径、语言)、decision-log.md(空的线程化决策日志,后续工作流中增长)、project-context.md(项目“宪法”,供后续所有技能加载)、stories/(空目录,存放后续故事文件)。config.yaml 是其他技能查找输出目录和所选 track 的唯一事实来源。

三种 TRACK(不使用编号 Level):Quick Flow 适用于 1–15 个故事,仅产出 tech-spec;BMad Method 适用于 10–50+ 个故事,产出 PRD + 架构(可选 UX);Enterprise 适用于 30+ 个故事,产出 PRD + 架构 + 安全 + DevOps 规划。track 是规划需求决策而非点数或速度决策,故事数量只是粗略信号,应以范围、跨团队协作和风险驱动;启发式可给默认建议,但由用户确认。

工作流:先检查已有工作区,查找 bmad-output/config.yaml(或用户指定的自定义输出目录);若存在则读取并询问保留、幂等重跑(安全,保留现有文件)或更改 track,不得覆盖已有内容的 decision-log.md 或 project-context.md。然后对话式收集粗略范围信号(一句话项目描述、大致故事数量、单团队或多团队、是否有硬性合规/安全/基础设施要求)。建议 track:运行 bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/select-track.sh" --stories <N> --teams <one|many> --compliance <yes|no>,输出三个 track 与建议默认值,由用户确认或覆盖。启发式:合规/基础设施为 yes 或 30+ 故事 → Enterprise;10+ 故事或明确需要 PRD/架构 → BMad Method;否则 → Quick Flow。用户确认名称和 track 后运行 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。接着引导填写 project-context.md 的前几节(项目目标、主要用户、约束、非目标),并把 track 选择及理由记录为 decision-log.md 的首条条目。最后按 track 交接:Quick Flow → tech-spec,然后 sprint-planning/故事创建;BMad Method → product brief → PRD → 架构;Enterprise → product brief → PRD → 架构(加安全与 DevOps 规划)。

三种意图:Create 创建新工作区(常见情况);Update 更改 track 或重命名项目,编辑 config.yaml 并在 decision-log.md 追加带日期和原因的变更,不擦除其他文件;Validate 校验工作区是否规范,运行 bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/init-project.sh" --validate --output "bmad-output"。

限制:不出现编号 Level,只用三个命名 track;不使用故事点、速度、燃尽图,交付按数量统计(剩余故事/完成率);故事规模目标为单个代理会话可完成(约 2–8 小时),更大需拆分。该技能止于脚手架,交接给其他规划技能,绝不实现、测试、lint 或构建。更多配置架构、track 决策细节和 project-context 章节指南见 REFERENCE.md。属于 BMAD Planning & Orchestrator 插件,实现 bmad-init 精神,方法论归功于 BMAD Code Organization(https://github.com/bmad-code-org/BMAD-METHOD)。