菜单
三层租户隔离 SQL 模式、pgvector 记忆表、遥测时序(TimescaleDB)与特征库(Feast)、迁移规范。编写数据库相关代码时使用。见 ADR-0004/0010/0013。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
IoT AI Platform 的 TypeScript 严格模式、错误处理、测试策略、依赖管理、Git commit 规范、安全编码守则。编写任何代码前先读本 Skill。
接入层（Tap）集成模式：MQTT Tap、Webhook Tap、Shifu 可选连接器；统一 Event Envelope、幂等/DLQ。编写设备接入代码时使用。见 ADR-0016。
Mastra Model Router、多 provider、成本控制（3 道闸门）、Vertical Skill（垂类模型经 MCP 发现 + 独立推理端点）、Embedding。编写 LLM/模型调用代码时使用。见 ADR-0008。
Mastra Agent/Tool/Workflow 定义模式、config-as-data 函数式壳、Concierge/Vertical Agent、注册中心、流式响应、自定义路由。编写 src/mastra/ 下代码前必读。
IoT AI Platform 目标架构（分面）、层间契约、数据流、可扩展性核心。理解系统全局、做跨层决策、新增能力前使用。真相源是 CONTEXT.md + docs/adr/。
| name | memory-schema |
| description | 三层租户隔离 SQL 模式、pgvector 记忆表、遥测时序(TimescaleDB)与特征库(Feast)、迁移规范。编写数据库相关代码时使用。见 ADR-0004/0010/0013。 |
隔离边界 = Account（ADR-0004）。设备/遥测/观测数据按
tenant_id+account_id隔离；个人记忆再叠user_id。
| 数据 | 存储 | 说明 |
|---|---|---|
| Mastra 记忆 | pgvector schema platform_memory | 对话/语义记忆，Mastra 自动管理 |
| 业务/观测 | Postgres public | 设备、Twin、观测，参数化查询 |
| 历史遥测 | TimescaleDB（hypertable） | 时序，藏在可切换 repo 接口后，高容量可切 ClickHouse |
| 特征 | Feast（online/offline） | entity key 带 tenant_id+account_id，喂垂类模型 |
业务表必须含 tenant_id + account_id 列并有联合索引（个人化数据再加 user_id）：
CREATE TABLE device_events (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
tenant_id TEXT NOT NULL,
account_id TEXT NOT NULL, -- 数据归属单元 = 隔离边界
device_id TEXT NOT NULL,
raw_event_id TEXT NOT NULL UNIQUE, -- 幂等
event_type TEXT NOT NULL,
payload JSONB,
captured_at TIMESTAMPTZ NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
embedding vector(1024)
);
CREATE INDEX idx_device_events_tenant_account ON device_events(tenant_id, account_id);
CREATE INDEX idx_device_events_device ON device_events(tenant_id, account_id, device_id);
WHERE tenant_id = $1 AND account_id = $2；个人记忆类再叠 AND user_id = $3m=16, ef_construction=64）src/mastra/runtime/migrations.ts，启动时 applyPendingMigrations() 自动运行IF NOT EXISTS / DO $$ ... END $$）tenant_id+user_id）数据需迁到三层（加 account_id 维度，ADR-0004）