Appearance
Everything Claude Code Flutter Reviewer Agent 是一款专注于 Flutter 和 Dart 项目的专业代码审查 AI 代理，能够自动识别 Widget 设计、状态管理、性能、无障碍和安全等多维度问题。相比直接提问 Claude，专用 Agent 能依据项目实际架构和约定，输出结构化、可追溯的审查报告，确保所有高优先级问题在合并前被发现和阻断，为生产级 Flutter 团队带来更高的代码质量与协作效率。
Everything Claude Code Flutter Reviewer Agent：Widget 最佳实践、状态管理与无障碍代码审查
在现代 Flutter 项目中，Widget 组合、状态管理、性能优化和无障碍合规已成为影响产品质量的核心因素。Everything Claude Code Flutter Reviewer Agent（以下简称“Flutter Reviewer”）正是为此场景量身打造的专业 AI 代码审查代理。它不仅能自动识别常见和隐蔽的 Flutter/Dart 代码问题，还能输出结构化的审查报告，成为团队必不可少的质量守门人。
本文将系统介绍 Flutter Reviewer 的核心用途、能力边界、触发方式、与其他 Agent 的协作模式，以及实际使用示例，帮助你理解为什么必须用专门的 Agent 而非直接问 Claude，并高效集成到你的 AI 编程助手工作流中。
1. Flutter Reviewer Agent 能解决什么问题？
典型适用场景
- PR 代码审查：每次提交或合并前，自动检测所有 Flutter/Dart 代码变更，发现高优先级问题。
- Widget 设计优化：识别冗长 build、缺失 const、错误的状态提升、性能浪费等。
- 多样状态管理：无论你用 BLoC、Riverpod、Provider、GetX 还是 Signals，均能识别反模式和架构违例。
- 无障碍与国际化：检测缺失语义标签、小点击区、硬编码字符串等问题，提升产品可达性。
- 安全与合规：发现 hardcoded 密钥、敏感数据明文存储、输入未校验、HTTP 明文传输等严重安全隐患。
为什么不能直接问 Claude？
- 上下文感知：Flutter Reviewer 会自动分析项目结构、依赖、状态管理和路由方式，避免误报和误判，而直接问 Claude 往往只基于片段，无法理解全局约定。
- 结构化输出：Agent 输出严格分级（CRITICAL/HIGH/MEDIUM/LOW），并给出定位、问题描述和修复建议，便于团队追踪和 CI 集成。
- 降噪与优先级：自动合并同类问题，跳过无关风格建议，聚焦高优先级 bug、安全和可维护性，避免“AI 代码审查噪音”。
- 安全兜底：一旦发现严重安全问题，会自动中止并移交给 security-reviewer 处理，防止安全隐患被遗漏。
2. Flutter Reviewer Agent 的具体能力与边界
能做什么？
- Widget 最佳实践检查：如 const 构造遗漏、build 方法过长、私有 helper 方法滥用、key 缺失、硬编码样式等。
- 状态管理反模式检测：如布尔状态“汤”、非穷尽状态处理、跨组件依赖混乱、mutable state 滥用等。
- 架构边界审查：如业务逻辑泄漏到 Widget、跨层 import、依赖注入缺失、私有 src 导入等。
- 性能陷阱识别：如不必要 rebuild、build 内部昂贵计算、MediaQuery 滥用、图片未优化等。
- 无障碍与国际化：如缺失语义标签、文本硬编码、无响应式布局、无 SafeArea 等。
- 资源与生命周期管理：如 dispose 遗漏、context 滥用、未关闭 Stream/Timer 等。
- 测试覆盖与隔离：如无单元/组件/黄金测试、异步测试不稳定、依赖未 mock 等。
- 安全问题自动升级：如 hardcoded 密钥、明文存储、输入未校验等，自动交由安全代理处理。
明确不能做什么？
- 不自动重写代码：仅报告问题和修复建议，不直接修改或重构代码（避免误改）。
- 不输出风格偏好：跳过与项目约定不符但无功能影响的风格建议。
- 不审查未变更代码（除安全问题）：仅对本次变更或高危安全点做审查，避免干扰。
- 不替代项目特定规范：如有 CLAUDE.md 或 analysis_options.yaml，会自动适配本项目规范。
3. 触发方式与自动化集成
何时自动激活？
- Git 操作后自动触发：每次
git commit或 PR 创建时，自动检测变更的 Dart 文件并审查。 - Pre-merge/CI 钩子：集成在 Everything Claude Code Hooks 体系下，作为 PreToolUse/PostToolUse 事件自动执行，保障主干分支质量。
- 多 Agent 并行审查：可与 code-reviewer、security-reviewer 等并行启动，分别聚焦 Flutter、通用代码和安全层面。
何时手动调用？
- 本地开发自查：开发者可在本地随时手动调用 Flutter Reviewer，对当前工作区变更进行即时反馈。
- 指定文件/目录审查：支持手动指定特定 Dart 文件或目录，聚焦局部代码质量。
- 架构/状态管理变更专项审查：如大规模架构重构、状态管理方案切换时，单独调用以捕获全局影响。
4. 与其他 Agent 的协作模式
Flutter Reviewer 并非孤立运行，常见组合包括：
- 与 code-reviewer 并行：code-reviewer 负责通用代码质量、可维护性，Flutter Reviewer 深入 Flutter/Dart 生态细节，互补无重叠。
- 与 security-reviewer 联动：发现安全高危问题时，自动转交 security-reviewer 跟进并阻断流程。
- 与 tdd-guide 配合：新功能开发时，tdd-guide 先生成测试用例，Flutter Reviewer 确保实现过程中的所有变更都符合最佳实践与架构约束。
- 与 hooks/rules 体系集成：通过 Everything Claude Code Rules 和 hooks，实现审查标准的自动升级与定制。
5. 实际使用示例
场景：PR 提交后自动 Flutter 代码审查
开发者提交代码后，系统自动触发 Flutter Reviewer Agent，输出如下结构化报告：
plaintext
[CRITICAL] 业务逻辑泄漏至 Widget 层
File: lib/features/auth/presentation/login_page.dart:67
Issue: 在 build() 方法内直接调用 API，违反架构分层。
Fix: 将 API 调用移至 state manager 或 service 层，通过依赖注入传递结果。
[HIGH] 缺失 const 构造函数
File: lib/widgets/common/button.dart:12
Issue: 所有字段均为 final，但未声明 const 构造，导致不必要的重建。
Fix: 为 Widget 添加 const 构造函数。
[MEDIUM] 图片缺少语义标签
File: lib/features/profile/presentation/avatar.dart:23
Issue: Image 组件未设置 semanticLabel，影响无障碍访问。
Fix: 添加合适的 semanticLabel 属性。
## Review Summary
| Severity | Count | Status |
|----------|-------|--------|
| CRITICAL | 1 | block |
| HIGH | 1 | block |
| MEDIUM | 1 | info |
| LOW | 0 | note |
Verdict: BLOCK — CRITICAL/HIGH 问题需修复后再合并。优势体现：
- 问题定位精确，修复建议明确
- 自动分级，团队一目了然判断是否可合并
- 安全问题自动升级，防止漏检
6. 常见问题与注意事项
Q: Flutter Reviewer 支持哪些状态管理方案？ A: 支持 BLoC、Riverpod、Provider、GetX、MobX、Signals 及原生方案，自动适配项目实际用法，无需手动配置。
Q: 审查结果能否定制或扩展？ A: 可以。通过 Everything Claude Code Rules 和自定义 hooks，可添加项目特定规则或调整优先级，满足团队需求。
Q: 如何避免 AI 误报或风格噪音？ A: Flutter Reviewer 只报告高置信度（80%+）问题，并自动降噪、合并同类项，风格建议仅在违背项目约定或影响功能时提示。
通过集成 Everything Claude Code Flutter Reviewer Agent，你可以将生产级 Flutter 代码审查自动化，显著提升团队协作效率与代码质量。如果你希望进一步了解 ECC 全栈 Agent 体系和自动化工作流，建议阅读 Everything Claude Code 完全指南：38 Agent + 156 Skill 的生产级 AI 编程插件 和 Claude Code 快速上手指南：Skills、Hooks、Subagents、MCP 实战配置。