用途
Flutter Observability 是一个面向 Flutter 应用生产可观测性的技能，用于设计、实现或修复生产环境的可观测能力。其目标是在不采集不必要用户数据的前提下，让生产故障可被诊断。技能明确要求保留现有 Sentry、Crashlytics、OpenTelemetry、Dynatrace、Datadog 或其他遥测栈，除非用户主动要求迁移。
主要能力
技能围绕诊断与治理展开，强调从一个具体的诊断问题或事故出发，而非默认对所有事件进行埋点。它要求先读取 SDK 约束、入口点、flavors/环境以及完整的现有遥测与交付接线，包括 SDK 初始化、错误钩子、同意/隐私规则、网络与导航埋点、isolate 使用、混淆、符号保留/上传、CI 和发布标识。技能明确反对仅凭仪表盘症状推断根因；当缺少仓库或后端证据时，应先列出仍需要的具体产物与后端证据，声明诊断待定，并保持修复方案的条件性。
在事件契约方面，技能要求定义小型操作事件契约：稳定事件名、严重级别、时间戳、发布/构建、环境、平台、关联标识、结果、有意义的耗时以及有界且脱敏的属性。用户内容、令牌、凭证、支付数据和原始请求/响应体不得进入遥测。
在治理方面，每个埋点计划必须显式覆盖五项控制：脱敏、同意、采样、后端保留/访问和有界离线缓冲。需说明哪些控制位于客户端代码、哪些必须在后端验证，不得暗示仅靠客户端配置即可强制实施保留或访问控制。
使用方式
技能按工作类型路由到不同参考：框架、根 isolate、子 isolate 与异步错误覆盖参照错误与崩溃捕获；结构化日志、面包屑、追踪、关联、采样、脱敏与同意参照日志、追踪与隐私；供应商选择或保留、发布元数据、符号、缓冲与端到端证明参照供应商与验证。只加载与请求相关的参考。
边界方面：flutter-performance 负责 profile 模式测量与优化决策，生产追踪可揭示回归或候选瓶颈但不能作为优化证明；flutter-product-analytics 负责漏斗、归因、转化、实验和业务事件，操作遥测回答可靠性与事故诊断问题，在埋点用户旅程时需说明这一区分，避免分析事件或 UI 追踪泄漏进操作契约；flutter-networking 负责 HTTP 行为，本技能定义其周围安全关联与结果信号；flutter-security 负责广泛安全审查，本技能强制执行遥测最小化、脱敏、同意、保留意识与最小暴露；flutter-build-release 负责产物与符号生产，本技能验证发布/构建标识符与符号上传关联。
验证要求测试归一化、脱敏、采样、同意、关联与适配器行为。在非生产后端/环境中演练已处理错误与每类必需的可控未处理错误，然后在实际仪表盘或查询界面确认恰好一次摄取、预期的发布/构建/环境、可用的符号化堆栈与安全属性，确认密钥与不允许的个人数据不存在，并验证遥测离线、限流或不可用时的降级行为。不得因初始化编译通过就声称可观测性生效；应说明哪些信号端到端观测过、哪些仅单元测试过、哪些仍受供应商或设备阻塞。
适用场景
适用于 Flutter 应用生产环境中的错误与崩溃诊断、结构化日志与追踪接入、发布上下文与符号化验证，以及遥测隐私与合规治理。
限制
技能资料未提供具体价格、平台支持清单或效果承诺；其内容为方法论与治理要求，不包含具体代码实现或安装命令。