真正核心必要的額外設定只有 3 個:(1)Dart and Flutter MCP Server、(2)Flutter 官方 AI Rules、(3)Flutter / Dart 官方 Agent Skills。
(1) Dart and Flutter MCP Server
讓 Claude Code、Codex CLI 能用 Flutter 官方工具能力:分析錯誤、查 docs/signature、管理 pubspec、搜尋 pub.dev、跑 test/analyze、讀 runtime widget tree、hot reload/restart。
# Claude Code(專案根目錄執行)
claude mcp add --transport stdio dart -- dart mcp-server
# Codex CLI
codex mcp add dart -- dart mcp-server --force-roots-fallback驗證:
claude mcp list
codex mcp list(2) Flutter 官方 AI Rules
把 Flutter 官方建議的 Dart/Flutter 開發規範放進 agent 專案指令,例如 formatter、analyzer、lint、pub dependency、test、Flutter best practices。
Flutter 官方提供多種 rules 檔:完整 rules.md、壓縮版 rules_10k.md、rules_4k.md、rules_1k.md。
# 下載 Flutter 官方完整 AI rules(專案根目錄執行)
curl -fsSL https://raw.githubusercontent.com/flutter/flutter/refs/heads/main/docs/rules/rules.md -o flutter_ai_rules.mdCLAUDE.md 可以這樣寫:
@flutter_ai_rules.md
## Claude Code
Use the Dart and Flutter MCP server whenever Dart or Flutter tooling context is needed.
Prefer Flutter official tooling:
- dart format
- dart analyze
- flutter analyze
- flutter test
- flutter pub add/removeAGENTS.md 可以這樣寫:
# Project Instructions
This is a Flutter project.
Read and follow the Flutter official AI rules in:
- `flutter_ai_rules.md`
Use the Dart and Flutter MCP server whenever Dart or Flutter tooling context is needed.
Prefer Flutter official tooling:
- dart format
- dart analyze
- flutter analyze
- flutter test
- flutter pub add/remove(3) Flutter / Dart 官方 Agent Skills
Flutter 官方說 Rules 是一般行為、MCP 是工具能力,而 Agent Skills 是「教 agent 如何正確操作工具」的任務型流程。官方維護 flutter/skills 與 dart-lang/skills。
# Flutter 官方 skills(專案根目錄執行)
npx skills add flutter/agent-plugins --skill '*' --agent universal --yes
# Dart 官方 skills
npx skills add dart-lang/skills --skill '*' --agent universal --yes它們預設裝到 .agents/skills,而不是 .claude/skills,因此複製一份到 Claude Code 的專案 skills 目錄:
mkdir -p .claude/skills
rsync -a .agents/skills/ .claude/skills/之後更新 skills:
npx skills update -p
rsync -a .agents/skills/ .claude/skills/