用途：为仓库生成一份可验证的智能体指令块，写入 AGENTS.md 的标记之间。用户提供治理、安全、规范等规则，仓库提供其余可验证事实。全程对话式，每次写入均需用户批准。
主要能力：支持 setup（建立）、adopt（采纳已有指令文件）、refresh（刷新已有受管块）、record（记录智能体错误）、audit（重新验证与精简）五种意图。使用账本逐条记录既有指令的去向：保留、重写、迁移、自动化或删除，并附证据、理由与风险。
使用方式：激活时先解析定制配置：uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow。若脚本不存在说明 BMad 未设置，可先安装：npx skills add bmad-code-org/BMAD-METHOD --skill bmad。之后读取 references/best-practices.md 与 references/template.md，检测意图，扫描配置、CI、源码与历史，只就扫描无法回答的缺口访谈用户，展示完整指令块与账本后再写入。写入只发生在标记之间，不提交代码。
适用场景：需要让 AI 智能体在特定仓库中遵循团队规则时；采纳已有 CLAUDE.md 等指令文件时；刷新老化指令、记录反复出错、审计指令有效性时。
限制：涉及规则仅来自本资料，具体命令、路径、环境依赖以实际仓库为准；缺少的定制脚本或 BMad 环境需先设置；是否支持某工具链未在资料中说明。