SuperAPI AI 工具集

database-design

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:帮助在选择数据库模型、审查模式关系与索引、评估拟定模式时做出决策,强调“思考”而非复制 SQL 模板;遇到不明确处应先向用户询问数据库偏好,不要默认使用 PostgreSQL。

主要内容按需选择性阅读:database-selection.md(PostgreSQL 与 Neon、Turso、SQLite 的对比,用于选数据库)、orm-selection.md(Drizzle、Prisma、Kysely 对比,用于选 ORM)、schema-design.md(范式化、主键、关系,用于设计模式)、indexing.md(索引类型、复合索引,用于性能调优)、optimization.md(N+1、EXPLAIN ANALYZE,用于查询优化)、migrations.md(安全迁移、服务端数据库,用于模式变更)。

设计模式前的决策清单:是否已询问用户数据库偏好、是否为当前上下文选定数据库、是否考虑部署环境、是否规划索引策略、是否定义关系类型。

反模式:简单应用默认用 PostgreSQL(SQLite 可能已足够)、跳过索引、生产环境使用 SELECT *、结构化数据更合适时却存 JSON、忽视 N+1 查询。

附带工具:scripts/schema_validator.py 是只读的启发式清单工具,不是 Prisma 或 Drizzle 解析器;模式缺失、格式不受支持或仅有启发式结果时会返回非零,并给出 passed: false 与 analysis_complete: false。语法与类型检查应使用项目本地的 ORM 校验器;迁移与约束语义需另行审查。

限制:仅在任务与上述范围明确匹配时使用;输出不能替代针对具体环境的验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应停止并请求说明。