Menu
接入层（Tap）集成模式：MQTT Tap、Webhook Tap、Shifu 可选连接器；统一 Event Envelope、幂等/DLQ。编写设备接入代码时使用。见 ADR-0016。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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/。
| 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（时序）的输入。