flutter-skill

flutter-skill

あらゆる実行中のアプリで、AI エージェントに目と手を与えます。
10 プラットフォーム。テストコード不要。MCP サーバー 1 つ。

デモ • クイックスタート • AI プラットフォーム • プラットフォーム • 他のツールとの比較 • ドキュメント

🚀 設定不要。テストコード不要。AI に話しかけるだけ。

_{時間の節約に役立った場合は、リポジトリにスター ⭐ を付けていただけると幸いです。ほかの人にも見つけてもらいやすくなります！}

30 秒デモ

https://github.com/user-attachments/assets/d4617c73-043f-424c-9a9a-1a61d4c2d3c6

1 つのプロンプト。AI による 28 の操作。テストコード不要。 AI が TikTok クローンを自律的に探索し、タブを移動し、フィードをスクロールし、検索をテストし、フォームに入力します。

開発の背景

E2E テストを書くのは大変です。保守するのはもっと大変です。flutter-skill は、これとは異なるアプローチを採用しています。

• 🔌 MCP を通じて、あらゆる AI エージェント（Claude、Cursor、Windsurf、Copilot、OpenClaw）を実行中のアプリに直接接続します
• 👀 エージェントは画面を見て、人間のテスターのようにボタンをタップし、テキストを入力し、スクロールし、画面を移動します。しかも、休むことはありません
• ✅ テストコード不要 — Page Object も XPath も、壊れやすいセレクターも必要ありません。普通の言葉で指示するだけです
• ⚡ 設定不要 — コードは 2 行だけで、10 のプラットフォームすべてで動作します

You: "Test the checkout flow with an empty cart, then add 3 items and complete purchase"

Your AI agent handles the rest — screenshots, taps, text entry, assertions, navigation.
No Page Objects. No XPath. No brittle selectors. Just plain English.

クイックスタート

1. インストール（30 秒）

npm install -g flutter-skill

2. AI に追加（MCP 設定にコピー＆ペースト）

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

Claude Desktop、Cursor、Windsurf、Copilot、Cline、OpenClaw で動作します。MCP 対応のエージェントならどれでも利用できます。

3. アプリに追加（Flutter の場合は 2 行）

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

4. テスト — AI に話しかけるだけです。

「アプリを起動して、すべての画面を探索し、バグがあれば報告してください」

これだけです。設定不要。テストコード不要。60 秒以内に動作します。

AI プラットフォームでの利用

MCP サーバーモード（IDE 統合）

MCP 互換の AI ツールであれば、どれでも動作します。設定は 1 行です。

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

HTTP サーブモード（CLI と自動化）

単独でのブラウザー自動化、CI/CD パイプライン、またはリモートアクセスに利用できます。

# Start server
flutter-skill serve https://your-app.com

# Use CLI client commands
flutter-skill nav https://google.com
flutter-skill snap                    # Accessibility tree (99% fewer tokens)
flutter-skill screenshot /tmp/ss.jpg
flutter-skill tap "Login"
flutter-skill type "[email protected]"
flutter-skill eval "document.title"
flutter-skill tools                   # List all available tools

--port=N、--host=H フラグと FS_PORT／FS_HOST 環境変数に対応しています。

2 つのモードの比較

CLI クライアントの完全なリファレンス： docs/CLI_CLIENT.md

10 プラットフォーム、1 つのツール

ほとんどのテストツールは 1～2 のプラットフォームでしか動作しません。flutter-skill は 10 のプラットフォームで動作します。

合計：664 件中 656 件のテストに合格（98.8%） — 各プラットフォームは、50 以上の要素を持つ複雑なソーシャルメディアアプリでテストされています。

⚡ パフォーマンス

複雑なソーシャルメディアアプリを対象に自動テストを実行して得られた実測ベンチマークです。

トークン効率： snapshot() は画像ではなく、構造化された要素ツリーを返すため、スクリーンショットを AI エージェントに送る場合と比べて 87～99% 少ないトークンで済みます。

どれほど高速でしょうか？ tap は最初から最後まで 1～2 ms で完了します。Playwright や Selenium などのブラウザー自動化ツールでは、同じ操作に通常 50～100 ms かかります。これは 50～100 倍の速さです。flutter-skill は WebDriver や CDP を介さず、アプリのランタイムと直接やり取りするためです。

高負荷 DOM サイト（実環境）

本番ウェブサイトで 15 個の MCP ツールをテストしました — 75/75 が成功、タイムアウトはゼロです：

合計時間にはページの読み込み時間が含まれます。DOM が大きなサイトでも、ツールの実行時間は一貫して 100 ms 未満です。

Playwright / Appium / Detox を使わない理由

| AI によるページ理解 | ✅ AX Tree | ❌ スクリーンショット | ❌ | ❌ | | 境界値／セキュリティテスト | ✅ 13 個のペイロード | ❌ | ❌ | ❌ | | 一括操作 | ✅ 5 件以上／呼び出し | 1 件／呼び出し | 1 件／呼び出し | 1 件／呼び出し |

flutter-skill は、モバイル、ウェブ、デスクトップで動作する唯一の AI ネイティブ E2E テストツールです。最も近い競合製品の 7 倍のツールを備えています。

CLI コマンド

# 🤖 AI autonomous exploration — finds bugs automatically
flutter-skill explore https://my-app.com --depth=3

# 🐒 Monkey/fuzz testing — random actions, crash detection
flutter-skill monkey https://my-app.com --actions=100 --seed=42

# 🚀 Parallel multi-platform testing
flutter-skill test --url https://my-app.com --platforms web,electron,android

# 🌐 Zero-config WebMCP server — any website becomes testable
flutter-skill serve https://my-app.com

🧠 AI ネイティブ：トークンを 95% 削減

ほとんどの AI テストツールは スクリーンショット を LLM に送信するため、1 枚あたり約 4,000 トークンかかります。

flutter-skill は Chrome の アクセシビリティツリー を使い、あらゆるページの簡潔で意味的な要約を AI に提供します。

// page_summary → ~200 tokens (vs ~4,000 for a screenshot)
{
  "title": "Shopping Cart",
  "nav": ["Home", "Products", "Cart", "Account"],
  "forms": [{"input:Coupon Code": "text"}],
  "buttons": ["Apply", "Checkout", "Continue Shopping"],
  "features": {"search": true, "pagination": true},
  "links": 47, "inputs": 3
}

続いて、1 回の呼び出しで複数の操作をまとめて実行できます。

// explore_actions → 5 actions per call (vs 5 separate tool calls)
{"actions": [
  {"type": "fill", "target": "input:Coupon Code", "value": "SAVE20"},
  {"type": "tap", "target": "button:Apply"},
  {"type": "tap", "target": "button:Checkout"},
  {"type": "fill", "target": "input:Email", "value": "[email protected]"},
  {"type": "tap", "target": "button:Continue"}
]}

結果： AI エージェントは、スクリーンショットベースのツールよりも速く、低コストでテストを行い、ページをより適切に理解できます。

できること

プラットフォームのセットアップ

dependencies:
  flutter_skill: ^0.9.37

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

npm install flutter-skill-react-native

import FlutterSkill from 'flutter-skill-react-native';
FlutterSkill.start();

npm install flutter-skill-electron

const { FlutterSkillBridge } = require('flutter-skill-electron');
FlutterSkillBridge.start(mainWindow);

// Swift Package Manager: FlutterSkillSDK
import FlutterSkill
FlutterSkillBridge.shared.start()

Text("Hello").flutterSkillId("greeting")

implementation("com.flutterskill:flutter-skill:0.8.0")

FlutterSkillBridge.start(this)

[dependencies]
flutter-skill-tauri = "0.8.0"

プロンプトの例

テストしたい内容を AI に伝えるだけです。

コントリビューション

ガイドラインについては CONTRIBUTING.md をご覧ください。

git clone https://github.com/ai-dashboad/flutter-skill
cd flutter-skill
dart pub get
dart run bin/flutter_skill.dart server  # Start MCP server

リンク

⭐ flutter-skill が時間の節約に役立ったら、ほかの人にも見つけてもらえるようスターを付けてください！

MIT License © 2025