Appearance
Everything Claude Code Dart Build Resolver Agent 是专为 Dart 和 Flutter 项目构建、分析及依赖冲突修复而设计的专业代理。它能自动诊断并修复 dart analyze、Flutter 编译失败、pub 依赖冲突和 build_runner 相关问题，采用“最小、精准、可验证”的修复策略，避免不必要的代码改动。相比直接让 Claude 回答构建错误，它能高效、批量、结构化地处理复杂错误链，显著提升 AI 编程助手在 Dart/Flutter 生态下的生产力和稳定性。
Everything Claude Code Dart Build Resolver：dart analyze、Flutter 编译与 pub 依赖冲突修复
Dart/Flutter 项目的构建和依赖管理复杂且易出错，尤其在团队协作、依赖升级或多平台支持（Android/iOS/Web）场景下，常见的 dart analyze 报错、Flutter 编译失败、pub 依赖冲突、build_runner 代码生成异常等问题，往往会严重阻碍开发进度。Everything Claude Code Dart Build Resolver Agent 正是为了解决这些痛点而生，它是 Everything Claude Code 完全指南 中 38 个专业 Agent 之一，专注于 Dart/Flutter 构建问题的自动诊断与精准修复。
一、Dart Build Resolver Agent 是什么？解决什么问题？
Dart Build Resolver Agent 是 ECC Agent 体系下专门负责 Dart 和 Flutter 构建、分析及依赖错误修复的自动化专家代理。它的核心目标是：
- 自动诊断并修复 dart analyze、flutter analyze 产生的类型、null safety、导入、未实现接口等错误
- 精准处理 pubspec.yaml 依赖冲突、版本约束矛盾、pub get/pub upgrade 异常
- 解决 build_runner 代码生成失败、.g.dart 文件过期、依赖缺失等问题
- 应对 Flutter 平台相关（Android Gradle、iOS CocoaPods、Web 构建）常见编译错误
- 始终采用“最小变更”原则，只修复错误本身，不做无关重构或风险改动
与直接让 Claude 或其他 AI 助手分析构建日志不同，Dart Build Resolver Agent 内置了专业的诊断与修复流程，能批量处理复杂错误链、避免误判和无效建议，并严格保证修复的可验证性和最小侵入性。
二、核心能力与适用场景
1. 能力范围
- Dart/Flutter 静态分析错误：如类型不匹配、null safety 问题、未定义方法/变量、导入遗漏等
- 依赖冲突与 pub 问题：自动识别并修复 pubspec.yaml 中的版本冲突、依赖树矛盾、pub get/upgrade 异常
- build_runner 相关错误：如代码生成失败、.g.dart 过期、依赖未声明等
- Flutter 多平台编译异常：Android、iOS、Web 构建常见的 Gradle、CocoaPods、平台版本兼容性等问题
- 自动化诊断与最小化修复：每次仅修改必要内容，绝不盲目添加 // ignore 或 dynamic，始终优先根因修复
2. 典型适用场景
- 本地开发时遇到 analyze 报错或构建失败
- CI/CD 持续集成流水线构建失败自动修复
- 依赖升级、团队协作后 pub 依赖冲突频发
- build_runner 代码生成流程频繁出错
- Flutter 多平台适配时平台相关构建错误
当你在 Dart/Flutter 项目中遇到上述问题时，直接触发 Dart Build Resolver Agent 能极大提升排查与修复效率。
三、触发方式与自动激活机制
- 自动触发：在 ECC 插件检测到 Dart/Flutter 构建失败（如 dart analyze、flutter build、pub get、build_runner 等命令报错）时，会自动激活 Dart Build Resolver Agent，优先尝试自动修复。
- 手动调用：开发者也可在遇到棘手的 Dart/Flutter 构建或依赖问题时，显式请求“使用 Dart Build Resolver 代理修复构建错误”。
这种自动+手动双模式，确保无论是本地开发还是自动化流水线，构建问题都能被及时、专业地处理。
四、与其他 Agent 的协作模式
Dart Build Resolver Agent 常与以下 Agent 组合协作，实现完整的 AI 编程自动化闭环：
- code-reviewer：构建修复后自动触发代码审查，确保修复无副作用，符合团队规范
- tdd-guide：修复完成后自动运行测试，保证 80%+ 覆盖率和回归安全
- security-reviewer：修复涉及依赖调整或敏感代码时，自动检测安全隐患
- doc-updater：依赖或接口变更后，自动更新相关文档和 codemap
这种多 Agent 协作模式，是 Claude Code 快速上手指南 推荐的生产级工作流，极大提升了 AI 编程助手的工程可靠性和团队协作效率。
五、为什么要用专门的 Dart Build Resolver Agent，而不是直接问 Claude？
直接让 Claude 处理 Dart/Flutter 构建错误，常见的问题有：
- Claude 只能根据上下文猜测，容易遗漏关键报错或误判根因
- 回答往往泛泛而谈，缺乏针对 Dart/Flutter 生态的专业修复流程
- 缺乏最小变更原则，可能建议大范围重构或不安全的 // ignore
- 无法批量、结构化处理复杂的依赖冲突和多级错误链
- 修复后缺少自动验证和剩余错误统计，难以确保修复质量
而 Dart Build Resolver Agent 的优势在于：
- 内置专业的诊断、修复和验证流程，能自动循环分析-修复-验证
- 严格执行“只修复错误、不做无关改动”的最小侵入原则
- 针对 Dart/Flutter 生态常见错误模式，内置最佳修复实践和代码片段
- 支持批量修复和剩余错误统计，输出结构化修复报告
- 与其他 Agent 自动协作，形成完整的“修复-审查-测试-文档”闭环
这也是 ECC Agent-First 体系的核心理念：每类工程问题都由专职 Agent 负责，避免通用 LLM 的知识盲区和工程风险。更多 Agent-First 原则详见 Everything Claude Code 完全指南。
六、实际使用示例（完整对话流程）
场景：开发者在 Flutter 项目中遇到 dart analyze 和 pub get 报错，手动触发 Dart Build Resolver Agent。
对话示例：
用户：
项目构建失败，报错如下：lib/features/cart/data/cart_repository_impl.dart:42:24: Error: A value of type 'String?' can't be assigned to a variable of type 'String' because 'String?' is nullable and 'String' isn't. pubspec.yaml: Because my_app depends on dio ^5.0.0 which depends on http >=0.13.0, and my_app depends on retrofit ^3.0.0 which depends on http <0.13.0, version solving failed.
ECC Dart Build Resolver Agent 自动响应：
[FIXED] lib/features/cart/data/cart_repository_impl.dart:42 Error: A value of type 'String?' can't be assigned to type 'String' Fix: Changed `final id = response.id` to `final id = response.id ?? ''` Remaining errors: 1 [FIXED] pubspec.yaml Error: Version solving failed — http >=0.13.0 required by dio and <0.13.0 required by retrofit Fix: Upgraded retrofit to ^4.0.0 which supports http >=0.13.0 Remaining errors: 0 Build Status: SUCCESS | Errors Fixed: 2 | Files Modified: [lib/features/cart/data/cart_repository_impl.dart, pubspec.yaml]
后续自动触发 code-reviewer 和 tdd-guide，确保修复安全、测试通过。
七、常见问题与注意事项
Q: 修复失败或错误反复出现怎么办？
A: Agent 会在 3 次修复尝试后自动停止，并报告需人工介入。通常是依赖树复杂、平台冲突或需架构调整时才会出现。
Q: Agent 会不会偷偷用 dynamic 或 // ignore 规避错误？
A: 严格禁止！Agent 只做根因修复，绝不引入 dynamic 或 // ignore，除非获得明确批准。
Q: 支持哪些 Dart/Flutter 版本和常见第三方库？
A: 支持主流 Dart 2.x/3.x、Flutter 2.x/3.x 及常用库（dio、retrofit、freezed、json_serializable、riverpod 等），遇到罕见依赖冲突会自动提示需人工决策。
通过 Everything Claude Code Dart Build Resolver Agent，Dart/Flutter 项目的构建、分析和依赖修复变得自动化、专业化、可验证，是 AI 编程助手体系下不可或缺的工程基石。如需进一步提升自动化与协作效率，推荐结合 Hooks 事件驱动自动化 和 Rules 语言规范体系 配置完整工作流。