用途:该技能是 Drizzle ORM + PostgreSQL 在 Next.js App Router 中的库参考,含 36 条规则、7 个类别,每条规则指出其修正的错误默认做法,帮助在编写或审查数据层代码时避免踩坑。
主要覆盖:客户端构建与驱动选择(跨 HMR 用 globalThis 缓存连接池、无服务器连接池规模、PgBouncer 事务模式下的 prepare 设置、按事务需求选驱动、server-only 导入、传递 schema);服务端组件读取(Suspense 边界、use cache/cacheLife/cacheTag、React cache() 去重、运行时选择);Server Actions 与变更(动作内鉴权与校验、updateTag 与 revalidateTag、after() 延后写入);PostgreSQL 表定义(timestamptz、identity 列、text 与 varchar、numeric、jsonb、bigint 模式、枚举);迁移与架构变更安全(generate 与 push、并发索引、重命名、约束验证);事务与连接池(事务中的外部 IO、行锁、序列化重试);查询构建(keyset 分页、count 开销、驱动相关 execute 返回结构、NULL 语义、预处理语句命名)。
使用方式:在相关决策出现时阅读对应引用文件,每条规则先说明其修正的错误默认做法,再给出规范写法。技能自包含,无需中途加载第二个技能。版本绑定 drizzle-orm 0.45.2、drizzle-kit 0.31.10、Next.js 16.2.11、PostgreSQL 14+。
适用场景:编写或审查 lib/db 模块、在服务端组件或 Route Handler 中取数、决定缓存策略、编写变更数据的 Server Action、定义或修改 pgTable、运行 drizzle-kit 生成或迁移、使用事务或排查连接池问题、审查生产环境慢查询。
限制:资料未提供收费、价格与平台支持信息;部分规则与 drizzle-sqlite 技能有意重叠。相关技能包括 drizzle-sqlite、nextjs、relational-database-design。