SuperAPI AI 工具集

agent-flutter-developer

智能体与模型

查看项目

更新于 10-16 23:15

技能介绍

用途

这是一个专用于 Flutter/Dart 跨平台移动与 Web 开发的专业子代理。它面向构建新 Flutter 应用、实现状态管理、搭建导航、接入原生平台特性、集成 Firebase、配置构建风味(build flavor)与环境、以及排查 Flutter 渲染或性能问题等场景。

主要能力

  • Flutter Widget 体系:Widget 树组合与生命周期、StatelessWidget 与 StatefulWidget 的取舍、CustomPainter 高级渲染、Slivers 自定义滚动、隐式与显式动画、平台自适应 Widget。
  • Dart 3 语言特性:Records 与元组、模式匹配(switch 表达式、解构)、密封类(sealed classes)用于穷尽匹配、类修饰符(final、interface、base、mixin)、扩展类型(extension types)、健全的空安全。
  • 状态管理:Riverpod(providers、notifiers、async values)、Bloc/Cubit(events、states、BlocBuilder)、Provider(legacy、ChangeNotifier)、flutter_hooks(useEffect、useState、useMemoized)、状态恢复。
  • 导航:GoRouter(声明式、深链接、重定向)、auto_route(代码生成、守卫)、Navigator 2.0 API、iOS 与 Android 深链接、Web 端基于 URL 的路由。
  • 平台集成:平台通道(MethodChannel、EventChannel)、Dart FFI(调用 C/C++ 库)、Pigeon(类型安全的平台通道)、平台视图(嵌入原生视图)、插件开发。
  • Firebase 集成:Firebase Auth(邮箱、社交、匿名)、Cloud Firestore(实时同步)、Firebase Cloud Messaging(推送通知)、Firebase Crashlytics、Firebase Remote Config、FlutterFire CLI。
  • 测试:Widget 测试(WidgetTester、pump、find)、Golden 测试(截图比对)、集成测试(integration_test 包)、使用 Mockito 进行 mock、测试覆盖率。
  • 构建与部署:构建风味(dev、staging、production)、平台特定配置、代码签名、应用商店部署、使用 Codemagic、GitHub Actions、Fastlane 的 CI/CD。

使用方式

该代理以子代理形式使用,任务通过 $ARGUMENTS 传入。资料给出的工作准则包括:新项目使用 Riverpod(编译期安全、可测试、不依赖 BuildContext);组合优于继承,通过组合更小 Widget 来构建复杂界面,避免深层继承;尽可能使用 const 构造函数以优化重建;将业务逻辑与 UI 分离,Widget 专注展示,业务逻辑放在 providers/notifiers/blocs 中;为所有交互组件编写 widget 测试,并用 golden 测试做像素级 UI 校验。

资料还提供了关键模式的示例代码,包括 Riverpod 状态管理(含 @riverpod 注解、AuthState、Notifier、异步 provider、带参数的 family provider)、GoRouter 导航(含 redirect 鉴权、嵌套路由、ShellRoute)、带 Riverpod Consumer 的 Widget、平台通道(MethodChannel 与 EventChannel 的 Dart 端与 Kotlin 端示例)、Widget 测试(使用 mocktail 与 ProviderScope override),以及构建风味(Environment 枚举与 AppConfig,配合 --dart-define 运行命令)。

此外给出了推荐的 Flutter 项目结构(lib 下分 main.dart、app.dart、config、models、providers、repositories、screens、widgets、router、services、utils),以及一份 Flutter 检查清单(flutter analyze 干净、尽量 const 构造函数、业务逻辑与 UI 分离、导航处理深链接、异步 provider 处理错误状态、平台特定代码使用平台通道或条件导入、为 dev/staging/production 配置构建风味)。

适用场景

构建新的 Flutter 应用;使用 Riverpod 或 Bloc 实现状态管理;使用 GoRouter 搭建导航;集成原生平台特性;编写 Flutter 测试(widget、golden、集成);在 Flutter 中接入 Firebase;配置构建风味与环境;调试 Flutter 渲染或性能问题。

限制

资料未提供该代理的收费、价格、平台支持范围或具体效果数据,这些信息暂未提供。其能力范围以资料列出的 Flutter、Dart、Riverpod、GoRouter、平台通道、Firebase 与测试相关条目为准,资料未提及的功能未作说明。