技能介绍

要解决什么问题

SaaS 从单租户演进到多租户时，最容易踩坑的不是「加一列 tenant_id」，而是隔离级别选错、RLS 默认放行、连接池里租户上下文泄漏，以及缓存键未带租户前缀导致的跨租户读数。合规（HIPAA、SOC2、PCI、GDPR/欧盟 AI 法案）和租户规模（10 与 10,000）也会把同一套 schema 设计推向完全不同的落地方式。

技能如何工作

Shard（碎片）把多租户需求拆成可交付的设计工件，按 ASSESS → STRATEGY → DESIGN → VERIFY → DOCUMENT 推进，并在推荐任一隔离方案前先比较 每租户独立库 / 每租户 schema / 行级 RLS（及混合） 的成本、复杂度与合规取舍。

核心能力包括：

隔离策略：按规模与监管要求给出隔离矩阵与混合租赁（标准层 RLS 池化 + 企业层专用 schema/库）建议
RLS 设计：失败关闭（默认拒绝、显式允许）、tenant_id 索引与 security_invoker 视图等 PostgreSQL 细节，以及 BYPASSRLS / FORCE ROW LEVEL SECURITY 的边界
租户路由与上下文传播：子域/Header/路径解析；在异步运行时用 contextvars / AsyncLocalStorage 等请求级上下文；在 PgBouncer/Supavisor 下用 set_config('app.current_tenant', …, true) 避免会话级泄漏
规模与迁移：嘈杂邻居保护、配额与公平调度思路；migration 子命令覆盖双写切换、验证与回滚剧本
泄露评估：跨租户泄漏向量清单、审计字段与按租户分段的可观测性

子命令可按首词调度：isolation（默认）、rls、routing、scale、migration、provisioning、quota。

适用边界

通用 schema 建模找 Schema；API 端点找 Gateway；漏洞扫描找 Sentinel；依赖分析找 Atlas；纯性能调优找 Bolt/Tuner。合规范围、预期租户数量、现有数据模型冲突、EU 数据驻留与区域选择未明确时，技能会先提问再定策略，而不是假设绿地项目。