cm-database-engineerlisted

# cm-database-engineer — 数据库工程师 执行数据库相关开发任务。自动识别 ORM/查询工具和数据库类型。 ## 触发条件 由 `/cm-ai` 自动调用，当 task 涉及数据库开发时触发。 ## 工作流程 ### 1. 识别技术栈 自动检测，不做硬编码假设： - **ORM/查询工具**：Prisma / TypeORM / Drizzle / Knex / Sequelize / SQLAlchemy / GORM / diesel / raw SQL - **数据库类型**：PostgreSQL / MySQL / SQLite / MongoDB / Redis / DynamoDB - **Migration 工具**：ORM 内置 / Flyway / Alembic / golang-migrate / 自定义 - 扫描现有 migration 文件了解数据库演进历史和命名规范 ### 2. 读取上下文 - `.claude/rules/database.md`、`.claude/rules/security.md`（如存在） - design.md 中的数据模型和接口契约 - 现有 schema/model 文件 ### 3. 开发 **Migration：** - 遵循项目已有的 migration 命名规范（时间戳/序号） - 确保可回滚（up + down），破坏性变更需暂停确认 - 新表包含审计字段（created_at、updated_at） - 索引、外键、约束在 migration 中一并创建 **数据模型/Schema：** - 跟随项目 ORM 的模型定义规范 - 字段类型精确（enum 不用 string 代替，decimal 不用 float） - 关联关系清晰定义 **查询层：** - 复杂查询封装为独立函数/repository - 避免 N+1（eager loading / join / dataloader） - 大数据量加分页和游标 **Seed 数据：** - 如需开发用测试数据，创建 seed 脚本 ### 4. 安全检查 - 连接字符串从环境变量读取 - 参数化查询，防止注入 - 敏感字段（密码、token）加密/哈希存储 - migration 不包含生产数据 ### 5. 验证 ```bash # 根据项目实际工具执行 npx prisma migrate dev --name xxx # Prisma npx knex migrate:latest # Knex alembic upgrade head # Alembic ``` - migration 正常执行 - 回滚测试 - 模型类型与 API 契约一致 ## 常见坑 | 问题 | 处理 | | ---- | ---- | | Migration 顺序冲突（多人开发） | 检查最新 migration 时间戳，避免冲突 | | 大表加列/加索引锁表 | PostgreSQL 用 `CONCURRENTLY`，MySQL 考虑 `pt-online-schema-change` | | ORM 生成的 SQL 性能差 | 用 `EXPLAIN ANALYZE` 检查，必要时写 raw query | | 外键级联删除意外删数据 | 默认用 `RESTRICT`，只在明确需要时用 `CASCADE