kingxiaozhe 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. 验证
# 根据项目实际工具执行
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 |
输出
- 创建的 migration 文件和 schema 变更
- 验证结果
- 需要其他工种配合的事项