make-app-observability

所有新建 Make App 默认接入 Trace ID。存量 App 的本次任务涉及业务请求、AI transport、错误出口或发布门禁时，应核对相关 Trace 链路并补齐缺失环节；无关改动只报告发现的缺失，不擅自扩大本次任务范围。Trace ID 的默认范围是 App 的业务请求及其错误出口，包括启用时的 AI JSON、SSE 和二进制传输。静态资源和 OAuth 回调不属于 UI 业务请求适配器的范围。

主责与边界

本 Skill 负责跨 UI、可选 Service 和 Make Gateway 的 Trace ID 生成、传递、关联日志、错误分类与统一展示。@qfei-design/make-app-observability 提供错误呈现模型及 React 组件；它不会发请求、创建 Span、传 Header、记录日志或配置导出器。不能把安装该包等同于完成 Trace 链路，也不能把仅有 Trace ID 关联宣称为已接入集中式 Trace 后端。

• 认证请求与 cookie/session 机制交给 make-app-auth；在其共享已认证请求适配器中注入追踪 Header，不另写裸请求或浏览器 token 逻辑。
• Service 路由、UI-Service 业务合同和 Make adapter 交给 make-app-service；本 Skill 定义跨这些边界的 Trace 不变量。
• AI 路由、流式事件和取消语义交给 make-ai-assistant；其已认证 JSON、SSE、二进制传输沿用同一追踪合同。
• 发布脚本和交付门禁交给 make-app-runtime；该 Skill 调用本 Skill 的审计器。
• 全局错误出口在持久应用根层的挂载、与宿主 overlay 的层级协调及真实 Shell 可见性验收交给 makeui；本 Skill 负责把安全的结构化请求错误交给该出口。0.1.8+ 公共包负责桌面与手机 viewport 的默认定位、错误卡片和 Trace ID 展示规则，宿主不重写默认定位。

默认接入流程