القائمة
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.
التثبيت باستخدام 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.
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.
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.
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-backend-host |
| description | 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. |
Optional package: packages/flutter_adaptive_cards_host_fs
flutter_adaptive_cards_fs, httplib/flutter_adaptive_cards_host_fs.dart)| Scenario | Package |
|---|---|
Render cards; hand-wire InheritedAdaptiveCardHandlers | Core only |
Teams-correct invoke payloads (associatedInputs) | Core (always) |
Serialize → POST → parse → applyTo automatically | flutter_adaptive_cards_host_fs |
AdaptiveCardBackendHandlers — wraps card subtree; wires onSubmit, onExecute, onRefresh, onChangeAdaptiveCardBackendClient / HttpAdaptiveCardBackendClient — transportPlainJsonInvokeAdapter / TeamsInvokeAdapter — request/response JSON shapesAdaptiveCardInvokeResponse.applyTo — applyPatches, setInputErrors, replaceCard (via onCardReplaced)Requires shared GlobalKey<RawAdaptiveCardState> on handlers and RawAdaptiveCard (except onChange, which uses invoke.cardState).
No golden tests. Run from package directory:
cd packages/flutter_adaptive_cards_host_fs
fvm flutter test
Primary files:
test/handlers/backend_handlers_test.darttest/adapters/plain_json_invoke_adapter_test.darttest/adapters/teams_invoke_adapter_test.darttest/client/http_backend_client_test.dartCore associatedInputs tests remain in packages/flutter_adaptive_cards_fs/test/utils/associated_inputs_test.dart and related input tests.
adaptive-cards-monorepo-workspace — workspace layout and fvm working directoriesadaptive-cards-testing — core widget/notifier test patternsadaptive-cards-release-engineer — sync version: and flutter_adaptive_cards_fs: ^<version> on post-release bump