Flutter技能

在 dart_skills_lint 中新增驗證規則與 CLI 旗標的說明。

當使用者要求在一個使用 JSON Schema 定義的應用程式中，根據該定義建立新的 CatalogItem、資料類別和/或 widget 類別時，使用此技能。

建議優先使用多行字串（ ''' ）而非透過 + 和 \n 拼接字串，特別是在處理 SQL 查詢、HTML 或 PEM 編碼金鑰等大型文字區塊時。這樣能提升可讀性，並透過自然換行避免 lines_longer_than_80_chars 的 lint 錯誤。

若要尋找適合遷移的候選項目，請使用以下搜尋策略：

保持你的入口檔案（例如 bin/my_app.dart）內容精簡。這能透過將邏輯與程序執行器解耦來提升可測試性。

為了找出文件中的問題：

解析 Dart 和 Flutter 測試日誌中的失敗資訊。

找出超過限制的行：

為了找出改善匹配器使用的候選項目，請搜尋次優模式：

為了尋找現代化的候選對象：

遵循Dart團隊最佳實踐來維護Dart套件的指南。

使用 dart_skills_lint CLI 驗證技能。根據您的環境選擇合適的工作流程：

在 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系統為專案新增互動式Widget預覽。在建立新的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 及具備 App Groups 功能的 Widget Extension 目標；Android 則使用 Android Studio 搭配 AppWidgetProvider、XML 佈局等。

使用動畫框架為 Flutter 應用程式提供視覺回饋、轉場效果及基於物理的動畫。四種動畫策略：用於簡單屬性變化的隱式動畫、具播放控制的顯式動畫、用於路由間共享元素的 Hero 轉場，以及用於手勢驅動自然運動的物理動畫。核心型別動畫系統包含 AnimationController、Tween 和 Curve 類別；務必釋放控制器以避免記憶體洩漏。交錯動畫...

根據您的UI需求選擇並實作最佳的Flutter動畫策略。包含決策樹，協助在隱式動畫、顯式補間、物理運動、英雄轉場、交錯序列與頁面路由轉場之間做出選擇。提供每種動畫類型的完整程式碼範例，從簡單的AnimatedContainer到複雜的交錯多補間設定。透過強制性的AnimationController釋放與效能最佳實務，執行嚴格的記憶體管理...

測量並優化 Flutter 應用程式套件、APK 或 IPA 的大小，提供平台專屬的分析與縮減策略。支援 Android（APK/AppBundle）、iOS（IPA）以及桌面平台（Linux、macOS、Windows），並具備平台特定的測量流程。透過 flutter build --analyze-size 生成程式碼大小分析 JSON 檔案，並整合 Dart DevTools 的 App Size Tool 進行元件分解視覺化。透過除錯資訊分割、資源壓縮等方式實現大小縮減。

使用推薦的分層架構（UI、邏輯、資料）來設計 Flutter 應用程式。適用於建構新專案或重構以提升可擴展性。

適用於可擴展Flutter應用的分層架構框架，嚴格關注點分離。強制採用三層結構（UI、邏輯、數據），實現單向數據流，並在數據層中維持單一事實來源。UI層包含精簡的視圖和視圖模型，將領域模型轉換為呈現狀態；邏輯層（可選）處理複雜的業務編排；數據層嚴格劃分為無狀態服務和緩存存儲庫。提供逐步功能...

適用於 Flutter 應用程式的 MVVM 架構，具備單向資料流與嚴格的層級分離。實作三層架構：資料層（服務與儲存庫）、領域層（用於複雜邏輯的使用案例）以及 UI 層（檢視模型與檢視）。使用 provider 進行依賴注入，並透過 ListenableBuilder 搭配命令模式實現反應式 UI 更新與使用者互動。強制執行單向資料流：資料從儲存庫向下流向檢視模型，再流向檢視；事件則向上流動...

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>來管理表單狀態與跨重建的驗證。使用TextFormField元件，並透過validator()回呼函式在驗證失敗時返回錯誤字串，成功時返回null。提交時呼叫_formKey.currentState!.validate()觸發所有驗證器，並自動在欄位下方顯示錯誤訊息。包含完整程式碼範例，示範使用者名稱...

掌握 Flutter 的約束系統，高效構建響應式且無溢出的佈局。核心原則：約束向下傳遞，尺寸向上傳遞，父層設定位置。切勿在彈性盒子或可滾動區域中傳遞無界約束。使用 Row / Column 處理線性佈局，Expanded / Flexible 分配空間，Stack 處理重疊元素，SizedBox 設定嚴格約束。運用 LayoutBuilder 實現響應式尺寸調整，或透過條件渲染實現跨手機、平板等裝置的自適應佈局。

建立並實作跨平台Flutter外掛，支援Android、iOS、Windows及網頁的原生互通。支援標準外掛（透過Method Channels存取平台API）與FFI外掛（C/C++原生函式庫）；可根據需要平台特定SDK存取或直接原生程式碼繫結來選擇。聯邦式外掛架構將API拆分為應用程式端、平台介面及獨立平台實作套件，適合團隊開發。包含逐步...

針對 Flutter 應用程式提供全面的快取與效能最佳化，支援多種資料類型與平台。包含決策邏輯以選擇適當的快取機制：記憶體內快取、用於鍵值對的 shared_preferences、用於關聯式資料的 SQLite、用於大型資料區塊的檔案系統，以及用於網路圖片的圖片快取。內建基於串流的離線優先儲存庫模式，先回傳快取資料，再從網路擷取並更新。涵蓋 Android FlutterEngine 預先暖機及...

針對 Flutter 應用程式的本地資料快取與離線優先同步模式。涵蓋五種快取策略：用於 UI 狀態的 shared_preferences、用於結構化資料的 SQLite/Hive、用於二進位媒體的檔案系統、用於導航的狀態還原，以及 Android 上的 FlutterEngine 預熱。透過串流實現離線優先的儲存庫（先輸出本地資料、再擷取遠端資料、最後更新快取），並採用雙重寫入策略（僅限線上模式 vs. 離線優先搭配背景同步）。最佳化圖片快取...

背景 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 嵌入現有網頁應用程式，並...

Linux環境設定，適用於Flutter桌面開發，包含作業系統偵測與工具鏈驗證。自動偵測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 overflowed」、「Vertical…」等問題。

建立具備驗證功能的表單

將CPU密集型任務卸載到後台隔離區，同時保持Flutter UI的響應性。提供三種並發模式：用於I/O密集型工作的async/await、用於一次性重度計算的Isolate.run()，以及帶消息傳遞的Isolate.spawn()用於持久後台工作。包含一個決策矩陣，可根據任務類型（I/O密集型 vs. 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序列化與反序列化。針對超過16ms的負載，透過compute()將大型JSON解析卸載至背景隔離區，避免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 小工具的語意標註模式，以向輔助工具暴露小工具樹結構。包含針對網頁的啟用語意層（預設為效能考量而停用）的指引，以及...

從 Flutter 程式碼存取 Android、iOS 及網頁上的裝置專屬原生 API。支援三種整合方式：FFI 用於直接繫結 C/C++、平台通道（搭配 Pigeon 確保型別安全）用於呼叫 Kotlin/Swift/Objective-C，以及平台視圖用於嵌入原生 UI 元件。FFI 使用 dart:ffi，並透過 build.dart 鉤子自動編譯建置；需使用 extern "C" 符號及 package:ffigen 產生 Dart 繫結。平台通道提供非同步訊息傳遞...

透過組合小部件、管理約束條件以及適應螢幕尺寸，來建構響應式 Flutter 佈局。提供決策樹，根據內容維度、重疊、滾動及響應需求，選擇合適的基礎佈局小部件（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 檔案中；範本檔案定義所有鍵值，而特定語系檔案則提供翻譯。透過新增 AppLocalizations.delegate 與平台專屬委派，將本地化功能整合至 MaterialApp 或 CupertinoApp 中...

在Flutter中使用StatefulWidget、MVVM和Provider管理瞬時狀態與應用層級狀態。區分瞬時狀態（單一widget，使用setState()管理）與應用狀態（跨widget共享，使用MVVM和provider套件管理）。透過單一事實來源實現單向資料流：Model處理資料，ViewModel透過ChangeNotifier管理UI狀態，View消費並顯示狀態。提供MVVM實作的循序工作流程：定義Repository、建立...

跨平台原生互操作性，適用於 Android、iOS 及 Web 上的 Flutter 應用程式。提供決策邏輯以選擇最佳整合策略：針對 C/C++ 程式碼使用 FFI、針對作業系統特定 API 使用 Platform Channels、針對原生 UI 元件使用 Platform Views，以及針對網頁使用 JS Interop。採用現代 FFI 架構，透過建置掛鉤（Flutter 3.38+）搭配原生工具鏈編譯與 Dart 繫結，支援非同步 Platform Channels（MethodChannel），並完整支援 Kotlin 與 Swift...

透過系統性剖析與針對性優化，識別並消除 Flutter 應用中的效能瓶頸。提供決策樹以診斷 UI 執行緒、Raster（GPU）執行緒或兩者同時發生的卡頓問題，並針對每種情況提供具體修復方案。包含使用 traceAction 與 TimelineSummary 建立效能基準並測量幀預算的整合測試模板。涵蓋 UI 優化（局部化狀態、const 建構子、StringBuffer 使用）與 Raster 優化（取代 Opacity...

在 Android、iOS、macOS 及網頁平台上，將原生視圖與網頁內容嵌入 Flutter 應用程式。支援 Android 混合合成（原生保真度）與紋理圖層（Flutter 效能）、iOS/macOS 混合合成，以及網頁全頁面或嵌入式多視圖模式。提供完整的 Dart 與原生程式碼範本（Android 使用 Kotlin、iOS/macOS 使用 Swift、網頁使用 JavaScript），並搭配工廠註冊模式。需事先透過決策樹判斷目標平台與嵌入方式...

以原生互操作、方法通道、FFI整合及聯邦式架構搭建Flutter插件。根據原生程式碼需求與團隊結構，生成標準插件、FFI插件或聯邦式多套件架構。配置Android v2嵌入生命週期介面、平台專屬原生環境（Kotlin/Java、Swift/Objective-C）及方法通道註冊。實作套件分離的聯邦式插件，包含應用端與平台專屬...

在 Flutter PR 上找出失敗的檢查，並定位對應的 LUCI 日誌網址。

使用分析工具和縮減策略，跨平台測量並優化 Flutter 應用程式套件大小。透過 --analyze-size 標記生成詳細的大小分析 JSON 檔案，識別導致臃腫的大型套件、函式庫和資源。利用 DevTools 應用程式大小工具進行視覺化與建置比較，支援樹狀圖檢視和差異功能以追蹤優化進度。支援 Android（APK/AAB）、iOS 和桌面平台，並提供平台專屬工作流程，包括 iOS 應用程式...

在 Flutter 應用中進行螢幕導航、處理深度連結以及管理資料傳遞。根據應用需求評估並選擇最佳路由策略：使用命令式 Navigator 處理簡單流程、宣告式 Router / go_router 支援深度連結與網頁應用，或採用巢狀 Navigator 處理獨立子流程。支援透過建構子參數（建議方式）或 RouteSettings 搭配型別安全的參數提取來進行路由間的資料傳遞。透過 MaterialApp.routes 或... 實作命名路由。

自動化Linux環境設置，用於Flutter桌面開發，包含依賴安裝與驗證工作流程。涵蓋三個核心工作流程：安裝系統依賴（建置工具、GTK函式庫、C/C++工具鏈）、透過flutter doctor驗證環境，以及準備Snap套件進行發布。提供適用於Debian/Ubuntu系統的即用命令，並包含ChromeOS Linux容器的條件式設置。內含基礎snapcraft.yaml範本，用於...

自動化macOS環境配置，用於Flutter開發，包含Xcode與CocoaPods設定。引導安裝並連結Xcode命令列工具、接受開發者授權，以及CocoaPods相依性管理。包含使用flutter doctor與flutter devices的驗證流程，以確認環境正確設定及macOS桌面辨識。提供常見問題的疑難排解步驟，包括缺少命令列工具、CocoaPods路徑問題及桌面支援等。

自動化Windows環境設置，用於Flutter開發，包含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、儲存庫、元件及完整應用程式流程，並包含適當的...

適用於 Flutter 應用程式的全面測試框架，涵蓋單元測試、Widget 測試與整合測試三個層級。包含三種測試類別：針對獨立邏輯的單元測試、針對 UI 元件的 Widget 測試，以及在真實裝置或模擬器上執行的端到端流程整合測試。提供 ViewModel、Repository、Service 與 View 的架構測試模式，強調使用 Fake 實作而非 Mock 以達成更簡潔的測試設計。內含結合 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 與...）。

使用

SQLite 與離線優先資料層架構，適用於 Flutter 應用程式，具備結構化本地持久化能力。將資料層拆分為無狀態服務（原始資料包裝器）與業務邏輯儲存庫（每個領域實體的單一事實來源）。實作離線優先同步：讀取時立即回傳快取的本地資料，再擷取遠端更新；寫入時先儲存至本地，再嘗試 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 檔案中。