Flutter Expert 是一个用于构建高性能跨平台应用的技能,定位于资深移动端工程师,基于 Flutter 3 和 Dart 工作。
用途
该技能用于以下场景:构建跨平台 Flutter 应用;实现状态管理(Riverpod、Bloc);使用 GoRouter 配置导航;创建自定义组件与动画;优化 Flutter 性能;以及进行平台特定实现。
主要能力
技能围绕一套核心工作流展开:
- 搭建(Setup)—— 初始化项目、添加依赖(flutter pub get)、配置路由。
- 状态(State)—— 定义 Riverpod providers 或 Bloc/Cubit 类,并使用 flutter analyze 验证。若 flutter analyze 报出问题,需先修复所有 lint 和警告,反复运行直至干净。
- 组件(Widgets)—— 构建可复用、经 const 优化的组件;每个功能完成后运行 flutter test。若测试失败,使用 Flutter DevTools 检查组件树,修复断言失败并重新运行 flutter test。
- 测试(Test)—— 编写组件与集成测试,用 flutter test --coverage 确认。若覆盖率下降或测试失败,找出未覆盖分支,补充针对性测试并重新运行后再合并。
- 优化(Optimize)—— 使用 Flutter DevTools(flutter run --profile)进行性能分析,消除卡顿、减少重建。若卡顿持续,检查 Performance overlay 中的重建次数,隔离昂贵 build() 调用,应用 const 或将状态移近消费者。
技能还提供参考文档加载指引,按上下文加载:Riverpod(references/riverpod-state.md,用于状态管理、providers、notifiers)、Bloc(references/bloc-state.md,用于 Bloc、Cubit、事件驱动状态与复杂业务逻辑)、GoRouter(references/gorouter-navigation.md,用于导航、路由、深度链接)、组件(references/widget-patterns.md,用于构建 UI 组件与 const 优化)、结构(references/project-structure.md,用于设置项目与架构)、性能(references/performance.md,用于优化、profiling、卡顿修复)。
使用方式
技能给出 Riverpod Provider + ConsumerWidget 的正确模式:使用 NotifierProvider 定义 provider(而非旧版 StateNotifier),Notifier 的 build() 返回初始状态,更新时创建新实例而非直接变更;消费组件使用 ConsumerWidget(而非 StatefulWidget),通过 ref.watch 读取状态,通过 ref.read(...notifier) 触发操作,并在静态组件上使用 const。
技能还提供状态管理的正反示例:错误做法是在 setState 中管理应用级状态;正确做法是使用作用域内 Riverpod consumer。
约束方面,必须(MUST DO):尽可能使用 const 构造函数;为列表实现正确的 keys;使用 Consumer/ConsumerWidget 处理状态(而非 StatefulWidget);遵循 Material/Cupertino 设计指南;用 DevTools 做 profiling 并修复卡顿;使用 flutter_test 测试组件。禁止(MUST NOT DO):在 build() 方法内构建组件;直接变更状态(始终创建新实例);用 setState 处理应用级状态;在静态组件上省略 const;忽略平台特定行为;用重计算阻塞 UI 线程(应使用 compute())。
常见故障排查
技能列出常见故障与恢复方式:flutter analyze 报错(未解析导入、缺失 const、类型不匹配 → 修复标记行,导入缺失时运行 flutter pub get);组件测试断言失败(组件树不匹配或异步状态未 settle → 状态变化后使用 tester.pumpAndSettle(),验证 finder 选择器);添加包后构建失败(依赖版本不兼容 → 运行 flutter pub upgrade --major-versions,检查 pub.dev 兼容性);卡顿/掉帧(昂贵 build() 调用、未缓存组件、主线程重负载 → 使用 RepaintBoundary,将重活移到 compute(),添加 const);热重载未反映变化(Notifier 中的状态未重置 → 使用热重启 R 重置完整应用状态)。
输出模板
实现 Flutter 功能时,应提供:带正确 const 用法的组件代码;Provider/Bloc 定义;如需要则提供路由配置;测试文件结构。
适用场景
适用于 Flutter 3+ 与 Dart 的跨平台应用开发,尤其是涉及 Riverpod/Bloc 状态管理、GoRouter 导航、自定义组件与动画、性能优化和平台特定实现的场景。
限制
该技能基于 Flutter 3+ 与 Dart;要求按 MUST DO / MUST NOT DO 约束执行;部分主题需加载对应参考文档。关于收费、价格、平台支持范围等更多事实,资料未提供。
维护者:@jeffallan,Synergetic Solutions 首席顾问。