菜单
Maintains flutter_test_app macOS showcase, native intentcall hooks (codegen, app_links invoke), and VM MCP validation. Use when editing macOS Runner, intentcall_codegen.sh, macOS dogfood, Screen Recording capture, or comparing macOS parity to web WebMCP.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generic contract/schema boundary audit across authoring, discovery, validation, and execute—detecting split-brain between listings and invoke paths, gateway divergence, and permissive placeholders. Use when changing tool registration, RPC/plugin registries, dynamic tools, MCP or WebMCP surfaces, CLI exec aliases, OpenAPI or JSON Schema contracts, migrators/codegen, bridge argument encoding, or platform docs that describe API contracts.
Use this skill whenever inspecting, interacting with, or live-editing a running Flutter app via the Flutter MCP toolkit server (`mcpServers` key **`flutter-mcp-toolkit`**, or legacy **`flutter-inspector`**). Covers preflight, snapshot/tap/enter/scroll loop, hot-reload validation, and error envelope parsing.
Use this skill when the agent exposes app-specific surfaces by registering custom MCP tools and resources inside the Flutter app (mcp_toolkit dynamic registry — AgentCallEntry, bootstrapFlutter additionalEntries / addEntries). Covers tool vs resource vs evaluate-expression, Map-based handlers, schema strictness, discovery via fmt_list_client_tools_and_resources, fmt_client_tool, fmt_client_resource, and lifecycle pitfalls.
Entry point for inspecting or driving a running Flutter app from your AI assistant — routes to the right task skill (inspect / control / debug / custom app surfaces) and runs preflight.
Read state from a running Flutter app — semantic snapshot, view details, errors, screenshots, VM info. Use when you need to understand what the app is showing.
Migrate Flutter app code from removed MCPCallEntry to AgentCallEntry after the hard cut. Use when upgrading mcp_toolkit, fixing compile errors after a major bump, or running flutter-mcp-toolkit migrate agent-entries.
| name | flutter-mcp-toolkit-maintain-macos |
| description | Maintains flutter_test_app macOS showcase, native intentcall hooks (codegen, app_links invoke), and VM MCP validation. Use when editing macOS Runner, intentcall_codegen.sh, macOS dogfood, Screen Recording capture, or comparing macOS parity to web WebMCP. |
Dogfood app: flutter_test_app. Platform doc: flutter_test_app/INTENTCALL_PLATFORM.md.
WebMCP modelContext is web-only. macOS dogfood proves VM extensions, dynamic registry, native invoke (intentcall:// via app_links), and visual capture (Screen Recording on host).
For WebMCP parity scoring, run web iteration separately (flutter-mcp-toolkit-maintain-web).
make showcase-stop && make showcase
.showcase/flutter_app.logws://127.0.0.1:…/ws from log (default VM port 8181)grep -Eo 'ws://127\.0\.0\.1:[0-9]+/[A-Za-z0-9_=-]+/ws' .showcase/flutter_app.log | tail -1
Stop: make showcase-stop.
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart codegen sync \
--platform web,android,ios,macos,linux,windows \
--project-dir flutter_test_app
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart init intentcall-platform \
--project-dir flutter_test_app --check
| Target | Role |
|---|---|
macos/intentcall_codegen.sh | Xcode Run Script → codegen sync --platform macos |
macos/Runner.xcodeproj | Run Script phase (see script comment if manual) |
lib/main.dart | IntentCallInvokeLinkListener for intentcall://invoke/… |
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart --save-images \
--output-dir .showcase/macos_iter validate-runtime \
--target "$MACOS_WS_URI" \
--flutter-device macos \
--timeout-ms 45000
Permissions (host process running CLI):
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions status
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions request
bash tool/evals/run_dogfood_eval.sh \
--ws-uri "$WEB_WS_URI" \
--macos --macos-ws-uri "$MACOS_WS_URI"
flutter-mcp-cli-runtime-validation — doctor, capture backends, extensionsflutter-mcp-toolkit-maintain-web — WebMCP enablementflutter-mcp-toolkit-dogfood-iterations — rubric + tracker