bmad-builder

用途：BMAD Builder 是 BMAD Planning & Orchestrator 插件中的元技能（meta-skill），用于从零搭建、校验和生成自定义的规划/编排技能。它产出合规的 SKILL.md、shell 脚本与模板，并预设好该插件的路径约定；同时运行范围违规检查，防止新技能越过 PLAN/ORCHESTRATE 边界。适用范围：只做规划，不做构建。它产出规划产物和技能骨架文件，不写应用代码、不跑测试、不 lint、不检查覆盖率、不执行构建。若某个被设计技能试图“实现”“修复代码”“运行测试套件”或“审查 diff”，即视为范围违规，应改为规划并交接。三种意图：创建、校验、仅搭建骨架。开始前必须先确认属于哪种意图。创建：收集需求（用 TodoWrite 跟踪），包括技能名（小写连字符、以 bmad- 前缀）、解决的规划/编排问题、触发短语、允许工具（Read、Write、Edit、Bash、Glob、Grep、WebSearch、WebFetch、TodoWrite 的子集）、适用 BMAD 轨道（Quick Flow / BMad Method / Enterprise）、上游 BMAD 对应物（如 bmad-risk-assessment）。运行搭建脚本：bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/scaffold-skill.sh <skill-name>，生成 skills/<skill-name>/ 及 scripts/、templates/ 子目录和初始 SKILL.md。参考 ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/templates/skill.template.md 填写 SKILL.md，正文控制在 5K token 以内，超长内容放到同目录的 REFERENCE.md；所有路径用 ${CLAUDE_PLUGIN_ROOT}；产物默认放到 bmad-output/；结尾附强制署名脚注。随后校验：bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/validate-skill.sh ${CLAUDE_PLUGIN_ROOT}/skills/<skill-name>/SKILL.md，修复所有错误并复查警告。校验：对任意 SKILL.md 路径直接运行 validate-skill.sh，检查 name 字段存在且为小写连字符、description 含触发短语、allowed-tools 存在（缺失仅警告）、allowed-tools 与正文无开发/lint/构建/覆盖率类范围违规、文件大小在约 5K token（约 20KB）目标内、存在署名脚注。仅搭建：只生成目录骨架不生成内容，之后手动按模板填写。范围法则：插件只规划与编排，绝不写应用代码、跑测试、lint、查覆盖率、构建或审查已实现代码；任何技能最后产物只能是 ready-for-dev 故事文件或交接清单，实现交外部开发工具/插件。验收标准、测试策略、开发笔记属于规划，允许；执行测试或写实现代码超出范围。validate-skill.sh 通过标记违禁词自动强制执行。BMAD 一致性要点：轨道为 Quick Flow / BMad Method / Enterprise，由用户交互确认；故事规模约 2-8 小时、最多一个开发日，超出则拆分；交付跟踪用剩余故事数/完成率，不用 Fibonacci 点、速度或燃尽图；故事名格式 {epic}.{story}.{slug}.story.md；状态流转 backlog → ready-for-dev → in-progress → review → done；决策贯穿 decision-log.md；项目章程 project-context.md 跨技能加载；适用处用创建/更新/校验三种意图。脚本：scaffold-skill.sh <name> 创建目录；validate-skill.sh <SKILL.md> 校验前言、范围、大小与署名脚注；用 ${CLAUDE_PLUGIN_ROOT} 前缀调用，编排器会标记脚本可执行，也可用 bash 运行。模板：skill.template.md 用于新规划/编排 SKILL.md 骨架；document.template.md 用于通用规划文档（PRD 章节、简报、规格章节等）。并行创建完整技能包时的子代理策略：Agent 1 依据需求起草 SKILL.md 正文；Agent 2 写领域脚本（校验器、清单）；Agent 3 写领域模板；Agent 4 在正文超过 5K token 时写 REFERENCE.md。协调方式：先串行收集需求，把规格写入 bmad-output/skill-spec.md，再并行展开；主上下文用 validate-skill.sh 校验全部产出并组装最终包。面向 LLM 的说明：用 TodoWrite 跟踪已创建组件；绝不创建含测试运行器、linter、覆盖率工具、构建命令或 diff/代码审查步骤的技能，validate-skill.sh 会标记这些；SKILL.md 结尾必须附署名脚注块（模板已原样包含）；正文保持 5K token 以内，长篇模式放 REFERENCE.md；内部路径统一用 ${CLAUDE_PLUGIN_ROOT}，绝不硬编码 ~/.claude 或绝对机器路径；非技能类产物默认放到 bmad-output/。本技能属于 BMAD Planning & Orchestrator 插件，是 BMAD Code Organization 的 BMAD Method 的 Claude Code 载体，实现 bmad-bmb-builder 的精神，方法论署名归 BMAD Code Organization。