SuperAPI AI 工具集

flutter-dev

编程与开发

查看项目

更新于 10-16 05:25

技能介绍

用途

flutter-dev 是一个面向 Claude 的 Flutter 与 Dart 开发技能,定位于跨平台移动应用开发场景。它以「资深 Flutter 开发者」的角色设定运行,强调整洁架构(Clean Architecture)、Riverpod/Bloc 状态管理以及面向生产环境的构建与部署。技能描述中明确写出:任何涉及 Flutter、Dart、Flutter widgets、Flutter 状态管理的任务都应始终触发该技能。

主要能力

技能内容围绕一套完整的工程实践展开,涵盖以下方面:

整洁架构项目结构:给出 lib 目录的组织方式,包括 core(constants 常量与接口地址、errors 失败类、network Dio 客户端、router GoRouter 配置、theme Material 3 主题)、features(按功能模块划分,内含 data 数据源/模型/仓库、domain 实体/抽象仓库接口/用例、presentation 页面/组件/Provider)、shared(可复用组件、BuildContext 扩展)以及入口 main.dart。

Riverpod 状态管理:使用 riverpod_annotation 注解定义 Provider,示例中提供 AuthNotifier 的 build/login/logout 写法,并配合 Freezed 定义 AuthState 状态联合类型(initial、loading、authenticated、unauthenticated、error)。

Freezed 数据模型:示例 UserModel 使用 freezed_annotation 与 json_annotation,定义必填与可选字段、默认值以及 @JsonKey 字段名映射,并生成 fromJson 工厂方法。

GoRouter 导航:示例 appRouter 定义 initialLocation、redirect 逻辑(根据登录状态跳转 auth 或 home)以及包含 ShellRoute 的路由列表,并演示路径参数读取(/products/:id)。

Dio HTTP 客户端:示例 DioClient 配置 baseUrl、连接与接收超时,并添加鉴权、重试与日志拦截器;AuthInterceptor 演示在请求头写入 Bearer token,以及在 401 时刷新 token 并重放请求。

Material 3 主题:示例 AppTheme 提供亮色与暗色主题,使用 ColorScheme.fromSeed、GoogleFonts.interTextTheme 以及 FilledButton 样式配置。

依赖清单:列出拟使用的核心依赖(flutter_riverpod、riverpod_annotation、go_router、freezed_annotation、json_annotation、dio、retrofit、flutter_secure_storage、cached_network_image、shimmer、intl、equatable)与开发依赖(build_runner、freezed、json_serializable、retrofit_generator、riverpod_generator、flutter_test)。

测试:示例以 ProviderContainer 与 MockAuthRepository 覆盖依赖的方式,编写 AuthNotifier 登录成功发出 authenticated 状态的单元测试。

常用命令:汇总创建项目、代码生成(build_runner build/watch)、运行(含 --dart-define)、构建(APK/iOS/AppBundle)、测试(含覆盖率)与分析修复(flutter analyze、dart fix)等命令。

使用方式

该技能通过技能平台以技能包形式提供,安装与在 Claude 中启用的具体方式、所需前置环境(如 Flutter SDK 版本、Dart 版本)以及命令行参数细节,资料中暂未提供。

适用场景

适用于使用 Flutter 与 Dart 构建跨平台移动应用的任务,包括工程结构搭建、状态管理实现、数据模型与序列化、路由与导航、网络请求封装、主题定制、单元测试编写以及多平台构建与部署。

限制

资料仅提供了架构与代码示例,未提供实际的项目脚手架、CLI 工具或运行时包;示例中的依赖版本为文中写明的版本号,实际兼容性与升级策略暂未提供。收费、价格、平台支持范围与效果表现等信息暂未提供。