Skip to main content

Flutter 與 Dart 的 AI 規則

了解如何在工具中新增 AI 規則,以加速您的 開發工作流程。

本指南說明如何善用 AI 規則來簡化您的 Flutter 與 Dart 開發流程。

概覽

#

以 AI 驅動的編輯器會使用規則檔案,向底層的 LLM (Large Language Model,大型語言模型) 提供情境與指示。這些檔案可協助您:

  • 依據團隊需求自訂 AI 行為。
  • 強制執行程式碼風格與設計的專案最佳實踐。
  • 向 AI 提供關鍵的專案情境資訊。

Flutter 專案提供多個版本的規則檔案,以因應不同工具的字元上限:

  • rules.md: 完整的主要規則集。
  • rules_10k.md: 精簡版本(< 10,000 字元),適用於情境上限較嚴格的工具。
  • rules_4k.md: 高度濃縮版本(< 4,000 字元),適用於情境受限的環境。
  • rules_1k.md: 超精簡版本(< 1,000 字元),適用於限制極為嚴格的環境。
下載 Flutter 與 Dart 規則範本

裝置與編輯器的個別上限

#

不同的 AI 程式碼助理與工具,對其「規則」或「自訂指示」檔案有不同的上限。最後更新:2026-01-05。

工具 / 產品 規則檔案 / 功能 上限(軟性 / 硬性) 文件
Antigravity (Google) .agent/rules/<rule-name>.md 12,000 字元(硬性) 設定規則
Claude Code CLAUDE.md 無硬性上限 Claude Code Docs
Cursor AGENTS.md 無硬性上限 Cursor Docs
Gemini CLI GEMINI.md 1M+ Token(情境) Gemini CLI Docs
GitHub Copilot .github/copilot-instructions.md 約 4,000 字元 GitHub Copilot Docs
JetBrains AI (Junie) .junie/guidelines.md 無硬性上限 JetBrains AI Docs
VS Code .instructions.md 未知 設定指示

為您的編輯器建立規則

#

您可以依據您的特定環境調整我們的 Flutter 與 Dart 規則範本。請按照以下步驟操作:

  1. 下載 Flutter 與 Dart 規則範本: rules.md

  2. Gemini 等 LLM 中,附上您在上一步下載的 rules.md 檔案。

  3. 提供提示詞 (prompt),將檔案重新格式化為您所需編輯器的格式。

    提示詞範例:

    Convert the attached rules.md file
    into a guidelines.md file for Gemini CLI. Make sure
    to use the styles required for a guidelines.md file.
    
  4. 審閱 LLM 的輸出內容,並進行必要的調整。

  5. 依照您所使用環境的說明,新增規則檔案。 此步驟可能需要在既有檔案中追加內容,或建立新檔案。

  6. 確認您的 AI 助理已使用新規則來引導其回應。