菜单
FVM rules for the Flutter-AdaptiveCards monorepo. Prefix every `flutter` and `dart` shell command with `fvm`. Use when vendored dart/flutter skills show bare commands, when installing or switching the pinned SDK, or before analyze, test, pub, or build_runner workflows.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Semantics contract for Adaptive Card elements — how labels, headings, live regions, and decorative-vs-meaningful images are exposed to screen readers, and how to test them with `tester.ensureSemantics()`. Use when adding or changing any element, input, or action widget, and at code review.
Optional flutter_adaptive_cards_host_fs package — backend invoke serialization, PlainJson/Teams adapters, AdaptiveCardBackendHandlers, and response effects. Use when wiring Submit/Execute/Refresh/onChange to a flow-service or reviewing associatedInputs + invoke round-trips.
Use when finalizing a change in the Flutter-AdaptiveCards monorepo — before you propose, commit, or merge — as the manual or AI-assisted review gate. Checks monorepo hygiene, Adaptive Cards spec compliance, theming, widget keys, accessibility, and testing.
Classify, audit, and enforce the Diátaxis documentation framework across the Flutter-AdaptiveCards canonical `docs/` and package READMEs. Keeps each doc in exactly one quadrant (tutorial / how-to / reference / explanation) and flags mixed-mode drift. Use when writing or reviewing a doc under `docs/`, adding a `doc_type:` front-matter tag, auditing the doc set for gaps or violations, or when the user mentions Diátaxis or documentation structure. Advisory only — it proposes splits, it does not silently move or rewrite files.
Use before adding a new Adaptive Card element type — implementing its widget, registering it, or testing it. Covers the StatefulWidget + mixin pattern, CardTypeRegistry registration, the extension API, and optional packages (charts).
Use when writing or reviewing model (de)serialization or theming in this repo, or before adding a `fromJson`/`toJson`. The library packages diverge from two things generic Flutter skills assume: they hand-write serialization (no `json_serializable` / code-gen) and style elements from HostConfig (not app-level `ThemeData`/`GoogleFonts`). Read this when a generic skill or habit points you at `@JsonSerializable`, `build_runner` for models, or `ColorScheme` app theming inside `packages/`.
| name | adaptive-cards-dart-flutter-fvm |
| description | FVM rules for the Flutter-AdaptiveCards monorepo. Prefix every `flutter` and `dart` shell command with `fvm`. Use when vendored dart/flutter skills show bare commands, when installing or switching the pinned SDK, or before analyze, test, pub, or build_runner workflows. |
This monorepo pins Flutter/Dart with fvm. Every shell
command that invokes flutter or dart must use the fvm prefix.
For which directory to run a command from, see
adaptive-cards-monorepo-workspace. For library test conventions, see
adaptive-cards-testing.
When a vendored skill, doc, or tool shows a bare command, translate it:
| Shown | Run in this repo |
|---|---|
flutter … | fvm flutter … |
dart … | fvm dart … |
dart analyze | fvm flutter analyze (repo root) |
dart fix --apply | fvm dart fix --apply (package directory) |
dart test (Flutter packages) | fvm flutter test (package directory) |
dart run build_runner build | fvm dart run build_runner build |
flutter pub get | fvm flutter pub get |
flutter pub publish | fvm flutter pub publish |
Run from the repository root:
fvm install <flutter-version> # e.g. 3.44.0 — skip if already installed
fvm use <flutter-version>
fvm flutter --version
Confirm these files agree on the version:
.fvm/fvm_config.json.fvmrc.github/workflows/test.yml → flutter-version: (see adaptive-cards-release-flutter-upgrade-sdk for the full bump checklist)Check the pin without switching:
cat .fvmrc
fvm when the pinned version matters.dart.flutterSdkPath to .fvm/versions/<version>.| Skill | Role |
|---|---|
adaptive-cards-monorepo-workspace | Layout, working directories, dependencies |
adaptive-cards-testing | flutter_adaptive_cards_fs test helpers and goldens |
adaptive-cards-release-flutter-upgrade-sdk | Pubspec, CI, changelog steps after SDK bump |