用途:从数据库 schema、ORM 模型或迁移文件生成带外键感知的确定性示例/种子数据,输出按依赖顺序排列的 INSERT 语句。该工具为只读,不会连接或写入数据库,产物仅用于开发/测试,如 fixtures、本地开发和 CI,绝不可用于生产环境。
主要能力:脚本对表做拓扑排序,保证外键父表先插入;用有效的父记录 id 填充外键列;跳过自增/identity 主键。取值由行索引推导,不使用随机数,因此可复现、便于 diff。
使用方式:命令为 /claude-db:seed,参数为 <path-to-schema> [flags],目标可以是 schema/DDL、ORM 模型或迁移文件。若未给路径,会在工作目录中探测(如 *.sql、schema.prisma、models.py、迁移目录);找不到则明确说明并建议指定文件或运行 /claude-db:design 创建。生成命令:node scripts/gen-seed.mjs --file <schema> --rows N [--format sql|json]。--rows N 默认 5,范围 1–1000;--format 默认 sql,json 返回语句数组加元数据。输出时展示插入顺序(父→子)与各表行数、按该顺序分组的 INSERT 语句、解析器置信度以及被跳过或忽略循环的表;可询问是否保存到文件(如 seed.sql 或 fixtures.json),仅在用户确认路径后写入,否则保持内联。
限制:取值是示意性占位符(如 user1@example.com、固定时间戳、顺序 id),并非真实或隐私安全的生产数据。循环外键在排序时被忽略,延迟约束或自引用场景可能需要在生成后手动处理。仅用于开发/测试 fixtures,切勿对生产数据库运行生成的种子数据。回复语言跟随用户(EN/ES)。