Everything Claude Code Kotlin Build Resolver 是一款专为 Kotlin/Gradle 项目设计的 AI 构建错误修复代理，能够精准诊断并最小化修复编译、依赖和配置相关问题。它不仅支持常见的 Kotlin 编译器报错、Gradle 配置异常，还能处理 detekt/ktlint 代码风格问题，适用于 Android、KMP、后端等多种场景。相比直接提问 Claude，使用该 Agent 能大幅提升自动修复的准确率和安全性，是生产环境下解决 Kotlin 构建难题的首选工具。

Everything Claude Code Kotlin Build Resolver：Kotlin 编译错误与 Gradle 构建问题精准修复

Kotlin 项目在开发和集成过程中，常常会遇到编译失败、依赖冲突、Gradle 配置错误等一系列构建难题。对于依赖复杂、模块众多的 Android、KMP 或后端服务项目，单靠 AI 助手泛泛回答往往难以定位核心问题，甚至可能引入新的隐患。为此，Everything Claude Code 提供了专门的 kotlin-build-resolver Agent，专注于「精准、最小化」修复 Kotlin 相关构建错误，极大提升了 AI 编程助手在生产环境下的实用价值。

一、kotlin-build-resolver Agent 是什么？解决什么问题？

kotlin-build-resolver 是 ECC（Everything Claude Code）体系下的专业构建错误修复代理，专为以下场景设计：

• Kotlin 编译失败：如 Unresolved reference、Type mismatch、when 表达式不完整 等常见报错。
• Gradle 配置/依赖冲突：如依赖找不到、版本不兼容、仓库缺失、任务执行失败等。
• 代码风格违规：支持 detekt、ktlint 等静态检查，自动修复风格问题。
• 依赖树分析：快速定位依赖冲突和版本问题。
• 只做最小必要变更：避免大范围重构，降低引入新问题的风险。

核心优势：
与直接让 Claude 读报错、给建议不同，kotlin-build-resolver 内置了系统化的诊断与修复流程、专业的错误模式库和最小变更原则，能自动执行构建命令、解析报错、定位受影响文件，并只针对根因做「外科手术式」修复。这样既能提升修复成功率，又能避免“修好一个、坏掉一片”的副作用。

二、Agent 能力与局限

能做什么？

• 解析 ./gradlew build、detekt、ktlintCheck 等命令输出，自动定位并修复编译/风格/依赖问题
• 处理常见 Kotlin 编译器报错（如类型不匹配、未导入、when 分支不全、可见性、协程调用等）
• 检查并修复 Gradle 配置、依赖声明、仓库设置、版本冲突
• 自动补充缺失的 import、修正类型、添加依赖或仓库声明
• 检查 detekt/ktlint 配置，修复代码风格问题
• 每次修复后自动重新构建并验证，确保修复有效且不引入新错误
• 输出详细修复报告，包括修改文件、剩余错误数、最终构建状态

不能做什么？

• 超出单点修复范围的大型架构调整（如模块重组、跨项目依赖迁移）
• 需要人工决策的外部依赖引入（如需手动获取私有库、付费依赖等）
• 持续出现同一错误超过 3 次无法修复时，会停止并报告
• 不会无理由更改函数签名、批量 suppress 警告，始终遵循最小变更原则

提示：如需进行大规模重构、架构决策，建议结合 architect agent 或 planner agent 协同使用。

三、触发方式与自动化集成

自动触发

• 构建失败时：在 CI、pre-commit、保存文件后自动检测到 ./gradlew build 失败时，系统会自动调用 kotlin-build-resolver 进行修复。
• 代码风格检查失败时：detekt/ktlint 检查未通过时自动介入。

手动调用

• 在 AI 编程助手（如 Claude Code、Cursor、Codex）输入：「修复当前 Kotlin 构建错误」或「帮我解决 Gradle 依赖冲突」
• 通过 ECC 提供的命令面板、快捷键或自定义 Hook 触发

与其他 Agent 的协作模式

• 与 code-reviewer 组合：先修复构建错误，再由 Kotlin Reviewer Agent 进行代码质量和安全性审查。
• 与 tdd-guide 组合：修复构建后自动执行测试驱动开发流程，保障修复不破坏已有逻辑。
• 与 hooks 自动化集成：结合 Hooks 体系，可在 PreToolUse/PostToolUse 等事件自动触发修复和验证循环。

四、实际使用示例

以下是一个典型的 AI 辅助修复流程对话：

用户：

刚刚 pull 了主分支，./gradlew build 报错：Unresolved reference: UserRepository，帮忙修一下。

系统自动调用 kotlin-build-resolver：

./gradlew build 2>&1
# 解析报错，发现 src/main/kotlin/com/example/service/UserService.kt:42 未导入 UserRepository
# 自动补充 import
# 重新运行 ./gradlew build

Agent 回复：

[FIXED] src/main/kotlin/com/example/service/UserService.kt:42
Error: Unresolved reference: UserRepository
Fix: Added import com.example.repository.UserRepository
Remaining errors: 0

Build Status: SUCCESS | Errors Fixed: 1 | Files Modified: [src/main/kotlin/com/example/service/UserService.kt]

后续自动触发：

• 运行 ./gradlew test，验证所有测试通过
• 若有 detekt/ktlint 报错，自动修复并输出修复详情

与其他 Agent 协作：

• 修复完成后自动触发 Kotlin Reviewer Agent 进行代码审查
• 结合 Hooks 自动化 实现端到端的修复-验证-审查闭环

五、为什么不用直接问 Claude？专用 Agent 的优势

1. 上下文感知与自动命令执行：Agent 会自动运行构建、风格检查、依赖树分析等命令，精准定位问题，而不是靠用户手动粘贴报错。
2. 最小化变更原则：只改必要的地方，避免“AI 乱修一通”导致新坑。
3. 内置错误模式库：针对 Kotlin/Gradle 生态常见报错有专门的处理逻辑，修复更专业、覆盖更全。
4. 自动化验证：每次修复后自动重跑构建和测试，确保修复有效且无副作用。
5. 与其他 Agent/Hook 协同：可自动串联代码审查、测试、风格校验等环节，形成完整的生产级修复闭环。
6. 失败保护：多次修复无效时会停止并报告，避免死循环和误操作。

相比之下，直接问 Claude 只能得到“建议”或“猜测”，而专用 Agent 能自动执行、验证和精准修复，极大提升工程效率和安全性。

六、最佳实践与进阶用法

• 推荐在团队 CI/CD、pre-commit、保存文件等环节集成自动触发，保障主分支持续可构建
• 结合 Rules 体系 和 Skill 自动化 定制更细粒度的修复策略
• 对于复杂依赖冲突，可先用 ./gradlew dependencies 查看依赖树，再交由 Agent 处理
• 任何修复后，建议总是触发 Kotlin Reviewer Agent 复查，防止安全或风格问题遗漏

---

FAQ

Q: kotlin-build-resolver 能自动修复所有 Kotlin 构建错误吗？
A: 能解决绝大多数常见编译、依赖和配置问题，但对于架构级变更或需要人工介入的外部依赖仍需开发者决策。

Q: 如何与代码审查、TDD 等流程集成？
A: 修复完成后可自动触发代码审查 Agent 和测试驱动开发流程，支持与 Hooks、Rules 等自动化体系无缝协作。

Q: 修复失败时会怎样？
A: 若连续 3 次修复仍未解决，Agent 会停止操作并输出详细报告，避免死循环和误修。

---