softaworks/database-schema-designer：生产级 SQL/NoSQL Schema 设计与可逆迁移 Skill 技能

softaworks-database-schema-designer 是一款面向生产环境的数据库 Schema 设计 Skill。它把「从业务需求到可上线 Schema」的全过程——SQL 表结构、索引、约束、范式取舍、迁移策略、NoSQL 选型——封装成 Claude / Codex / Claude Code 三个 Agent 都能直接调用的标准化工作流，让 AI 在动手建表之前先把数据模型与迁移路径规划清楚。

核心能力：

• SQL 表结构生成：自动生成包含主键、外键、约束、索引的 SQL 表设计，适配 PostgreSQL、MySQL、SQL Server 等主流方言。
• 范式与反范式取舍：解释 1NF/2NF/3NF 等范式规则，并给出读多写少场景下的反范式建议。
• SQL / NoSQL 决策辅助：根据访问模式与扩展性预期，推荐关系型、文档型（MongoDB）或混合方案。
• 可逆迁移设计：提供 expand → backfill → contract 等可逆迁移模式与零停机部署步骤，降低线上数据迁移风险。
• Schema 审查清单：覆盖完整性、数据类型、性能、可空性等维度的检查清单，避免常见设计陷阱。
• MongoDB 建模指引：针对 MongoDB 集合给出嵌入（embed）、引用（reference）与索引策略。

安装配置：

• 通过 npx skillstore add softaworks/database-schema-designer 一键安装到 Claude / Codex / Claude Code Agent 环境。
• 建议在 prompt 中显式声明目标数据库方言（PostgreSQL / MySQL / MongoDB），以便生成对应类型的 DDL。
• 项目使用 Prisma / TypeORM / SQLAlchemy / Diesel 等 ORM 时，可在 prompt 中附带模型文件，让 Agent 输出与 ORM 兼容的 Schema。

使用步骤：

1. 梳理业务实体：列出所有核心实体、字段、生命周期事件与高频查询路径，整理成结构化输入。
2. 设计表结构与索引：按主键、外键、唯一约束、检查约束、覆盖索引的顺序生成 DDL，注明每个索引对应的查询路径。
3. 评估范式与反范式：对读多写少的报表表、宽表场景，给出反范式建议；对强一致业务表，保留 3NF 设计。
4. 规划可逆迁移：对生产环境表结构调整（拆字段、改类型、分区等）生成 expand → backfill → contract 三阶段迁移步骤与回滚方案。
5. MongoDB 建模：对文档型数据，给出嵌入/引用对应规则与组合索引建议，避免后期出现大文档。
6. 运行 Schema 审查清单：用完整性、数据类型、性能、可空性、外键策略清单逐项校验 Schema 并输出修复建议。

适用场景：

• 新 SaaS / 内部系统立项初期，从 0 设计关系型或文档型数据库 Schema。
• 已有 Schema 性能瓶颈或扩展性受限，需要系统性重构与索引补全。
• 生产环境需要做字段拆分、表分区、字段类型变更等高风险迁移。
• 团队从 MySQL 迁移到 PostgreSQL，或从 SQL 转向 MongoDB，需要决策辅助。

工作原理： Skill 加载后会在 Agent 推理上下文中注入「Schema 设计规范 + 索引策略 + 迁移模板 + 审查清单」。Agent 在收到用户的「设计一个 X 业务数据库 / 评审现有 Schema / 设计可逆迁移」指令时，会先梳理实体关系，再按主键/外键/索引/约束顺序生成 DDL，并对生产变更给出可逆迁移步骤。它的设计目标是「让 AI 输出能直接被 DBA 与工程团队评审与落地的 Schema 设计」，而不是替代生产数据库的实际性能压测。

适用人群：

• 后端架构师、数据库管理员（DBA）、数据平台工程师。
• 全栈工程师、独立开发者、独立 SaaS 创业者。
• 负责数据迁移、ETL 流程设计的工程师。
• 任何希望把零散数据库经验沉淀为团队规范的技术团队。

官方链接：

• 技能主页：https://skillstore.io/skills/softaworks-database-schema-designer
• 源码仓库：https://github.com/softaworks/agent-toolkit/tree/main/skills/database-schema-designer/
• 安装命令：npx skillstore add softaworks/database-schema-designer