菜单
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