Flutter

发版流水线。用户说"发版"、"build release"、"打 release 包"时触发。 bump version → changelog → 三端 build → 输出产物路径。

代码评审流水线。用户说"评审一下"、"检查代码"、"PR 评审"时触发。跑 health-check + lint-fix + review + perf-audit + test-gen,输出 docs/review/{date}.md。

连接 Flutter Copilot MCP，支持自动读取 VM Service URI、截图、交互、热重载，以及需要重启时自动调用脚本重连

Project-specific Flutter hybrid development skill for gffltsc, flutter_shared, and flutter-shell-app. Use when working on Flutter page migration, FlutterBoost route boundaries, shared business modules, shell debugging, host bridge/runtime contracts, global components, theme tokens, loading states, navigation, i18n, automated UI test IDs, or Flutter production fallback/rollback in this repository.

Flutter 开发最佳实践指南，涵盖架构、依赖管理、UI 开发、平台配置。当用户提到"最佳实践"、"架构"、"Riverpod"、"GoRouter"、"Dio"、"主题"、"响应式"、"无障碍"时使用此 skill。

该规则解释了 Flutter 小部件模式和跨平台移动开发的最佳实践。

Flutter 行動應用的測試驅動開發（TDD）專家指引。 適用情境：用戶詢問 Flutter 測試、TDD 工作流程、unit/widget/integration test 撰寫、 mock 依賴、BLoC/Riverpod/Clean Architecture 可測試性設計、golden test、 測試覆蓋率、Flutter CI/CD 設定。 觸發關鍵字：「flutter test」、「tdd flutter」、「widget test」、「mockito flutter」、 「bloc_test」、「integration test flutter」、「flutter 怎麼測試」、「Flutter 測試策略」、 「flutter unit test」、「flutter golden test」。 當用戶貼上 Flutter 程式碼並詢問如何讓它可測試時，也應觸發此 Skill。

用于在 macOS 上清除 Flutter 环境变量 (FLUTTER_STORAGE_BASE_URL 和 PUB_HOSTED_URL)。适用于需要重置环境或解决 Flutter 代理问题的场景。

库无关的Flutter/Dart代码审查清单，涵盖Widget最佳实践、状态管理模式（BLoC、Riverpod、Provider、GetX、MobX、Signals）、Dart惯用法、性能、可访问性、安全性和整洁架构。

Flutter项目开发规范与技术选型指南。在编写Flutter代码、添加新功能、选择第三方库或进行架构设计时调用此技能，以确保代码符合项目预定的技术选型（如GetX、Dio、Hive等）。

Flutter 四工具联合测试：Marionette MCP（16 tools）+ Dart MCP（25 tools）+ Mobile MCP（21 tools）+ Codex CLI。 Marionette tap by text、热重载循环、widget tree 检查、录屏、截图存档、多语言测试。 触发关键字：marionette、mcp 测试、热重载、flutter driver、widget tree、录屏、截图对比

Multi-layer verification flow after Flutter code changes: static analysis + tests + widget tree check + runtime error detection. Run after edits before claiming the change works. Triggers (English): verify changes, flutter verify, flutter analyze, widget tree check, runtime error detection, post-edit verification. 改完代碼後的多層驗證流程。靜態分析 + 跑測試 + widget tree 檢查 + runtime error 檢測。 觸發詞（中文）：verify、驗證、確認改動

Scaffold and modify features in a flutter_arms project (Clean Architecture + MVVM + Riverpod 3 + AutoRoute + Retrofit + Freezed + hive_ce + slang). Use this skill whenever the user asks to add, modify, rename, or extend a feature — including new pages, new API endpoints, new ViewModels/Notifiers, new entities/DTOs, new routes, new i18n keys, or new Retrofit datasources. Also use it when the request is phrased as "添加登录页", "add a settings screen", "wire up /users API", "新增 feature", "写一个 profile 页", "make a search module", or anything that touches data/domain/presentation layers. Do NOT write generic Flutter code in this project — flutter_arms has its own Result<T>, Failure, .asApi() conventions that must be followed. Apply this skill proactively even when the user doesn't say "feature" explicitly, as long as the change involves any of: Riverpod providers, AutoRoute pages, Retrofit interfaces, Hive storage, Freezed states, slang i18n, or Clean Architecture layers.

Write and debug tests for a flutter_arms project using flutter_test + mocktail + ProviderContainer + TranslationProvider. Use this skill whenever the task involves tests in a flutter_arms project — writing a unit test, widget test, repository test, ViewModel test, debugging a failing test, understanding an architecture_test failure, adding a test-helper, setting up fixtures with mocktail, or overriding Riverpod providers for tests. Also triggered by: "write a test for this", "this test is failing", "mock the repository", "ProviderContainer", "testWidgets", "给这个加个测试", "架构测试报错", "the architecture test is red". Do NOT use mockito (not on the deps list), do NOT hand-roll fake notifiers, do NOT instantiate Notifiers with `new` outside a ProviderContainer. Apply proactively when the user shows test code or mentions any testing concept, even if they don't explicitly say "skill".

用 flutter_skill 连接正在 debug 运行的 Flutter 应用（真机 / 模拟器 / 桌面），做 UI 探查、tap/输入/滑动/断言/截图与 AI 驱动 E2E 自动化。在真机或模拟器上把 app 跑起来后，凡是要做界面交互或自动化验证，优先用本工具（`inspect` + `act`，或 MCP），而不是让用户手点、也不是只靠读代码猜。内含全部 CLI 命令与 MCP 工具用法速查。不适用于纯单元 / Widget 测试（那些用 `flutter test`，参考 flutter-add-widget-test / flutter-add-integration-test）。

Flutter 通过 home_widget 把 1Hz 实时值（如倒计时）推到 Android 桌面 AppWidget 的端到端架构。当用户提到 home_widget 不同步、桌面小组件不刷新、appwidget 实时值、widget 显示卡死、widget 进程被杀场景、AppWidgetProvider 找不到时触发。

flutter的开发操作流程,在dart-flutter任何问题都需要优先加载这个SKILL

專為 Flutter 應用量身打造的自動化測試腳本生成 Skill。從 Google Sheet TC、JIRA 票號或功能描述生成可執行的 Dart 測試腳本，涵蓋 Unit Test（flutter_test）、Widget Test（WidgetTester）、Integration Test（integration_test）、Golden Test、Platform Channel Test。採用 Fake-over-Mock 原則、Robot Pattern / Page Object Model、Mocktail/Mockito 策略，並整合 Firebase Test Lab、`flutter test --coverage` 覆蓋率工具。當使用者提到「Flutter 自動化」、「寫 Dart 測試」、「把 Flutter TC 轉成程式碼」、「widget test 自動化」、「integration_test 腳本」、「Flutter UI test」、「patrol 測試」、「Golden test 自動化」，或針對 Flutter/Dart 專案要求生成自動化腳本時使用。與 test-automation 並存：test-automation 適用原生 iOS (XCUITest) / Android (Espresso)，flutter-test-automation 適用 Flutter/Dart 專案或 Flutter+Native 混合。

用于解决 Flutter 离线 TTS (如 libsherpa-onnx) 因 Windows Git 自动换行符转换 (CRLF) 导致的 Native C++ 崩溃，以及 Android WebView 调用 SpeechSynthesis API 时因底层服务缺失导致的进程闪退问题。

用于解决 Flutter WebView 在部分 Android 设备（尤其是使用 Mali GPU 的设备如荣耀、华为等）上的渲染闪退、黑屏或卡死问题；通过永久禁用 Impeller 并将 WebView 的底层渲染模式切换为 Hybrid Composition 混合构成来解决 EGL/gralloc 纹理共享冲突。Use when diagnosing and resolving Flutter WebView rendering crashes, black screens, or freezes on Android devices, especially Mali GPU devices (e.g. Honor, Huawei). Standardizes disabling Impeller and enabling WebView Hybrid Composition.

Flutter MCP 測試流程。定義如何使用 dart-tooling 和 mobile-mcp 進行靜態分析、unit/widget test、UI 自動化測試。Use when testing Flutter apps with MCP tools.

Flutter/Dart 应用开发技能。触发：Flutter/Dart/Widget/Material/Cupertino/创建工程/dart analyze/RenderFlex/NoSuchMethodError/flutter test/文档搜索/知识库

Flutter 项目中国环境部署加速专家。用于在 Flutter 项目初始化、部署和运行时配置国内镜像加速。当用户需要：(1) 初始化 Flutter 项目并配置中国镜像加速 (2) 解决 Flutter 依赖下载慢的问题 (3) 配置 Gradle/Maven 国内镜像 (4) 快速部署 Flutter 项目到手机/模拟器 时使用此 Skill。

Flutter/Dart 项目代码审查规则，聚焦 Widget 生命周期、状态管理、异步资源释放与空安全问题。

顶级Flutter工程师，专注像素级截图复刻。用户一旦上传App截图或设计稿并表达转代码意图（如"复刻UI""把图变成Flutter""照着这个写"等），须立即触发。以外科手术级精度提取视觉元素，生成可直接运行的Flutter代码，适配iOS/Android手机及平板。拒绝近似，摒弃估算，绝不遗漏。

库无关的Flutter/Dart代码审查清单，涵盖Widget最佳实践、状态管理模式（BLoC、Riverpod、Provider、GetX、MobX、Signals）、Dart惯用法、性能、可访问性、安全性和整洁架构。

为中国区开发者在新电脑上搭建完整 Flutter 开发环境，覆盖 Android/iOS toolchain、镜像配置、诊断和验收。用户提到安装 Flutter、中国区镜像、修复 flutter doctor、或新 macOS 初始化 Flutter 环境时使用。

Flutter 跨平台移动开发技能。覆盖 Flutter 入门、Material 3 迁移、布局约束、动画 （Hero/Staggered）、自适应响应式布局、平台适配、大型屏幕支持、State 管理方案对比、 持久化、网络请求、性能优化。当用户提到 Flutter、Dart、移动开发、跨平台、Material Design、 Flutter Widget、热重载、StatelessWidget、StatefulWidget、setState、Provider、Riverpod、 BLoC、布局约束、BoxConstraints、动画、Animation、Hero、Staggered、响应式、自适应时触发。

在 Flutter 项目中封装 Hive 本地数据库服务，遵循 Repository 模式和 MVVM 架构。当用户需要使用 Hive 数据库、本地持久化存储、离线数据缓存、或提到 hive、本地数据库、数据持久化时使用。支持三种独立模式：创建数据服务、创建数据库操作、创建数据模型并自动注入 CRUD。

Flutter GetX 三层架构规范。core + shared + modules 纵向分层，业务模块 GetX 化。适用于新模块创建、目录设计、代码评审。支持 scaffold 搭建目录结构。