用 Claude Code 與 Codex CLI 開發 Flutter:MCP Server、AI Rules、Agent Skills 完整設定教學

真正核心必要的額外設定只有 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.mdrules_4k.mdrules_1k.md

# 下載 Flutter 官方完整 AI rules(專案根目錄執行)
curl -fsSL https://raw.githubusercontent.com/flutter/flutter/refs/heads/main/docs/rules/rules.md -o flutter_ai_rules.md

CLAUDE.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/remove

AGENTS.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/skillsdart-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/

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *