菜单
Use automatically for Flutter work involving Android, iOS, Web, Desktop, responsive/adaptive UI, platform behavior, routing/deep links, theming, accessibility, performance, or cross-target tests.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Canonical rules — feature layers, domain purity, cubit vs widget roles, DI entrypoints, Freezed. Part of agents-canonical-rules split.
Scaffold or add a feature Cubit with Freezed state, tests, and repo-standard placement under presentation/cubit/.
Figma design-to-code for this repo (figma-sync assets, Flutter adaptation, MCP).
Dependency direction and feature composition. Use for shared package/app-shell changes, cross-feature deps, auth/theme contracts.
External references and key file paths for this repo. Use when locating theme, DI, lifecycle, sync, HTTP, or Supabase code.
Flutter BLoC app stack snapshot and lib/ layout. Use at task start or when adding features, routes, or shared code.
| name | flutter-cross-platform-modern |
| description | Use automatically for Flutter work involving Android, iOS, Web, Desktop, responsive/adaptive UI, platform behavior, routing/deep links, theming, accessibility, performance, or cross-target tests. |
Use when Flutter task mentions cross-platform, web, desktop, responsive/adaptive UI, platform-specific behavior, routing/deep links, theming, accessibility, performance, or tests across targets.
First-class targets — consider all four when editing shared presentation, platform adapters, plugins, or bootstrap (not only the device under debug):
| Target | Form factor | Probe focus |
|---|---|---|
| iOS / Android (mobile) | Phone width < 800 px | SafeArea/insets, keyboard overlap, touch targets, text scale, orientation overflows |
| Tablet | 800–1199 px | Multi-column / side-by-side where width allows; not a stretched phone layout |
| Web | Browser viewport | Deep links, browser back/forward, auth/route gates, web-safe imports, pointer hover/focus |
| Desktop (macOS) | ≥ 1200 px and narrow windows | Keyboard traversal, focus visibility, scroll behavior, mouse affordances |
Canon: tech_stack.md § Supported platforms;
design_system.md § Cross-platform form factors.
Risk: RISK-PLATFORM-SCOPE in ai_failure_risks.md.
AGENTS.md and local project docs when present.flutter_bloc_app, use AGENTS.md + docs/ai/context_loading.md.docs/agent_project_context.md Feature Constraint Packet when present.docs/agents_quick_reference.md; routing detail: docs/engineering/validation_routing_fast_vs_full.md.DESIGN.md + docs/design_system.md; widget sizing: docs/testing/widget_test_playbook.md.dart:io in Presentation. If platform IO is needed, isolate it behind a data/shared adapter; in flutter_bloc_app, checklist owns check_sync_io_in_presentation.sh.Platform.isX in UI. Prefer project platform adapters such as PlatformAdaptive, responsive extensions, injected capabilities, or web-safe kIsWeb/defaultTargetPlatform gates when existing patterns require them.context.responsive* / UI tokens first; add LayoutBuilder for parent-constraint branches and MediaQuery for viewport/keyboard/text-scale — design_system.md § Responsive layout; ui_ux_responsive_review.md § Agent rules.pubspec.lock, package platform support, and current API before recommending or adding dependencies.Use the Supported platforms table above. Additional shared checks:
design_system.md § Cross-platform form factors../bin/checklist-fast when repo provides it../bin/router_feature_validate when repo provides it../tool/check_design_md.sh if DESIGN.md changed; ./tool/run_mix_lint.sh if Mix styles/tokens changed; focused widget proof for layout-sensitive surfaces../bin/integration_preflight or focused test named by owner docs../bin/checklist when repo provides it.If a controllable Flutter debug session exists and app-code/UI changed, hot reload before claiming verified (hot restart if reload cannot apply).