用途：把用户意图转换为放置在 {project-root}/_bmad/custom/ 下的 TOML 覆盖文件，用于定制可配置的 BMad 智能体或工作流技能。
主要能力：v1 范围包括按技能的 [agent] 覆盖（bmad-agent-<role>.toml / .user.toml）和按技能的 [workflow] 覆盖（bmad-<workflow>.toml / .user.toml）。中央配置 {project-root}/_bmad/custom/config.toml 不在范围内，需引导用户查看 How to Customize BMad 指南。若目标 customize.toml 未暴露用户所需字段，应直接说明，不得虚构字段。
流程与用法：先做预检，无 {project-root}/_bmad/ 则提示未安装，可先运行 npx skills add bmad-code-org/BMAD-METHOD --skill bmad；缺少 resolve_customization.py 仍可继续，但验证回退为手动合并。随后分类意图：定向、探索、审计/迭代、跨切面。探索或审计时运行 uv run {skill-root}/scripts/list_customizable_skills.py --project-root {project-root}，可用 --extra-root <path> 指定额外安装位置。阅读目标的 customize.toml 确定 surface，跨切面意图在智能体与工作流两个 surface 间与用户确认。用简洁 TOML 表达改动，标量覆盖优先，数组追加，带键的数组按 key 合并。团队文件 {skill-name}.toml 提交，个人文件 {skill-name}.user.toml 忽略。写入前展示完整 TOML 及 diff，等待明确确认，再写入并运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill <install-path> --project-root {project-root} --key <agent-or-workflow> 验证，展示合并输出。失败时可手工合并 base → team → user。
适用场景与限制：适合需要改 persona、沟通风格、模板、输出路径、菜单或持久事实等的用户。步骤逻辑、顺序等未暴露行为无法覆盖，只能建议 activation_steps_prepend/append 或 persistent_facts 近似实现，或推荐 bmad-workflow-builder。没有 customize.toml 的技能不可定制。完成条件为覆盖文件已写入、用户已查看解析结果、用户已确认摘要。