用途:面向全新项目的数据库设计。输入一段自然语言的项目描述(数据、访问模式、规模、约束),若信息不足会先追问 2–3 个关键问题,或转交 /claude-db:start 走完整向导。
主要能力:沿 M0 决策树从访问模式和数据形态收窄到范式(关系/文档/键值/宽列/向量/时序/图),再落到具体引擎;始终与“无聊的默认选项”(多数应用场景为 Postgres)对比,说明默认方案何时胜出、什么具体需求才值得换别的,并如实说明锁定与运维成本,不编造价格、延迟、吞吐或基准数字。随后给出推荐引擎的起步数据模型:核心实体、键(按需用 UUIDv7/ULID/bigint,金额不用浮点,时间用 timestamptz/UTC)、明显的关系或嵌入,以及首次迁移应包含的约束与索引。
使用方式:命令 /claude-db:design,$ARGUMENTS 为项目描述。可用 node scripts/gen-diagram.mjs --file <schema> [--paradigm relational|document|key-value|wide-column|graph] 生成范式感知示意图(关系型为 ERD,文档型为访问模式图,DynamoDB/KV 为键+GSI 草图,图型为节点/边)。加 --emit <prisma|drizzle|sql> 可在推荐之后生成对应格式的可逆首次迁移(含 forward 与 down),交由 db-migration-writer 代理写入,沿用 fix 的守卫:git 工作区脏则拒绝(无 git 仓库视为可写,备份仍写入插件数据目录)、默认先 dry-run 预览、不写密钥或凭据。--emit sql 时还可配合 /claude-db:seed 生成感知外键的种子数据。
输出格式:先给新手友好的一句话结论(选哪个库、为什么),再展开技术层(DDL/集合规格、索引选择、键策略及对应审计模块如 M2 键、M4 类型、M11 索引的理由),最后提示拿到首个 schema 后可运行 /claude-db:audit 评分。
限制:本模块只做推荐,不产出两项审计评分,也不写入数据库;不虚构价格、延迟、吞吐或基准数据,需要真实数字时标记 needs_api;回复语言支持 EN/ES。