db-enforcer 是一个面向数据库完整性与架构一致性的技能(版本 v2.1.0),自称数据完整性的至高守护者。其核心目标是确保 TypeScript 应用层与 PostgreSQL 持久层之间不发生“类型漂移”,并利用 PostgreSQL 18 与 Prisma 7 的特性构建自校验、超快且默认安全的数据库。
用途与定位 该技能聚焦于数据库架构守卫,适用于需要严格约束、迁移安全和零信任数据安全的 PostgreSQL + Prisma 项目。资料将其描述为 2026 年 AI 驱动应用的数据守护者。
同步协议(Synchronization Protocol) 每次 schema 修改必须遵循四步:
- Type-to-DB Verification:在 TypeScript 中添加 enum 或 union 时,需验证 SQL 中对应的 CHECK 约束。
- Migration-First Generation:先使用 prisma migrate dev --create-only 生成 SQL 迁移,再应用变更。
- Naming Alignment:通过显式映射(@map、@@map)强制 SQL 使用 snake_case、TS 使用 camelCase。
- Integrity Audit:运行 bun x prisma validate,并检查关系标量上缺失的索引。
反模式清单(Do Not List) 资料列出五类反模式及现代替代方案:手动 SQL 执行(导致未记录变更与漂移,应改用编号迁移);暴露原始 ID(易被枚举,应使用原生 UUIDv7);缺失 CHECK 约束(无效数据会污染 AI 模型,应使用数据库级校验);在 Edge DB 中使用外键(PlanetScale/Vitess 存在限制,应使用 Prisma 关系模式);select * 查询(高延迟与过度抓取,应使用显式类型化选择)。
PostgreSQL 18 Excellence 优先使用资料所述的 2026 原生特性以提升性能:UUIDv7(顺序、全局唯一 ID,加快索引)、虚拟列(零成本计算字段)、时间约束(基于范围唯一性,用于调度)、AIO 子系统(加速大规模数据集读取)。
Prisma 7 Elite Patterns 包含 TypedSQL(高性能、类型安全的原始 SQL 集成)、TypeScript 引擎(原生 WASM 执行以兼容 Edge)、Prisma 扩展(清晰编排软删除与审计日志)、关系模拟(在无外键环境中保持完整性)。
零信任数据安全(RLS) 每张表必须受行级安全保护。标准做法:个人数据使用 auth.uid() = user_id;高级做法:对团队与项目权限使用 EXISTS 检查;CLS:使用 PostgreSQL 视图向公共 API 隐藏敏感列。
参考库 资料提到包含 PostgreSQL 18 完整性、Prisma 7 架构、迁移安全、RLS 与安全等深度内容,但未给出具体细节。更新时间为 2026 年 1 月 22 日。
限制 资料未提供该技能的具体安装方式、运行命令、支持的平台、是否收费或价格等信息,暂未提供。