用途:为代码仓库生成一小段经核验的智能体指令,写入 AGENTS.md 的受管标记块内,让 AI 智能体在该仓库中更好工作。用户提供治理、安全、规范等规则,仓库提供其余可核验信息。
主要能力:支持 setup(仓库无有效指令文件时建立)、adopt(文件有内容但无受管块时迁移采纳)、refresh(已有受管块时刷新)、record(记录观察到的智能体错误)、audit(重新核验与精简)五种意图。流程包括评估报告并建立台账、询问用户规则与外部文档、通过并行子代理发现并核验事实、面谈扫描无法覆盖的空白、展示完整块后再写入、收尾说明。
使用方式:需指定 intent、目标仓库或路径,以及额外的来源路径或 URL。裸路径与 {skill-root} 从技能安装目录解析,{project-root} 指项目工作目录。激活时通过 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow 解析自定义配置,失败则读取 customize.toml 默认值;若存在 _bmad 目录则运行 uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root}。刷新时读取来源行的 SHA,运行 git log --diff-filter=DR --name-only 比对。
限制与约束:任何时候都不提交代码;写入前必须先展示完整块与台账并获得批准;删除须满足最佳实践文档中的四类依据之一;路径与命令声明须逐一核验;不得向用户询问扫描可回答的问题;子文件拆分须满足全部条件并经验证加载机制。收费、价格、平台与效果等资料未提供。