用途:当用户要求创建 schema、设计数据库表、建模实体、规划数据层或创建 ERD 时,从功能需求出发设计生产就绪的数据模型,产出实体定义、关系、Mermaid ERD、索引建议与迁移安全分析。
主要能力:先读取 .chalk/docs/engineering/ 中的既有数据模型、架构文档与 ADR/RFC,无文档时扫描迁移文件、ORM 模型或 schema 文件以推断命名、时间戳、软删除与 ID 策略约定;用 Grep 扫描现有表结构、命名风格(snake_case/camelCase)与主键策略;澄清领域内的实体、关系(一对一、一对多、多对多)、关键查询与数据量增长;为每个实体定义表名、全部列及类型约束默认值、主键、外键与 ON DELETE 行为;为关系选择外键落位;生成 Mermaid ERD;按查询模式建议主键、外键、复合、部分(如 WHERE deleted_at IS NULL)与唯一索引;逐项评估迁移锁表、可逆性、回填与零停机;将文档写入 .chalk/docs/engineering/<n>data_model<domain_slug>.md 并确认路径、实体清单与迁移风险。
强制列:每表默认包含 id(遵循项目主键约定)、created_at、updated_at、deleted_at(可空软删除标记),除非有记录在案的理由省略。仅当日志、事件、指标等高吞吐瞬态数据由 TTL 管理,或连接表本身无独立身份时,才可跳过软删除并需在文档中说明。
限制与注意:文档会列出应避免的反模式,如外键无索引、无时间戳、硬删除、无理由的可空外键、未做迁移安全评审、无刷新策略的派生数据、数据库级 ENUM、缺少业务唯一约束。相关规则与迁移安全表为方法说明,具体采用需结合项目数据库与版本;原文未提供收费、价格与具体安装命令信息。