Flutter技能

向 dart_skills_lint 添加新验证规则和 CLI 标志的说明。

当用户要求基于JSON Schema定义在应用程序中创建新的CatalogItem、数据类和/或控件类时，使用此技能。

优先使用多行字符串（ ''' ）而非通过 + 和 \n 拼接字符串，尤其适用于 SQL 查询、HTML 或 PEM 编码密钥等大段文本。这能通过自然换行提升可读性，并避免 lines_longer_than_80_chars 的 lint 错误。

为了找到迁移的候选对象，请使用以下搜索策略：

保持入口文件（例如 bin/my_app.dart）的内容最小化。这通过将逻辑与进程运行器解耦来提高可测试性。

为了查找文档问题：

解析 Dart 和 Flutter 测试日志中的失败信息。

查找超过限制的行：

为改进匹配器使用寻找候选方案，搜索次优模式：

为了找到现代化的候选方案：

与Dart团队最佳实践保持一致，维护Dart包的指南。

使用 dart_skills_lint 命令行工具验证技能。根据您的环境选择合适的工作流程：

在Dart包中运行和解读测试覆盖率的指南。

为了寻找改进测试结构的候选方案：

在此仓库中处理任何涉及 md 文件或 dart 代码的任务之前，必须运行的强制性检查。

一项用于查找包含指定提交的最低Dart和Flutter版本的技能。当用户询问某个提交何时被合并到Flutter或Dart中时，可使用此技能…

在Flutter应用中实现WCAG 2和EN 301 549无障碍标准及自适应布局。在移动端、网页端和桌面端强制实施语义标注、点击目标尺寸（最小48x48 dp）和文本对比度（小文本4.5:1，大文本3:1）。提供网页语义初始化、交互式组件包裹、基于屏幕尺寸的布局切换以及键盘/鼠标输入处理的决策逻辑。包含通过FocusTraversalGroup实现的焦点遍历管理，以及...

通过widget_inspector触发无障碍扫描，并自动向源代码中添加Semantics组件或缺失的标签。

配置Flutter Driver以实现应用交互，并将MCP操作转换为持久的集成测试。在向项目添加集成测试时使用，…

使用previews.dart系统为项目添加交互式组件预览。在创建新的UI组件或更新现有界面时使用，以确保…

Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating…

为Flutter应用添加Android和iOS主屏幕小组件，支持原生UI与共享数据同步。Flutter通过home_widget包，利用共享本地存储（iOS的UserDefaults、Android的SharedPreferences）与原生小组件通信；数据从Flutter写入，在操作系统触发时由原生小组件读取。iOS实现使用Xcode、SwiftUI和Widget Extension目标，并启用App Groups功能；Android则使用Android Studio配合AppWidgetProvider、XML布局等。

使用动画框架为Flutter应用提供视觉反馈、过渡效果和基于物理的运动。四种动画策略：用于简单属性变化的隐式动画、带播放控制的显式动画、路由间共享元素的Hero过渡，以及手势驱动的自然运动物理动画。核心类型化动画系统包含AnimationController、Tween和Curve类；始终释放控制器以防止内存泄漏。交错动画...

根据您的UI需求选择并实现最优的Flutter动画策略。包含决策树，用于在隐式动画、显式补间、基于物理的运动、Hero过渡、交错序列和页面路由过渡之间进行选择。提供每种动画类型的完整代码示例，从简单的AnimatedContainer到复杂的交错多补间设置。通过强制性的AnimationController销毁和性能最佳实践来执行严格的内存管理...

测量并优化Flutter应用包、APK或IPA的大小，提供针对特定平台的分析与缩减策略。支持Android（APK/AppBundle）、iOS（IPA）及桌面平台（Linux、macOS、Windows），并包含平台特定的测量工作流程。通过flutter build --analyze-size生成代码大小分析JSON文件，并与Dart DevTools应用大小工具集成，实现组件分解可视化。通过调试信息拆分、资源压缩等方式实现大小缩减...

使用推荐的层次化方法（UI、逻辑、数据）架构Flutter应用程序。适用于构建新项目或为可扩展性进行重构时。

分层架构框架，适用于可扩展的Flutter应用，具有严格的关注点分离。强制采用三层结构（UI层、逻辑层、数据层），实现单向数据流，并在数据层中保持单一数据源。UI层包含精简的视图和视图模型，将领域模型转换为展示状态；逻辑层（可选）处理复杂的业务编排；数据层严格划分为无状态服务与缓存仓库。提供逐步功能...

适用于Flutter应用的MVVM架构，采用单向数据流和严格的层分离。实现三层架构：数据层（服务和仓库）、领域层（用于复杂逻辑的用例）和UI层（视图模型和视图）。使用provider进行依赖注入，通过ListenableBuilder实现响应式UI更新，并采用Command模式处理用户交互。强制单向数据流：数据从仓库向下流向视图模型再到视图；事件向上流动...

Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on…

经过验证的Flutter表单，包含字段级错误处理和提交工作流。需要托管在StatefulWidget中，并使用持久的GlobalKey<FormState>来管理表单状态和跨重建的验证。使用带有validator()回调的TextFormField组件，该回调在验证失败时返回错误字符串，成功时返回null。提交时调用_formKey.currentState!.validate()触发所有验证器，并自动在字段下方显示错误消息。包含完整代码示例，演示用户名...

掌握Flutter的约束系统，高效构建响应式且无溢出的布局。核心原则：约束向下传递，尺寸向上反馈，父级设定位置。切勿在弹性盒子或可滚动区域中传递无界约束。使用Row/Column实现线性布局，Expanded/Flexible分配空间，Stack处理重叠元素，SizedBox施加严格约束。通过LayoutBuilder实现响应式尺寸调整，或利用条件渲染适配移动端、平板等不同设备的自适应布局。

构建并实现跨平台Flutter插件，支持Android、iOS、Windows和Web的原生互操作。支持标准插件（通过Method Channel调用平台API）和FFI插件（绑定C/C++原生库）；根据需求选择平台特定SDK访问或直接原生代码绑定。联邦插件架构将API拆分为应用层、平台接口和独立平台实现包，便于团队协作开发。包含逐步指南...

为Flutter应用提供跨多种数据类型和平台的全面缓存与性能优化。包含决策逻辑以选择合适的缓存机制：内存缓存、用于键值对的shared_preferences、用于关系型数据的SQLite、用于大块数据的文件系统，以及用于网络图片的图片缓存。包含基于流的离线优先仓库模式，先返回缓存数据，再从网络获取并更新。涵盖Android FlutterEngine预预热及...

Flutter应用的本地数据缓存与离线优先同步模式。涵盖五种缓存策略：用于UI状态的shared_preferences、用于结构化数据的SQLite/Hive、用于二进制媒体的文件系统、用于导航的状态恢复，以及Android上的FlutterEngine预预热。通过流式读取（先返回本地数据，再获取远程数据，最后更新缓存）实现离线优先仓库，并采用双重写入策略（纯在线模式与离线优先+后台同步模式）。优化图片缓存...

后台JSON解析与状态管理，实现无卡顿的Flutter UI渲染。提供基于模型复杂度的决策树，用于在手动序列化（dart:convert）和代码生成（json_serializable）之间进行选择。支持三种并发策略：针对小数据量的主线程async/await、针对繁重一次性计算的短生命周期Isolate.run()，以及使用ReceivePort/SendPort进行持续双向通信的长生命周期隔离。包含平台感知的降级方案：...

基于MVVM架构的Flutter数据层，采用Repository模式、无状态服务及智能本地缓存策略。根据数据类型、规模和关系复杂度，指导选择持久化技术（shared_preferences、sqflite、drift、hive_ce、isar_community或文件I/O）。将Repository实现为唯一数据源，将DatabaseService和ApiClient作为私有无状态依赖进行隔离。提供领域模型、SQLite操作及...的完整代码示例。

直接将原生Android、iOS或macOS视图及网页内容嵌入Flutter应用。支持两种Android合成模式（混合合成与纹理层合成），两者在性能与保真度上各有取舍；iOS和macOS仅使用混合合成。包含在Android和iOS上实现平台视图的分步工作流程，并提供验证与故障排除指导。支持通过全页面或多视图（嵌入式）模式将Flutter嵌入现有网页应用，并...

为Flutter桌面开发提供Linux环境配置，包含操作系统检测与工具链验证。自动识别Debian/Ubuntu或ChromeOS，并在非apt系统上停止运行并给出说明。安装核心依赖（curl、git、unzip、libglu1-mesa）及Linux桌面工具链（clang、cmake、ninja-build、GTK库）。提示可选IDE配置（通过snap安装VS Code或Android Studio）。运行flutter doctor -v和flutter devices验证环境，自动安装...

自动化的macOS Flutter开发环境搭建，包含依赖验证与诊断修复。验证Flutter安装、Xcode可用性及CocoaPods存在性；若缺少任何前置条件，则停止并给出清晰指引。引导用户完成Xcode命令行工具配置及许可证接受，需执行sudo命令。运行迭代式flutter doctor验证循环，识别并解决剩余工具链问题，直至Xcode部分完全通过...

自动化的Windows Flutter开发环境搭建，包含平台特定工具链配置。通过交互式提示为Windows桌面、Android或两者配置Flutter SDK路径、Visual Studio C++工具链安装及平台特定设置。当选择Android时，处理Android Studio设置、设备/模拟器配置及USB驱动安装。使用OpenSSL生成自签名MSIX证书，用于本地Windows应用打包和部署...

使用Dart和Flutter MCP工具修复Flutter布局错误（溢出、无界约束）。适用于处理“RenderFlex溢出”、“垂直…

构建带验证的表单

将CPU密集型任务卸载到后台隔离区，同时保持Flutter UI响应。提供三种并发模式：用于I/O密集型工作的async/await、用于一次性重型计算的Isolate.run()，以及通过消息传递实现持久后台工作者的Isolate.spawn()。包含一个决策矩阵，可根据任务类型（I/O密集型与CPU密集型）和执行频率在异步操作与隔离区之间进行选择。涵盖三个完整工作流程，并附有逐步任务清单：标准...

HTTP请求与JSON序列化，用于Flutter REST API集成与数据解析。涵盖三种HTTP方法（GET、POST、PUT、DELETE），包含正确的状态码验证、HTTPS强制使用以及通过Uri.https()构建安全URI。提供两种序列化策略：针对简单模型的手动fromJson/toJson，以及针对复杂嵌套结构的json_serializable代码生成。包含使用compute()进行后台解析，以在处理大型JSON负载时防止UI卡顿...

适用于iOS和Android上Flutter应用的原生主屏幕小组件，支持跨平台数据共享。通过App Groups（iOS）和SharedPreferences（Android）在Dart与原生平台之间建立数据共享，实现从Flutter应用更新小组件。支持简单的文本小组件以及渲染为静态图像的复杂Flutter UI，用于原生显示。需要在Xcode（使用Swift TimelineProvider的Widget Extension目标）和Android Studio（使用XML的AppWidgetProvider）中进行原生设置...

为Flutter应用提供安全的HTTP网络通信和JSON处理，支持后台解析。使用http包实现CRUD操作（GET、POST、PUT、DELETE），通过Uri.https()构建安全URL并进行严格的状态码验证。利用Dart 3模式匹配、工厂构造函数和toJson()方法实现强类型JSON序列化与反序列化。通过compute()将大型JSON解析任务卸载到后台隔离区，避免超过16ms的负载导致UI卡顿...

Create model classes with `fromJson` and `toJson` methods using `dart:convert`. Use when manually mapping JSON keys to class properties for simple data…

Flutter屏幕切换与深度链接的命令式和声明式路由模式。涵盖Navigator（命令式、基于栈）和Router（声明式、URL同步）两种方法，并指导何时使用每种方式。支持iOS、Android和Web上的深度链接；包括通过构造函数、路由参数和返回值传递数据。为多步骤流程（如设置向导）实现嵌套导航，包含独立子导航器和返回按钮拦截。提供...

配置Flutter应用以支持辅助技术，包括屏幕阅读器和键盘导航。涵盖UI设计基础：字体缩放、颜色对比度（普通文本4.5:1，大文本3:1）以及48x48像素的最小点击目标。提供使用Semantics、MergeSemantics和ExcludeSemantics小部件的语义标注模式，以向辅助工具暴露小部件树结构。包含针对Web的指导，用于启用语义层（默认因性能原因禁用）以及...

从Flutter代码访问Android、iOS和Web上设备特定的原生API。支持三种集成方式：用于直接C/C++绑定的FFI、用于调用Kotlin/Swift/Objective-C的平台通道（通过Pigeon实现类型安全），以及用于嵌入原生UI组件的平台视图。FFI使用dart:ffi并通过build.dart钩子自动编译构建；需要extern "C"符号和package:ffigen生成Dart绑定。平台通道提供异步消息传递...

通过组合widget、管理约束和适配屏幕尺寸，构建响应式Flutter布局。提供决策树，根据内容维度、重叠、滚动和响应式需求，选择合适的基础布局widget（Row、Column、Stack、ListView、GridView、CustomScrollView）。强制执行Flutter核心约束系统：约束向下传递，尺寸向上传递，父级设置位置；包含用于强制特定尺寸的ConstrainedBox模式。实现...

配置Flutter应用以支持多语言和区域设置，完成正确的国际化（i18n）配置。管理依赖注入（flutter_localizations、intl）、代码生成配置（l10n.yaml）以及支持占位符、复数形式和区域变体的.arb翻译文件创建。配置根组件代理（MaterialApp、CupertinoApp或WidgetsApp），并处理需要显式Localizations包裹的独立组件（如TextField和CupertinoTabBar）。支持...

使用ARB文件和代码生成实现Flutter应用的多语言支持。配置pubspec.yaml添加flutter_localizations和intl依赖，然后定义l10n.yaml文件启用gen-l10n代码生成器。将本地化字符串存储在应用资源包(.arb)JSON文件中；模板文件定义所有键，特定语言文件提供翻译。通过向MaterialApp或CupertinoApp添加AppLocalizations.delegate和平台特定委托来集成本地化...

使用StatefulWidget、MVVM和Provider管理Flutter中的临时状态和应用级状态。区分临时状态（单个widget，使用setState()管理）和应用状态（跨widget共享，使用MVVM和provider包管理）。通过单一数据源实现单向数据流：Model处理数据，ViewModel通过ChangeNotifier管理UI状态，View消费并展示状态。提供MVVM实现的顺序工作流：定义Repository，创建...

跨平台原生互操作能力，适用于Android、iOS和Web端的Flutter应用。提供决策逻辑以选择最优集成策略：针对C/C++代码使用FFI，针对操作系统特定API使用平台通道，针对原生UI组件使用平台视图，针对Web端使用JS互操作。采用基于构建钩子（Flutter 3.38+）的现代FFI架构，支持原生工具链编译与Dart绑定，并实现异步平台通道（MethodChannel），完整支持Kotlin和Swift...

通过系统性能分析和针对性优化，识别并消除Flutter应用中的性能瓶颈。提供决策树诊断UI线程、Raster（GPU）线程或两者同时出现的卡顿问题，并给出具体修复方案。包含使用traceAction和TimelineSummary的集成测试模板，用于建立性能基线并测量帧预算。涵盖UI优化（局部化状态、const构造函数、StringBuffer使用）和Raster优化（替换Opacity...

在 Android、iOS、macOS 和 Web 平台上将原生视图和 Web 内容嵌入 Flutter 应用。支持 Android 混合合成（原生保真度）和纹理层（Flutter 性能）、iOS/macOS 混合合成，以及 Web 全屏或嵌入式多视图模式。提供完整的 Dart 和原生代码模板（Android 使用 Kotlin，iOS/macOS 使用 Swift，Web 使用 JavaScript），并采用工厂注册模式。需要预先通过决策树确定目标平台和嵌入方式...

使用原生互操作、方法通道、FFI集成和联邦架构搭建Flutter插件。根据原生代码需求和团队结构，生成标准插件、FFI插件或联邦多包架构。配置Android v2嵌入生命周期接口、平台特定原生环境（Kotlin/Java、Swift/Objective-C）以及方法通道注册。实现包分离的联邦插件，包含面向应用和平台特定的部分...

查找 Flutter PR 上失败的检查项，并定位对应的 LUCI 日志 URL。

使用分析工具和缩减策略，跨平台测量并优化Flutter应用包体积。通过--analyze-size标志生成详细的体积分析JSON文件，识别导致臃肿的大型包、库和资源。利用DevTools应用体积工具进行可视化与构建对比，支持树图检查和差异功能以追踪优化进度。支持Android（APK/AAB）、iOS及桌面平台，并提供平台特定工作流，包括iOS应用...

在Flutter应用中实现屏幕间导航、处理深度链接以及管理数据传递。根据应用需求评估并选择最优路由策略：简单流程使用命令式Navigator，深度链接和Web支持使用声明式Router/go_router，独立子流程使用嵌套Navigator。支持通过构造函数参数（推荐）或RouteSettings进行类型安全的参数提取，实现路由间的数据传递。通过MaterialApp.routes或...实现命名路由。

自动完成Flutter桌面开发的Linux环境配置，包含依赖安装与验证流程。涵盖三个核心工作流程：安装系统依赖（构建工具、GTK库、C/C++工具链）、通过flutter doctor验证环境、以及准备用于分发的Snap包。提供适用于Debian/Ubuntu系统的即用命令，并包含针对ChromeOS Linux容器的条件配置。附带基础的snapcraft.yaml模板用于...

自动化的macOS环境配置，用于Flutter开发，包含Xcode和CocoaPods设置。指导安装和链接Xcode命令行工具、接受开发者许可、以及CocoaPods依赖管理。包含使用flutter doctor和flutter devices的验证工作流，以确认环境正确配置和macOS桌面识别。提供常见问题的故障排除步骤，包括缺失命令行工具、CocoaPods路径问题和桌面支持...

为Flutter开发自动配置Windows环境，包括SDK、工具链和平台设置。指导SDK安装、PATH配置，并通过flutter doctor验证依赖项。涵盖Windows桌面编译所需的Visual Studio C++工作负载配置，以及Android模拟器/设备设置。包含构建发布二进制文件、打包含必要DLL的分发归档、生成MSIX部署自签名证书的工作流程。提供逐步...

Configure `MaterialApp.router` using a package like `go_router` for advanced URL-based navigation. Use when developing web applications or mobile apps that…

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when…

为Flutter状态管理实现MVVM和单向数据流模式。提供决策逻辑以区分临时状态（通过setState管理的本地UI状态）和应用状态（通过MVVM和provider包管理的共享状态）。强制严格分离关注点：数据层（作为单一真实来源的Repository）、逻辑层（继承ChangeNotifier的ViewModel）和UI层（不可变状态的纯函数）。包含实现MVVM模式的完整代码示例...

为Flutter应用生成单元测试、组件测试、集成测试和插件测试，具备架构感知能力。分析目标代码以确定合适的测试类型（逻辑层用单元测试、UI层用组件测试、端到端用集成测试、原生代码用插件测试）。提供每个测试类别的决策树和逐步实现模式，包括模拟/桩对象设置和断言策略。包含可直接使用的代码模板，涵盖ViewModel、Repository、组件以及完整应用流程，并带有适当的...

适用于Flutter应用的全面测试框架，涵盖单元测试、组件测试和集成测试三个层级。包含三类测试：针对独立逻辑的单元测试、针对UI组件的组件测试，以及在真实设备或模拟器上进行的端到端集成测试。提供针对ViewModel、Repository、Service和View的架构测试模式，强调使用Fake实现而非模拟对象以实现更简洁的测试设计。包含结合Dart测试与原生代码的插件测试指南...

将Flutter应用从Material 2迁移至Material 3，自动更新组件与主题。通过决策树识别并替换已弃用的Material 2组件（FlatButton、RaisedButton、BottomNavigationBar、Drawer）为Material 3对应组件。将旧版主题属性转换为Material 3的ColorScheme，移除已弃用的强调色引用（如accentColor、accentColorBrightness等）。统一所有组件主题使用*ThemeData类，并确保useMaterial3:...

使用Material 3主题为Flutter应用提供全局样式和自适应设计模式。涵盖Material 3配色方案、排版、高度以及现代组件替换（NavigationBar、FilledButton、SegmentedButton）。包括使用*ThemeData类进行组件主题标准化，以及针对accentColor和AppBarTheme.color等遗留属性的弃用指导。提供平台特定的自适应模式：滚动条可见性、可选文本、按钮顺序（Windows vs....）

Use the `http` package to execute GET, POST, PUT, or DELETE requests. Use when you need to fetch from or send data to a REST API.

适用于Flutter应用的SQLite与离线优先数据层架构，支持结构化本地持久化。将数据层划分为无状态服务（原始数据封装器）和业务逻辑仓库（每个领域实体的单一数据源）。实现离线优先同步：读取时立即返回本地缓存数据，随后获取远程更新；写入时先保存至本地，再尝试通过后台队列回退进行API同步。涵盖SQLite配置与安全参数化查询、领域...

该技能提供了genui仓库专属的工作流程和最佳实践。

对用户的计划或设计进行深入追问，直到达成共识，解决决策树的每个分支。当用户想要……时使用。

当用户要求集成genui包并通过Firebase AI Logic启动简单对话时，使用此技能。

根据Google指南校对Markdown文件。

重新构建Flutter工具和CLI。当用户要求编译、更新、重新生成或重新构建Flutter工具或CLI时使用。

在本地提交更改或审查PR之前，务必暂存站点并确保一切运行正常。请按以下步骤暂存站点：

在编写实现代码之前，用于实现任何功能或修复错误时使用

更新并维护llms.txt文件。当用户想要添加章节、添加链接、更正信息或审查llms.txt文件时使用。

在Flutter Web引擎和/或框架测试中升级浏览器版本（Chrome或Firefox）。当被要求将Chrome或Firefox升级到更新版本时使用。

确保所有更改的代码片段正确运行并同步到 Markdown 文件中。