القائمة
接入层（Tap）集成模式：MQTT Tap、Webhook Tap、Shifu 可选连接器；统一 Event Envelope、幂等/DLQ。编写设备接入代码时使用。见 ADR-0016。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
| name | iot-integration |
| description | 接入层（Tap）集成模式：MQTT Tap、Webhook Tap、Shifu 可选连接器；统一 Event Envelope、幂等/DLQ。编写设备接入代码时使用。见 ADR-0016。 |
接入 = 可插拔 Tap 层：连接器镜像不变的端侧流 → 统一 Event Envelope，behind 统一可切换接口（ADR-0016）。所有连接器幂等 + DLQ 在边界。
$share/grp/topic），不侵入POST /webhooks/iot-eventX-IoT-Webhook-Signature header），secret 来自 Infisical（逐 Tenant，绝不进源码，ADR-0014）SET NX EX 24h on eventId + SQL UNIQUE (raw_event_id){
eventId: string, // UUID v7
tenantId: string,
accountId: string, // 数据归属单元 = 隔离边界（ADR-0004）
deviceId: string,
eventType: string, // 通用，按场景 Zod enum（非鸟种专用）
timestamp: string, // ISO 8601
payload: unknown // 原生 payload
}
userId 可选：无人参与的纯设备链路不带。Event Envelope 是 Twin（状态镜像）与 Telemetry Store（时序）的输入。
استنادا إلى تصنيف SOC المهني
IoT AI Platform 的 TypeScript 严格模式、错误处理、测试策略、依赖管理、Git commit 规范、安全编码守则。编写任何代码前先读本 Skill。
Mastra Model Router、多 provider、成本控制（3 道闸门）、Vertical Skill（垂类模型经 MCP 发现 + 独立推理端点）、Embedding。编写 LLM/模型调用代码时使用。见 ADR-0008。
Mastra Agent/Tool/Workflow 定义模式、config-as-data 函数式壳、Concierge/Vertical Agent、注册中心、流式响应、自定义路由。编写 src/mastra/ 下代码前必读。
三层租户隔离 SQL 模式、pgvector 记忆表、遥测时序(TimescaleDB)与特征库(Feast)、迁移规范。编写数据库相关代码时使用。见 ADR-0004/0010/0013。
IoT AI Platform 目标架构（分面）、层间契约、数据流、可扩展性核心。理解系统全局、做跨层决策、新增能力前使用。真相源是 CONTEXT.md + docs/adr/。
