F
Flutter技能
ego lite browser
贊助ego lite 是 AI 代理執行網頁自動化最快的瀏覽器,可與 Codex 或 Claude Code 共享您的登入狀態,零成本、零配置。
Alpha Vantage MCP Server
贊助獲取金融市場數據:即時與歷史股票、ETF、期權、外匯、加密貨幣、大宗商品、基本面、技術指標等
add-dart-lint-validation-rule
flutter
在 dart_skills_lint 中新增驗證規則與 CLI 旗標的說明。
official
add-missing-unit-test
flutter
為目前缺少單元測試的類別新增測試,或為現有測試檔案新增測試案例,使用 Kover 驗證改善。
official
adding-changelog-entries
flutter
用於在 devtools_shared、devtools_app_shared 或 devtools_extensions 的 CHANGELOG.md 文件中記錄變更時使用。
official
adding-copyright-headers
flutter
根據檔案類型為檔案新增版權標頭。在建立新檔案或需要驗證版權標頭時使用。
official
adding-copyright-headers
flutter
根據檔案類型為檔案新增版權標頭。在建立新檔案或需要驗證版權標頭時使用。
official
adding-release-notes
flutter
在 DevTools 發行說明中新增使用者面向的變更描述。用於在 NEXT_RELEASE_NOTES.md 檔案中記錄改進、修正或新功能。
official
adding-release-notes
flutter
將使用者可見的變更描述新增至 DevTools 發行說明。在記錄 NEXT_RELEASE_NOTES.md 檔案中的改進、修正或新功能時使用。
official
analyze-github-flake
flutter
專精於分析 flutter/flutter 儲存庫中的 flaky GitHub issues。當使用者想要分析特定 flutter 連結的 flakiness 時使用…
official
analyze-github-flake
flutter
專精於分析 flutter/flutter 儲存庫中的 flake GitHub 問題。當使用者想要分析特定連結的 flutter 不穩定性時使用…
official
api-review
flutter
根據規範的 API 設計指南審查指定的程式碼。當使用者要求進行 API 審查或檢查程式碼是否符合 API 設計時,請使用此技能。
official
audit-accessibility
flutter
確保外掛程式的自訂UI元件對使用螢幕閱讀器及其他輔助技術的使用者可存取。
official
audit-dependencies
flutter
Optimize plugin size and security by removing unused dependencies and updating outdated libraries.
official
audit-ui-thread-safety
flutter
防止UI凍結並確保流暢的使用者體驗,透過驗證執行緒規則並將阻塞呼叫從事件分派執行緒(EDT)移出。
official
authoring-skills
flutter
引導為代理工作流程創建高質量、有效的技能。在 .agents/skills/ 目錄中創建或修改技能時使用。
official
cleanup-code-inspections
flutter
透過系統性地解決靜態分析警告,減少技術債並提升程式碼品質。
official
cleanup-unused-assets
flutter
Reduce plugin size by scanning resources/icons and removing unreferenced assets.
official
closing-obsolete-issues
flutter
Find and close obsolete, stale, or not reproducible issues in the flutter/devtools repository.
official
closing-obsolete-issues
flutter
在 flutter/devtools 儲存庫中尋找並關閉過時、陳舊或無法重現的問題。
official
code-documentation
flutter
編寫有效程式碼文件的指南,包括 docstrings、JSDoc、dartdoc 和實作註解。在編寫新程式碼、新增…時使用此技能。
official
code-review
flutter
對拉取請求或本地程式碼變更執行全面、多步驟的程式碼審查,透過疊代優化(生成、評析、綜合)以確保…
official
code-review
flutter
針對目前的diff或git變更,以嚴謹且多角度的方式,對照風格指南與軟體工程最佳實務進行程式碼審查。
official
code-review
flutter
對當前的 diff 或 git 變更進行嚴謹、多角度的程式碼審查,對照風格指南與軟體工程最佳實踐。
official
code-review
flutter
對拉取請求或本地程式碼變更執行全面、多步驟的程式碼審查,透過疊代優化(生成、評析、綜合)以確保…
official
create-catalog-item
flutter
當使用者要求根據JSON Schema定義在應用程式中建立新的CatalogItem、data class和/或widget class時,使用此技能…
official
create-catalog-item
flutter
當使用者要求在一個使用 JSON Schema 定義的應用程式中,根據該定義建立新的 CatalogItem、資料類別和/或 widget 類別時,使用此技能。
official
dart-add-unit-test
flutter
Write and organize unit tests for functions, methods, and classes using `package:test`. Use when creating new logic or fixing bugs to ensure code remains…
official
dart-best-practices
flutter
建議優先使用多行字串( ''' )而非透過 + 和 \n 拼接字串,特別是在處理 SQL 查詢、HTML 或 PEM 編碼金鑰等大型文字區塊時。這樣能提升可讀性,並透過自然換行避免 lines_longer_than_80_chars 的 lint 錯誤。
official
dart-build-cli-app
flutter
入口點結構、退出碼、跨平台腳本。在構建命令列工具、腳本或應用程式時使用。
official
dart-checks-migration
flutter
若要尋找適合遷移的候選項目,請使用以下搜尋策略:
official
dart-cli-app-best-practices
flutter
保持你的入口檔案(例如 bin/my_app.dart)內容精簡。這能透過將邏輯與程序執行器解耦來提升可測試性。
official
dart-collect-coverage
flutter
使用 coverage 套件收集覆蓋率並產生 LCOV 報告
official
dart-doc-validation
flutter
為了找出文件中的問題:
official
dart-fix-runtime-errors
flutter
使用 get_runtime_errors 和 lsp 取得作用中的堆疊追蹤,定位失敗的行,套用修正,並透過 hot_reload 驗證解決結果。
official
dart-generate-test-mocks
flutter
Define and generate mock objects for external dependencies using `package:mockito` and `build_runner`. Use when unit testing classes that depend on complex…
official
dart-log-failure-parser
flutter
Parse failures from Dart and Flutter test logs.
official
dart-log-failure-parser
flutter
解析 Dart 和 Flutter 測試日誌中的失敗資訊。
official
dart-long-lines
flutter
找出超過限制的行:
official
dart-matcher-best-practices
flutter
為了找出改善匹配器使用的候選項目,請搜尋次優模式:
official
dart-migrate-to-checks-package
flutter
Replace the usage of `expect` and similar functions from `package:matcher` to `package:checks` equivalents.
official
dart-modern-features
flutter
為了尋找現代化的候選對象:
official
dart-package-maintenance
flutter
遵循Dart團隊最佳實踐來維護Dart套件的指南。
official
dart-resolve-package-conflicts
flutter
Workflow for fixing package version conflicts. Use this when `pub get` fails due to incompatible package versions.
official
dart-run-static-analysis
flutter
Execute `dart analyze` to identify warnings and errors, and use `dart fix --apply` to automatically resolve mechanical lint issues. Use during development to…
official
dart-setup-ffi-assets
flutter
引導代理使用 Dart 的 Native Assets 鉤子系統,將 C/C++ 原始碼編譯和打包為動態或靜態庫(Code Assets)(透過…
official
dart-skills-lint-integration
flutter
如何在儲存庫中整合、更新及設定 dart_skills_lint 驗證工具。每當使用者要求更新時,請務必使用此技能…
official
dart-skills-lint-setup
flutter
當您需要首次在 Dart 專案中為 AI 代理技能設定驗證時,使用此技能。將 linter 新增為 dev_dependency,建立一個…
official
dart-skills-lint-validation
flutter
使用 dart_skills_lint CLI 驗證技能。根據您的環境選擇合適的工作流程:
official
dart-test-coverage
flutter
在 Dart 套件中執行與解讀測試覆蓋率的指南。
official
dart-test-fundamentals
flutter
為了尋找改善測試結構的候選方案:
official
dart-use-ffigen
flutter
Guide agents to use `package:ffigen` to automatically generate FFI bindings instead of writing them manually. Use this skill when a task involves writing new…
official
dart-use-pattern-matching
flutter
在適當的地方使用 switch 表達式和模式匹配
official
dart-use-primary-constructors
flutter
協助使用者撰寫語法與語意正確的 Dart 主要建構子,並遷移/使用新的建構子語法、空主體分號語法、…
official
definition-of-done
flutter
在此儲存庫中處理任何涉及 md 檔案或 dart 程式碼的任務前,必須執行的強制檢查。
official
engine-whats-new
flutter
生成兩個版本之間(例如 3.47 與…)Flutter 引擎 (//engine/src/flutter) 變更的「what's new」發布摘要和差異檔案
official
find-release
flutter
一個用來找出包含指定提交的最低Dart與Flutter版本的技能。每當使用者詢問某個提交何時被納入Flutter或Dart時,請使用此技能…
official
flutter-accessibility
flutter
在 Flutter 應用程式中實作 WCAG 2 與 EN 301 549 無障礙標準及自適應佈局。強制執行語意標註、觸控目標尺寸(最小 48x48 dp)以及文字對比度(小字 4.5:1,大字 3:1),涵蓋行動裝置、網頁與桌面平台。提供網頁語意初始化、互動元件包裝、基於螢幕尺寸的佈局切換,以及鍵盤/滑鼠輸入處理的決策邏輯。包含透過 FocusTraversalGroup 進行的焦點導覽管理,以及...
official
flutter-accessibility-audit
flutter
透過 widget_inspector 觸發無障礙掃描,並自動在原始碼中新增 Semantics 元件或補上遺漏的標籤。
official
flutter-add-integration-test
flutter
配置 Flutter Driver 以進行應用互動,並將 MCP 操作轉換為永久性的整合測試。在為專案加入整合測試時使用,…
official
flutter-add-widget-preview
flutter
使用previews.dart系統為專案新增互動式Widget預覽。在建立新的UI元件或更新現有畫面時使用,以確保…
official
flutter-add-widget-test
flutter
Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating…
official
flutter-adding-home-screen-widgets
flutter
為 Flutter 應用程式在 Android 和 iOS 上新增主畫面小工具,具備原生 UI 與共享資料同步功能。Flutter 透過 home_widget 套件,利用共享本地儲存空間(iOS 使用 UserDefaults,Android 使用 SharedPreferences)與原生小工具通訊;資料從 Flutter 寫入,並在作業系統觸發時由原生小工具讀取。iOS 實作使用 Xcode、SwiftUI 及具備 App Groups 功能的 Widget Extension 目標;Android 則使用 Android Studio 搭配 AppWidgetProvider、XML 佈局等。
official
flutter-animating-apps
flutter
使用動畫框架為 Flutter 應用程式提供視覺回饋、轉場效果及基於物理的動畫。四種動畫策略:用於簡單屬性變化的隱式動畫、具播放控制的顯式動畫、用於路由間共享元素的 Hero 轉場,以及用於手勢驅動自然運動的物理動畫。核心型別動畫系統包含 AnimationController、Tween 和 Curve 類別;務必釋放控制器以避免記憶體洩漏。交錯動畫...
official
flutter-animation
flutter
根據您的UI需求選擇並實作最佳的Flutter動畫策略。包含決策樹,協助在隱式動畫、顯式補間、物理運動、英雄轉場、交錯序列與頁面路由轉場之間做出選擇。提供每種動畫類型的完整程式碼範例,從簡單的AnimatedContainer到複雜的交錯多補間設定。透過強制性的AnimationController釋放與效能最佳實務,執行嚴格的記憶體管理...
official
flutter-app-size
flutter
測量並優化 Flutter 應用程式套件、APK 或 IPA 的大小,提供平台專屬的分析與縮減策略。支援 Android(APK/AppBundle)、iOS(IPA)以及桌面平台(Linux、macOS、Windows),並具備平台特定的測量流程。透過 flutter build --analyze-size 生成程式碼大小分析 JSON 檔案,並整合 Dart DevTools 的 App Size Tool 進行元件分解視覺化。透過除錯資訊分割、資源壓縮等方式實現大小縮減。
official
flutter-apply-architecture-best-practices
flutter
使用推薦的分層架構(UI、邏輯、資料)來設計 Flutter 應用程式。適用於建構新專案或重構以提升可擴展性。
official
flutter-architecting-apps
flutter
適用於可擴展Flutter應用的分層架構框架,嚴格關注點分離。強制採用三層結構(UI、邏輯、數據),實現單向數據流,並在數據層中維持單一事實來源。UI層包含精簡的視圖和視圖模型,將領域模型轉換為呈現狀態;邏輯層(可選)處理複雜的業務編排;數據層嚴格劃分為無狀態服務和緩存存儲庫。提供逐步功能...
official
flutter-architecture
flutter
適用於 Flutter 應用程式的 MVVM 架構,具備單向資料流與嚴格的層級分離。實作三層架構:資料層(服務與儲存庫)、領域層(用於複雜邏輯的使用案例)以及 UI 層(檢視模型與檢視)。使用 provider 進行依賴注入,並透過 ListenableBuilder 搭配命令模式實現反應式 UI 更新與使用者互動。強制執行單向資料流:資料從儲存庫向下流向檢視模型,再流向檢視;事件則向上流動...
official
flutter-build-responsive-layout
flutter
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…
official
flutter-building-forms
flutter
經過驗證的Flutter表單,具備欄位級錯誤處理與提交流程。需使用StatefulWidget託管,並搭配持久的GlobalKey<FormState>來管理表單狀態與跨重建的驗證。使用TextFormField元件,並透過validator()回呼函式在驗證失敗時返回錯誤字串,成功時返回null。提交時呼叫_formKey.currentState!.validate()觸發所有驗證器,並自動在欄位下方顯示錯誤訊息。包含完整程式碼範例,示範使用者名稱...
official
flutter-building-layouts
flutter
掌握 Flutter 的約束系統,高效構建響應式且無溢出的佈局。核心原則:約束向下傳遞,尺寸向上傳遞,父層設定位置。切勿在彈性盒子或可滾動區域中傳遞無界約束。使用 Row / Column 處理線性佈局,Expanded / Flexible 分配空間,Stack 處理重疊元素,SizedBox 設定嚴格約束。運用 LayoutBuilder 實現響應式尺寸調整,或透過條件渲染實現跨手機、平板等裝置的自適應佈局。
official
flutter-building-plugins
flutter
建立並實作跨平台Flutter外掛,支援Android、iOS、Windows及網頁的原生互通。支援標準外掛(透過Method Channels存取平台API)與FFI外掛(C/C++原生函式庫);可根據需要平台特定SDK存取或直接原生程式碼繫結來選擇。聯邦式外掛架構將API拆分為應用程式端、平台介面及獨立平台實作套件,適合團隊開發。包含逐步...
official
flutter-caching
flutter
針對 Flutter 應用程式提供全面的快取與效能最佳化,支援多種資料類型與平台。包含決策邏輯以選擇適當的快取機制:記憶體內快取、用於鍵值對的 shared_preferences、用於關聯式資料的 SQLite、用於大型資料區塊的檔案系統,以及用於網路圖片的圖片快取。內建基於串流的離線優先儲存庫模式,先回傳快取資料,再從網路擷取並更新。涵蓋 Android FlutterEngine 預先暖機及...
official
flutter-caching-data
flutter
針對 Flutter 應用程式的本地資料快取與離線優先同步模式。涵蓋五種快取策略:用於 UI 狀態的 shared_preferences、用於結構化資料的 SQLite/Hive、用於二進位媒體的檔案系統、用於導航的狀態還原,以及 Android 上的 FlutterEngine 預熱。透過串流實現離線優先的儲存庫(先輸出本地資料、再擷取遠端資料、最後更新快取),並採用雙重寫入策略(僅限線上模式 vs. 離線優先搭配背景同步)。最佳化圖片快取...
official
flutter-cherry-pick
flutter
How to land a formal cherry-pick of a merged PR for the flutter/flutter repo stable or beta channel. Only use for flutter/flutter landed pull requests. Only…
official
flutter-cherry-pick
flutter
如何為 flutter/flutter 儲存庫的穩定版或測試版頻道提交正式的 cherry-pick,僅適用於已合併的 flutter/flutter 拉取請求。僅…
official
flutter-concurrency
flutter
背景 JSON 解析與狀態管理,實現無卡頓的 Flutter UI 渲染。提供基於模型複雜度的決策樹,協助在人工序列化(dart:convert)與程式碼生成(json_serializable)之間進行選擇。支援三種並行策略:針對小量資料使用主執行緒的 async/await、針對大量一次性計算使用短生命週期的 Isolate.run()、以及透過 ReceivePort / SendPort 實現持續雙向通訊的長生命週期隔離區。包含平台感知的備援機制:...
official
flutter-databases
flutter
符合MVVM架構的Flutter資料層,採用Repository模式、無狀態服務及智慧本地快取策略。根據資料類型、大小與關聯複雜度,引導選擇持久化技術(shared_preferences、sqflite、drift、hive_ce、isar_community或檔案I/O)。將Repository實作為唯一資料來源,隔離DatabaseService與ApiClient作為私有無狀態依賴。提供領域模型、SQLite操作及...的完整程式碼範例。
official
flutter-embedding-native-views
flutter
直接將原生 Android、iOS 或 macOS 視圖及網頁內容嵌入 Flutter 應用程式。支援兩種 Android 合成模式(混合與紋理圖層),各有不同的效能與保真度取捨;iOS 與 macOS 僅使用混合合成。包含在 Android 與 iOS 上實作平台視圖的逐步工作流程,並提供驗證與疑難排解指引。可透過全頁或多視圖(嵌入式)模式將 Flutter 嵌入現有網頁應用程式,並...
official
flutter-environment-setup-linux
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以驗證環境,並自動安裝...
official
flutter-environment-setup-macos
flutter
自動化macOS Flutter開發環境設置,包含依賴驗證與診斷修復。檢查Flutter安裝、Xcode可用性及CocoaPods是否存在;若缺少任何必要條件,則停止並提供清晰指引。引導使用者完成Xcode命令列工具配置及授權接受,並執行必要的sudo指令。透過反覆執行flutter doctor驗證迴圈,識別並解決剩餘工具鏈問題,直到Xcode部分完全通過...
official
flutter-environment-setup-windows
flutter
自動化Windows Flutter開發環境設置,包含平台專屬工具鏈配置。透過互動式提示,為Windows桌面、Android或兩者目標配置Flutter SDK路徑、Visual Studio C++工具鏈安裝及平台專屬設定。當選擇Android時,處理Android Studio設置、裝置/模擬器配置及USB驅動程式安裝。使用OpenSSL生成自簽名MSIX憑證,用於本地Windows應用程式打包與部署...
official
flutter-fix-layout-issues
flutter
使用 Dart 和 Flutter MCP 工具修復 Flutter 佈局錯誤(溢出、無限制約束)。適用於處理「RenderFlex overflowed」、「Vertical…」等問題。
official
flutter-form
flutter
建立具備驗證功能的表單
official
flutter-handling-concurrency
flutter
將CPU密集型任務卸載到後台隔離區,同時保持Flutter UI的響應性。提供三種並發模式:用於I/O密集型工作的async/await、用於一次性重度計算的Isolate.run(),以及帶消息傳遞的Isolate.spawn()用於持久後台工作。包含一個決策矩陣,可根據任務類型(I/O密集型 vs. CPU密集型)和執行頻率在異步操作與隔離區之間進行選擇。涵蓋三個完整工作流程,附帶逐步任務清單:標準...
official
flutter-handling-http-and-json
flutter
HTTP請求與JSON序列化,用於Flutter REST API整合與資料解析。涵蓋三種HTTP方法(GET、POST、PUT、DELETE),包含正確的狀態碼驗證、HTTPS強制使用,以及透過Uri.https()安全建構URI。提供兩種序列化策略:針對簡單模型的手動fromJson/toJson,以及針對複雜巢狀結構使用json_serializable的程式碼生成。包含使用compute()進行背景解析,以在處理大型JSON負載時防止UI卡頓...
official
flutter-home-screen-widget
flutter
適用於 iOS 和 Android 上 Flutter 應用程式的原生主螢幕小工具,支援跨平台資料共享。透過 App Groups(iOS)和 SharedPreferences(Android)在 Dart 與原生平台之間建立資料共享,讓您能從 Flutter 應用程式更新小工具。支援簡單的文字型小工具,以及以靜態圖片形式呈現的複雜 Flutter UI,供原生顯示使用。需要在 Xcode(使用 Swift TimelineProvider 的 Widget Extension 目標)和 Android Studio(使用 XML 的 AppWidgetProvider)中進行原生設定...
official
flutter-http-and-json
flutter
為Flutter應用程式提供安全的HTTP網路通訊與JSON處理,並支援背景解析。使用http套件實作CRUD操作(GET、POST、PUT、DELETE),透過Uri.https()安全建構URL,並進行嚴格的狀態碼驗證。採用Dart 3模式匹配搭配工廠建構子與toJson()方法,實現強型別的JSON序列化與反序列化。針對超過16ms的負載,透過compute()將大型JSON解析卸載至背景隔離區,避免UI卡頓。
official
flutter-implement-json-serialization
flutter
Create model classes with `fromJson` and `toJson` methods using `dart:convert`. Use when manually mapping JSON keys to class properties for simple data…
official
flutter-implementing-navigation-and-routing
flutter
Flutter 螢幕轉場與深層連結的指令式與宣告式路由模式。涵蓋 Navigator(指令式、基於堆疊)與 Router(宣告式、URL 同步)兩種方法,並提供使用時機指引。支援 iOS、Android 及 Web 平台的深層連結;包含透過建構子、路由引數與回傳值傳遞資料。實作多步驟流程(如設定精靈)的巢狀導航,具備獨立子導航器與返回按鈕攔截功能。提供...
official
flutter-improving-accessibility
flutter
為輔助技術(包括螢幕閱讀器和鍵盤導航)配置 Flutter 應用程式。涵蓋 UI 設計基礎:字型縮放、色彩對比(一般文字 4.5:1,大字型 3:1),以及 48x48 像素的最小點擊目標。提供使用 Semantics、MergeSemantics 和 ExcludeSemantics 小工具的語意標註模式,以向輔助工具暴露小工具樹結構。包含針對網頁的啟用語意層(預設為效能考量而停用)的指引,以及...
official
flutter-interoperating-with-native-apis
flutter
從 Flutter 程式碼存取 Android、iOS 及網頁上的裝置專屬原生 API。支援三種整合方式:FFI 用於直接繫結 C/C++、平台通道(搭配 Pigeon 確保型別安全)用於呼叫 Kotlin/Swift/Objective-C,以及平台視圖用於嵌入原生 UI 元件。FFI 使用 dart:ffi,並透過 build.dart 鉤子自動編譯建置;需使用 extern "C" 符號及 package:ffigen 產生 Dart 繫結。平台通道提供非同步訊息傳遞...
official
flutter-layout
flutter
透過組合小部件、管理約束條件以及適應螢幕尺寸,來建構響應式 Flutter 佈局。提供決策樹,根據內容維度、重疊、滾動及響應需求,選擇合適的基礎佈局小部件(Row、Column、Stack、ListView、GridView、CustomScrollView)。強制執行 Flutter 核心約束系統:約束向下傳遞、尺寸向上傳遞、父級設定位置;包含用於強制指定尺寸的 ConstrainedBox 模式。實作...
official
flutter-localization
flutter
配置 Flutter 應用程式以支援多語言和地區設定,並進行適當的 i18n 設置。管理依賴注入(flutter_localizations、intl)、程式碼生成配置(l10n.yaml)以及 .arb 翻譯檔案建立,支援佔位符、複數形式和區域變體。配置根元件委派(MaterialApp、CupertinoApp 或 WidgetsApp),並處理需要明確 Localizations 包裝的獨立元件,如 TextField 和 CupertinoTabBar。支援...
official
flutter-localizing-apps
flutter
使用 ARB 檔案與程式碼生成技術,為 Flutter 應用程式提供多語言支援。在 pubspec.yaml 中配置 flutter_localizations 與 intl,接著定義 l10n.yaml 檔案以啟用 gen-l10n 程式碼生成器。將本地化字串儲存在應用程式資源套件(.arb)JSON 檔案中;範本檔案定義所有鍵值,而特定語系檔案則提供翻譯。透過新增 AppLocalizations.delegate 與平台專屬委派,將本地化功能整合至 MaterialApp 或 CupertinoApp 中...
official
flutter-managing-state
flutter
在Flutter中使用StatefulWidget、MVVM和Provider管理瞬時狀態與應用層級狀態。區分瞬時狀態(單一widget,使用setState()管理)與應用狀態(跨widget共享,使用MVVM和provider套件管理)。透過單一事實來源實現單向資料流:Model處理資料,ViewModel透過ChangeNotifier管理UI狀態,View消費並顯示狀態。提供MVVM實作的循序工作流程:定義Repository、建立...
official
flutter-native-interop
flutter
跨平台原生互操作性,適用於 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...
official
flutter-performance
flutter
透過系統性剖析與針對性優化,識別並消除 Flutter 應用中的效能瓶頸。提供決策樹以診斷 UI 執行緒、Raster(GPU)執行緒或兩者同時發生的卡頓問題,並針對每種情況提供具體修復方案。包含使用 traceAction 與 TimelineSummary 建立效能基準並測量幀預算的整合測試模板。涵蓋 UI 優化(局部化狀態、const 建構子、StringBuffer 使用)與 Raster 優化(取代 Opacity...
official
flutter-platform-views
flutter
在 Android、iOS、macOS 及網頁平台上,將原生視圖與網頁內容嵌入 Flutter 應用程式。支援 Android 混合合成(原生保真度)與紋理圖層(Flutter 效能)、iOS/macOS 混合合成,以及網頁全頁面或嵌入式多視圖模式。提供完整的 Dart 與原生程式碼範本(Android 使用 Kotlin、iOS/macOS 使用 Swift、網頁使用 JavaScript),並搭配工廠註冊模式。需事先透過決策樹判斷目標平台與嵌入方式...
official
flutter-plugins
flutter
以原生互操作、方法通道、FFI整合及聯邦式架構搭建Flutter插件。根據原生程式碼需求與團隊結構,生成標準插件、FFI插件或聯邦式多套件架構。配置Android v2嵌入生命週期介面、平台專屬原生環境(Kotlin/Java、Swift/Objective-C)及方法通道註冊。實作套件分離的聯邦式插件,包含應用端與平台專屬...
official
flutter-pr-checks-finder
flutter
Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs.
official
flutter-pr-checks-finder
flutter
在 Flutter PR 上找出失敗的檢查,並定位對應的 LUCI 日誌網址。
official
flutter-reducing-app-size
flutter
使用分析工具和縮減策略,跨平台測量並優化 Flutter 應用程式套件大小。透過 --analyze-size 標記生成詳細的大小分析 JSON 檔案,識別導致臃腫的大型套件、函式庫和資源。利用 DevTools 應用程式大小工具進行視覺化與建置比較,支援樹狀圖檢視和差異功能以追蹤優化進度。支援 Android(APK/AAB)、iOS 和桌面平台,並提供平台專屬工作流程,包括 iOS 應用程式...
official
flutter-routing-and-navigation
flutter
在 Flutter 應用中進行螢幕導航、處理深度連結以及管理資料傳遞。根據應用需求評估並選擇最佳路由策略:使用命令式 Navigator 處理簡單流程、宣告式 Router / go_router 支援深度連結與網頁應用,或採用巢狀 Navigator 處理獨立子流程。支援透過建構子參數(建議方式)或 RouteSettings 搭配型別安全的參數提取來進行路由間的資料傳遞。透過 MaterialApp.routes 或... 實作命名路由。
official
flutter-setting-up-on-linux
flutter
自動化Linux環境設置,用於Flutter桌面開發,包含依賴安裝與驗證工作流程。涵蓋三個核心工作流程:安裝系統依賴(建置工具、GTK函式庫、C/C++工具鏈)、透過flutter doctor驗證環境,以及準備Snap套件進行發布。提供適用於Debian/Ubuntu系統的即用命令,並包含ChromeOS Linux容器的條件式設置。內含基礎snapcraft.yaml範本,用於...
official
flutter-setting-up-on-macos
flutter
自動化macOS環境配置,用於Flutter開發,包含Xcode與CocoaPods設定。引導安裝並連結Xcode命令列工具、接受開發者授權,以及CocoaPods相依性管理。包含使用flutter doctor與flutter devices的驗證流程,以確認環境正確設定及macOS桌面辨識。提供常見問題的疑難排解步驟,包括缺少命令列工具、CocoaPods路徑問題及桌面支援等。
official
flutter-setting-up-on-windows
flutter
自動化Windows環境設置,用於Flutter開發,包含SDK、工具鏈及平台配置。引導SDK安裝、PATH配置,並透過flutter doctor驗證依賴。涵蓋Windows桌面編譯所需的Visual Studio C++工作負載設置,以及Android模擬器/裝置配置。包含建置發行版二進位檔、打包含必要DLL的可分發壓縮檔,以及為MSIX部署產生自簽憑證的工作流程。提供逐步...
official
flutter-setup-declarative-routing
flutter
Configure `MaterialApp.router` using a package like `go_router` for advanced URL-based navigation. Use when developing web applications or mobile apps that…
official
flutter-setup-localization
flutter
Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when…
official
flutter-state-management
flutter
為Flutter狀態管理實作MVVM與單向資料流模式。提供決策邏輯以區分短暫狀態(透過setState的本地UI狀態)與應用狀態(透過MVVM與provider套件的共享狀態)。強制嚴格關注點分離:資料層(Repository作為單一事實來源)、邏輯層(繼承ChangeNotifier的ViewModel)與UI層(不可變狀態的純函數)。包含實作MVVM模式的完整程式碼範例...
official
flutter-testing
flutter
為Flutter應用程式生成單元測試、元件測試、整合測試及外掛測試,具備架構感知能力。分析目標程式碼以決定適當的測試類型(邏輯用單元測試、UI用元件測試、端對端用整合測試、原生程式碼用外掛測試)。提供每個測試類別的決策樹與逐步實作模式,包含假物件/模擬物件設定及斷言策略。內含可直接使用的程式碼範本,適用於ViewModel、儲存庫、元件及完整應用程式流程,並包含適當的...
official
flutter-testing-apps
flutter
適用於 Flutter 應用程式的全面測試框架,涵蓋單元測試、Widget 測試與整合測試三個層級。包含三種測試類別:針對獨立邏輯的單元測試、針對 UI 元件的 Widget 測試,以及在真實裝置或模擬器上執行的端到端流程整合測試。提供 ViewModel、Repository、Service 與 View 的架構測試模式,強調使用 Fake 實作而非 Mock 以達成更簡潔的測試設計。內含結合 Dart 測試與原生程式碼的外掛測試指南。
official
flutter-theming
flutter
自動將 Flutter 應用程式從 Material 2 遷移至 Material 3,包含元件與主題的更新。透過決策樹識別並取代已棄用的 Material 2 元件(如 FlatButton、RaisedButton、BottomNavigationBar、Drawer),將其轉換為對應的 Material 3 等效元件。將舊版主題屬性轉換為 Material 3 的 ColorScheme,並移除已棄用的強調色參考(如 accentColor、accentColorBrightness 等)。標準化所有元件主題,使其使用 *ThemeData 類別,並確保啟用 useMaterial3:...
official
flutter-theming-apps
flutter
使用 Material 3 主題化技術,為 Flutter 應用程式提供全域樣式與適應性設計模式。涵蓋 Material 3 色彩方案、字體排版、高度層級,以及現代元件替代方案(NavigationBar、FilledButton、SegmentedButton)。包含透過 *ThemeData 類別進行元件主題標準化,並針對 accentColor 與 AppBarTheme.color 等舊有屬性提供棄用指引。提供平台特定的適應性模式:滾動條可見性、可選文字、按鈕順序(Windows 與...)。
official
flutter-use-http-package
flutter
使用
official
flutter-working-with-databases
flutter
SQLite 與離線優先資料層架構,適用於 Flutter 應用程式,具備結構化本地持久化能力。將資料層拆分為無狀態服務(原始資料包裝器)與業務邏輯儲存庫(每個領域實體的單一事實來源)。實作離線優先同步:讀取時立即回傳快取的本地資料,再擷取遠端更新;寫入時先儲存至本地,再嘗試 API 同步,並以背景佇列作為備援。涵蓋 SQLite 設定與安全的參數化查詢、領域...
official
genui-helper
flutter
GenUI 儲存庫的開發輔助工具。當使用者詢問 GenUI 工作流程、執行測試、建立元件、尋找 A2UI 或 Dart…時,請使用此技能。
official
genui-helper
flutter
此技能提供 genui 儲存庫專屬的工作流程與最佳實踐。
official
grill-me
flutter
持續追問使用者的計畫或設計,直到達成共識,並逐一釐清決策樹的每個分支。適用於使用者想要…
official
grill-with-docs
flutter
一場挑戰你的計劃與現有領域模型對抗的燒烤會議,能精煉術語,並即時更新文件(CONTEXT.md、ADRs)…
official
grill-with-docs
flutter
一場燒烤會議,挑戰你的計劃與現有領域模型,精煉術語,並即時更新文件(CONTEXT.md、ADRs)…
official
integrate-genui-firebase
flutter
當使用者要求整合 genui 套件並與 Firebase AI Logic 進行簡單對話時,使用此技能。
official
integrate-genui-firebase
flutter
當使用者要求整合 genui 套件並透過 Firebase AI Logic 啟動簡單對話時,使用此技能。
official
migrate-intellij-util
flutter
透過將標準Java/Kotlin類別遷移至IntelliJ專用的com.intellij.util實作,最佳化記憶體使用、一致性與效能。
official
natural-writing
flutter
包含建立自然、準確且易讀寫作的明確規則。在撰寫較長文字時使用,例如分析文件、PR或CL…
official
natural-writing
flutter
Contains well-defined rules for creating natural, accurate, and readable writing. Use whenever authoring longer text, like analysis documents, PR or CL…
official
natural-writing
flutter
包含明確規則,用於創建自然、準確且易讀的寫作。在撰寫較長文本(如分析文件、PR或CL…)時使用。
official
NotInvalid
flutter
一個故意損壞的固定裝置,用於 example/README.md 展示每條規則的錯誤輸出樣貌。
official
preparing-pr
flutter
透過執行帶有修正的預提交檢查來準備拉取請求。在準備提交或發送PR時使用。
official
preparing-pr
flutter
透過執行預先提交並進行修正來準備拉取請求。在準備提交或發送PR時使用。
official
proofread-markdown
flutter
根據Google指南校對Markdown檔案。
official
rebuilding-flutter-tool
flutter
Rebuilds the Flutter tool and CLI. Use when a user asks to compile, update, regenerate, or rebuild the Flutter tool or CLI.
official
rebuilding-flutter-tool
flutter
重建 Flutter 工具與 CLI。當使用者要求編譯、更新、重新產生或重建 Flutter 工具或 CLI 時使用。
official
release-plugin
flutter
為 flutter-intellij 外掛程式準備並執行新版本發布,包括更新相依項目、相容性範圍、變更日誌與驗證。
official
remove-platform-version
flutter
Remove support for an older IntelliJ Platform / Android Studio version from the project and clean up obsolete code, baselines, and CI configurations.
official
resolve-verification-issues
flutter
消除由 ./gradlew verifyPlugin 識別的插件驗證警告與錯誤(內部 API 使用、僅限覆寫 API 使用等)。
official
reviewing-devtools-prs
flutter
DevTools 儲存庫專用的 PR 審查工作流程,強制執行 DevTools 風格指南與常見審查模式。用於審查以下專案中的拉取請求時…
official
reviewing-prs
flutter
使用 gh CLI 進行擷取、檢查、審閱 GitHub Pull Requests 的通用工作流程,草擬符合使用者需求的審閱意見,並在…之前取得核准。
official
run-devicelab-with-led
flutter
Run DeviceLab tests for Flutter PRs using LUCI's `led` CLI tool. Use when asked to run, launch, try, or deflake a post-submit or devicelab test against a PR…
official
shepherd-prs
flutter
Automate shepherding, checking status, updating branches, and landing open PRs or approved third-party contributor PRs in the flutter/flutter repository using…
official
shepherd-prs
flutter
自動化管理、更新並合併您在 flutter/flutter 儲存庫中的開放 PR 以及經核准的第三方貢獻者 PR。使用時機:-…
official
stage-site
flutter
在提交變更或於本地審查 PR 之前,務必先暫存網站並確保一切運作正常。請依照以下步驟暫存網站:
official
test-driven-development
flutter
在撰寫實作程式碼之前,用於實作任何功能或錯誤修正時使用。
official
triage-helper
flutter
協助對未優先排序的問題進行分類。當使用者請求分類協助時使用。
official
unix-cli-best-practices
flutter
安全、可攜且高效的命令列模式,適用於 macOS/BSD Unix 工具(grep、find、sed、awk、xargs、mdfind、pbcopy、open)及現代替代方案…
official
update-llms-text
flutter
更新並維護llms.txt檔案。當使用者想要新增章節、新增連結、修正資訊或檢視llms.txt檔案時使用。
official
update-llms-text
flutter
更新並維護 llms.txt 檔案。當使用者想要新增章節、新增連結、修正資訊或檢視 llms.txt 檔案時使用。
official
updating-android-sdk
flutter
將Flutter的Android SDK依賴升級至新的Android API版本(或預覽/候選版本),更新於packages.txt中,驗證CIPD標籤的唯一性,以及…
official
updating-android-sdk
flutter
將 Flutter 的 Android SDK 依賴升級至 packages.txt 中的新 Android API 版本(或預覽版/測試版),驗證 CIPD 標籤的唯一性,並…
official
updating-package-versions
flutter
引導更新已發布套件中的依賴版本,以避免 mono-repo 解析失敗。
official
updating-package-versions
flutter
引導更新已發布套件中的相依性版本,以避免單一儲存庫解析失敗。
official
upgrade-browser
flutter
Upgrade browser versions (Chrome or Firefox) in the Flutter Web Engine and/or Framework tests. Use when asked to roll or upgrade Chrome or Firefox to a newer…
official
upgrade-browser
flutter
在 Flutter Web 引擎和/或框架測試中升級瀏覽器版本(Chrome 或 Firefox)。當被要求滾動或升級 Chrome 或 Firefox 至更新版本時使用。
official
valid
flutter
用於 dart_skills_lint 的參考固定裝置。展示一份通過所有預設規則的 SKILL.md:連字號小寫名稱與父目錄相符,一個正確的…
official
validate-pr
flutter
在本地暫存 Flutter 網站。這包括檢查失效連結、驗證摘要、更新格式,以及提供開發網站服務。
official
validate-pr
flutter
確保所有修改過的程式碼片段都能正確執行,並同步到 Markdown 檔案中。
official
verify-eap-compatibility
flutter
確保外掛程式與最新的 IntelliJ Platform 版本及 EAP(Early Access Program)建置版本保持相容。
official