@pencilps/avatar-boot-cli 1.0.0

package/templates/.claude/skills/database-design/SKILL.md

@@ -0,0 +1,764 @@
+---
+name: database-design
+description: |
+  根据业务需求生成数据库表 DDL 和索引建议，遵循项目数据库设计规范。
+  触发词: database design, table design, DDL, schema, ER, 数据库设计, 表设计, 建表
+---
+
+# MySQL 建表语句生成器
+
+你是 Avatar Boot MySQL 建表规范的专家助手，帮助开发者快速生成符合规范的标准建表语句。
+
+## 交互流程（必须遵守）
+
+**每次被触发时，先通过 AskUserQuestion 工具询问用户需求：**
+
+问题："您好！我是 MySQL 建表助手，请问您需要什么帮助？"
+选项：
+1. **创建新表** - 生成符合规范的完整建表语句
+2. **查看规范** - 了解命名规范、字段规范、索引规范
+3. **验证表结构** - 检查现有建表语句是否符合规范
+4. **生成关联表** - 创建中间表/关联表
+
+**根据用户选择，按下方流程执行。**
+
+---
+
+## 行为准则
+
+1. **严格遵守规范**：所有生成的建表语句必须符合 `docs/database/mysql-specification.md` 规范
+2. **主动询问信息**：生成表前必须收集必要信息（部门、业务域、实体名、字段等）
+3. **使用中文回答**
+4. **提供完整示例**：包含注释、索引、表注释等完整信息
+
+---
+
+## 创建新表流程
+
+### 第一步：收集基础信息
+
+使用 AskUserQuestion 收集以下信息：
+
+**问题 1**："请选择所属部门"
+选项：
+- 讯飞智作 (zz)
+- 交互平台 (jh)
+- 资产平台 (zc)
+- 大模型 (dm)
+- 其他（请输入部门缩写）
+
+**问题 2**："请输入业务域缩写（如：plt-平台、usr-用户、cms-内容）"
+（文本输入）
+
+**问题 3**："请输入实体名称（如：role-角色、user-用户、article-文章）"
+（文本输入）
+
+**问题 4**："请描述需要哪些业务字段（除基础字段外）"
+（文本输入，示例：角色编码、角色名称、描述、是否启用、排序权重）
+
+### 第二步：生成字段列表并与用户确认
+
+根据收集的信息，生成字段列表并展示给用户：
+
+#### 1. 展示字段列表
+
+以表格形式展示所有字段（包括基础字段和业务字段）：
+
+```markdown
+## 字段列表预览
+
+### 基础字段（必须）
+| 字段名 | 类型 | 是否必填 | 默认值 | 说明 |
+|--------|------|---------|--------|------|
+| id | BIGINT UNSIGNED | 是 | AUTO_INCREMENT | 主键ID |
+| create_time | DATETIME | 是 | CURRENT_TIMESTAMP | 创建时间 |
+| update_time | DATETIME | 是 | CURRENT_TIMESTAMP ON UPDATE | 更新时间 |
+| is_deleted | TINYINT(1) | 是 | 0 | 逻辑删除：0-未删除，1-已删除 |
+
+### 审计字段（可选）
+| 字段名 | 类型 | 是否必填 | 默认值 | 说明 |
+|--------|------|---------|--------|------|
+| created_by | BIGINT UNSIGNED | 是 | 0 | 创建人ID |
+| updated_by | BIGINT UNSIGNED | 是 | 0 | 更新人ID |
+
+### 业务字段
+| 字段名 | 类型 | 是否必填 | 默认值 | 说明 |
+|--------|------|---------|--------|------|
+| role_code | VARCHAR(64) | 是 | - | 角色编码 |
+| role_name | VARCHAR(128) | 是 | - | 角色名称 |
+| description | VARCHAR(512) | 否 | NULL | 角色描述 |
+| is_enabled | TINYINT(1) | 是 | 1 | 是否启用：0-禁用，1-启用 |
+| sort_order | INT | 是 | 0 | 排序权重 |
+
+### 索引设计
+| 索引类型 | 索引名 | 字段 | 说明 |
+|---------|--------|------|------|
+| 主键 | PRIMARY KEY | id | 自动创建 |
+| 唯一索引 | uk_zz_plt_role_code | role_code | 角色编码唯一 |
+| 普通索引 | idx_zz_plt_role_name | role_name | 角色名称查询 |
+```
+
+#### 2. 询问用户确认
+
+使用 AskUserQuestion 询问用户是否需要修改：
+
+**问题**："请确认字段列表是否正确，是否需要修改？"
+选项：
+- **确认无误，生成 SQL** - 直接生成建表语句
+- **需要修改字段** - 说明需要修改的内容（添加、删除、修改字段）
+- **需要调整索引** - 说明需要调整的索引
+- **需要添加特殊字段** - 如租户ID、树形结构、状态机等
+
+#### 3. 根据用户反馈调整
+
+如果用户选择修改，根据用户的反馈调整字段列表，然后重新展示并再次确认。
+
+### 第三步：生成完整 SQL
+
+确认字段列表后，生成包含以下内容的完整建表语句：
+1. 表注释（说明归属部门和业务域）
+2. 所有字段定义（含 COMMENT）
+3. 主键定义
+4. 必要的索引（唯一索引、常用查询字段索引）
+5. 引擎和字符集声明
+
+### 第四步：询问是否保存为 SQL 文件
+
+生成建表语句后，使用 AskUserQuestion 询问用户：
+
+**问题**："建表语句已生成，是否需要保存为 SQL 文件？"
+选项：
+- **保存为 SQL 文件** - 保存到指定位置
+- **仅查看，不保存** - 只在对话中显示
+
+### 第五步：保存 SQL 文件（如果用户选择保存）
+
+如果用户选择保存，再次询问保存位置：
+
+**问题**："请选择保存位置"
+选项：
+- **项目 SQL 目录** - 保存到 `docs/sql/tables/` 目录
+- **自定义位置** - 用户输入完整路径
+
+保存文件时：
+1. 文件名格式：`{表名}.sql`（如：`zz_plt_role.sql`）
+2. 文件内容包含：
+    - 文件头注释（表名、创建时间、说明）
+    - 完整的建表语句
+    - 使用说明注释
+
+文件头注释模板：
+```sql
+-- ============================================
+-- 表名：{表名}
+-- 说明：{表说明}
+-- 归属：{部门名称}({部门缩写}) - {业务域名称}({业务域缩写})
+-- 创建时间：{当前日期}
+-- ============================================
+```
+
+---
+
+## 字段类型选择指南
+
+根据 `references/字段类型规范.md` 选择合适的数据类型：
+
+| 场景 | 推荐类型 | 示例 |
+|------|---------|------|
+| 主键 | `BIGINT UNSIGNED AUTO_INCREMENT` | `id` |
+| 外键 | `BIGINT UNSIGNED` | `user_id`, `role_id` |
+| 编码/Code | `VARCHAR(64)` | `role_code` |
+| 名称/Name | `VARCHAR(128)` | `role_name` |
+| 描述 | `VARCHAR(512)` | `description` |
+| 布尔 | `TINYINT(1)` | `is_enabled` |
+| 排序 | `INT` | `sort_order` |
+| 金额 | `DECIMAL(18,4)` | `amount` |
+| JSON | `JSON` | `config_json` |
+| 时间 | `DATETIME` | `create_time` |
+
+---
+
+## 详细设计规范参考
+
+以下是完整的数据库设计规范，供深入参考使用。
+
+### 命名规范详解
+
+#### 表命名规范
+
+| 规则 | 说明 | 正确示例 | 错误示例 |
+|------|------|----------|----------|
+| snake_case 全小写 | 统一使用下划线分隔 | `zz_plt_user_order` | `T_UserOrder`, `tUserOrder` |
+| 部门_业务域_实体 | 格式：{部门}_{业务域}_{实体} | `zz_plt_user` | `user`, `tb_user`, `t_user` |
+| 有意义的英文名词 | 清晰表达表的业务含义 | `zz_plt_order_item` | `zz_plt_oi`, `table1` |
+| 关联表命名 | 两个实体名拼接 | `zz_plt_user_role` | `zz_plt_ur` |
+
+#### 字段命名规范
+
+| 规则 | 说明 | 正确示例 | 错误示例 |
+|------|------|----------|----------|
+| snake_case 全小写 | 统一使用下划线分隔 | `user_name` | `userName`, `UserName` |
+| 布尔字段 `is_` 前缀 | 表示是否的字段 | `is_deleted`, `is_active` | `deleted`, `active` |
+| 时间字段 `_at` 后缀 | 表示时间的字段 | `create_time`, `update_time` | `created`, `payDate` |
+| 状态字段 `status` | 表示状态的字段 | `order_status` | `order_state`, `sts` |
+| 外键字段 `_id` 后缀 | 引用其他表主键 | `user_id`, `order_id` | `user`, `fk_user` |
+
+### 必需字段说明
+
+每张业务表必须包含以下四个字段：
+
+```sql
+-- 主键：BIGINT 类型，雪花算法生成，不自增
+id BIGINT NOT NULL COMMENT '主键ID',
+
+-- 创建时间：记录数据创建时间
+create_time DATETIME NOT NULL COMMENT '创建时间',
+
+-- 更新时间：记录数据最后更新时间
+update_time DATETIME NOT NULL COMMENT '更新时间',
+
+-- 逻辑删除：0-未删除 1-已删除，不做物理删除
+is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已删除',
+```
+
+> **注意**：`id` 使用 BIGINT 而非 AUTO_INCREMENT，由应用层（MyBatis Plus ASSIGN_ID）生成雪花 ID。
+
+### 数据类型详细指南
+
+#### 类型选择原则
+
+| 场景 | 推荐类型 | 说明 |
+|------|----------|------|
+| 主键、外键 | `BIGINT` | 统一使用 BIGINT，兼容雪花 ID |
+| 短文本（名称、标题） | `VARCHAR(n)` | 明确指定长度，n ≤ 255 |
+| 长文本（描述、备注） | `VARCHAR(n)` 或 `TEXT` | 长度可预估用 VARCHAR，不可预估用 TEXT |
+| 超长文本（文章内容） | `TEXT` / `LONGTEXT` | 仅在必要时使用 |
+| 金额、价格 | `DECIMAL(p, s)` | 禁止使用 FLOAT / DOUBLE，推荐 DECIMAL(10, 2) |
+| 整数计数 | `INT` | 一般场景 |
+| 小整数（状态、类型） | `TINYINT` | 0-127 范围的枚举值 |
+| 日期时间 | `DATETIME` | 不使用 TIMESTAMP（2038 年问题） |
+| 仅日期 | `DATE` | 如生日、有效日期 |
+| 布尔值 | `TINYINT` | 0 和 1，不使用 BIT |
+| JSON 数据 | `JSON` | MySQL 5.7+ 支持，需要 JSON 查询时使用 |
+| 大字段（图片、文件） | 不存库 | 存储到对象存储（OSS），数据库只存 URL |
+
+#### 字段长度建议
+
+| 字段类型 | 推荐长度 | 说明 |
+|----------|----------|------|
+| 用户名 | VARCHAR(64) | |
+| 手机号 | VARCHAR(20) | 预留国际号码长度 |
+| 邮箱 | VARCHAR(128) | |
+| URL | VARCHAR(512) | |
+| IP 地址 | VARCHAR(45) | 兼容 IPv6 |
+| 标题 | VARCHAR(200) | |
+| 备注/描述 | VARCHAR(500) | |
+| 订单号 | VARCHAR(32) | |
+| 密码哈希 | VARCHAR(128) | BCrypt 等哈希结果 |
+
+### 索引设计详解
+
+#### 索引类型
+
+| 索引类型 | 使用场景 | DDL 语法 |
+|----------|----------|----------|
+| 主键索引 | 每表必须有 | `PRIMARY KEY (id)` |
+| 唯一索引 | 业务唯一约束 | `UNIQUE KEY uk_xxx (col)` |
+| 普通索引 | 高频查询条件 | `KEY idx_xxx (col)` |
+| 组合索引 | 多条件联合查询 | `KEY idx_xxx (col1, col2)` |
+
+#### 索引命名规范
+
+| 索引类型 | 前缀 | 示例 |
+|----------|------|------|
+| 主键 | `pk_` | `PRIMARY KEY (id)` |
+| 唯一索引 | `uk_` | `UNIQUE KEY uk_username (username)` |
+| 普通索引 | `idx_` | `KEY idx_user_id (user_id)` |
+| 组合索引 | `idx_` | `KEY idx_status_create_time (status, create_time)` |
+
+#### 组合索引最左前缀原则
+
+组合索引 `(a, b, c)` 可以满足以下查询：
+- `WHERE a = ?` — 命中
+- `WHERE a = ? AND b = ?` — 命中
+- `WHERE a = ? AND b = ? AND c = ?` — 命中
+- `WHERE b = ?` — 不命中
+- `WHERE b = ? AND c = ?` — 不命中
+
+设计组合索引时，将区分度高的列放在前面。
+
+#### 覆盖索引
+
+当查询的所有字段都在索引中时，MySQL 可以直接从索引中读取数据，无需回表：
+
+```sql
+-- 索引: idx_status_create_time (status, create_time)
+-- 覆盖索引查询（只查索引中的字段）
+SELECT status, create_time FROM zz_plt_order WHERE status = 1;
+```
+
+#### 索引设计建议
+
+1. **高频查询条件**必须建索引（WHERE、JOIN 条件）
+2. **区分度低的字段**不建议单独建索引（如 `status` 只有几个值）
+3. **区分度低 + 高频**可组合其他字段建联合索引
+4. 单表索引数量建议不超过 **5 个**
+5. 索引字段总长度建议不超过 **256 字节**
+6. **频繁更新的字段**不建议建索引
+
+### 外键设计原则
+
+#### 逻辑外键（推荐）
+
+使用逻辑外键，不创建物理外键约束：
+
+```sql
+-- 推荐：逻辑外键，不添加 FOREIGN KEY 约束
+CREATE TABLE zz_plt_order_item (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    order_id BIGINT NOT NULL COMMENT '订单ID',  -- 逻辑外键
+    product_id BIGINT NOT NULL COMMENT '商品ID', -- 逻辑外键
+    ...
+    PRIMARY KEY (id),
+    KEY idx_order_id (order_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单商品明细表';
+```
+
+#### 物理外键（禁止）
+
+```sql
+-- 禁止：物理外键约束，影响性能和运维
+FOREIGN KEY (order_id) REFERENCES zz_plt_order(id)
+```
+
+**原因**：
+- 物理外键影响数据库写入性能
+- 增加数据库运维复杂度（数据迁移、分库分表受限）
+- 级联操作可能导致意外的数据变更
+- 数据完整性由应用层保证
+
+### 大表分区策略
+
+当预估单表数据量超过 **500 万行**时，考虑分区或分表：
+
+#### 时间范围分区
+
+适用于日志表、流水表等按时间增长的数据：
+
+```sql
+CREATE TABLE zz_plt_operation_log (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    operation_type VARCHAR(32) NOT NULL COMMENT '操作类型',
+    content TEXT COMMENT '操作内容',
+    create_time DATETIME NOT NULL default CURRENT_TIMESTAMP COMMENT '创建时间',
+    PRIMARY KEY (id, create_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='操作日志表'
+PARTITION BY RANGE (TO_DAYS(create_time)) (
+    PARTITION p202601 VALUES LESS THAN (TO_DAYS('2026-02-01')),
+    PARTITION p202602 VALUES LESS THAN (TO_DAYS('2026-03-01')),
+    PARTITION p202603 VALUES LESS THAN (TO_DAYS('2026-04-01')),
+    PARTITION pmax VALUES LESS THAN MAXVALUE
+);
+```
+
+#### 分表建议
+
+当分区无法满足需求时，考虑按业务维度分表：
+
+- **按用户 ID 取模分表**：`zz_plt_order_00` ~ `zz_plt_order_15`
+- **按时间分表**：`zz_plt_order_202601` ~ `zz_plt_order_202612`
+
+### DDL 完整示例
+
+以订单系统为例：
+
+```sql
+-- ----------------------------
+-- 订单表
+-- ----------------------------
+CREATE TABLE zz_plt_order (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    order_no VARCHAR(32) NOT NULL COMMENT '订单号',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    total_amount DECIMAL(10, 2) NOT NULL DEFAULT 0.00 COMMENT '订单总金额',
+    order_status TINYINT NOT NULL DEFAULT 0 COMMENT '订单状态：0-待支付 1-已支付 2-已发货 3-已完成 4-已取消',
+    remark VARCHAR(500) DEFAULT NULL COMMENT '备注',
+    pay_time DATETIME DEFAULT NULL COMMENT '支付时间',
+    create_time DATETIME NOT NULL default CURRENT_TIMESTAMP COMMENT '创建时间',
+    update_time DATETIME NOT NULL default CURRENT_TIMESTAMP on update CURRENT_TIMESTAMP COMMENT '更新时间',
+    is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已删除',
+    PRIMARY KEY (id),
+    UNIQUE KEY uk_order_no (order_no),
+    KEY idx_user_id (user_id),
+    KEY idx_status_create_time (order_status, create_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单表';
+
+-- ----------------------------
+-- 订单商品明细表
+-- ----------------------------
+CREATE TABLE zz_plt_order_item (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    order_id BIGINT NOT NULL COMMENT '订单ID',
+    product_id BIGINT NOT NULL COMMENT '商品ID',
+    product_name VARCHAR(200) NOT NULL COMMENT '商品名称',
+    quantity INT NOT NULL DEFAULT 1 COMMENT '数量',
+    unit_price DECIMAL(10, 2) NOT NULL COMMENT '单价',
+    subtotal DECIMAL(10, 2) NOT NULL COMMENT '小计',
+    create_time DATETIME NOT NULL default CURRENT_TIMESTAMP COMMENT '创建时间',
+    update_time DATETIME NOT NULL default CURRENT_TIMESTAMP ON UPDATE COMMENT '更新时间',
+    is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已删除',
+    PRIMARY KEY (id),
+    KEY idx_order_id (order_id),
+    KEY idx_product_id (product_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单商品明细表';
+```
+
+### 设计审查清单
+
+设计完成后，按以下清单逐项检查：
+
+#### 表结构审查
+
+- [ ] 表名符合 `{部门}_{业务域}_{实体}` 命名规范
+- [ ] 字段名符合 snake_case 命名规范
+- [ ] 包含 `id`, `create_time`, `update_time`, `is_deleted` 四个必需字段
+- [ ] `id` 使用 `BIGINT NOT NULL`，不自增
+- [ ] 每个字段都有 `COMMENT` 注释
+- [ ] 字段类型选择合理（金额用 DECIMAL，时间用 DATETIME）
+- [ ] VARCHAR 长度合理，不过大也不过小
+- [ ] NOT NULL / DEFAULT 约束合理
+- [ ] 表有 `COMMENT` 注释
+- [ ] 字符集使用 `utf8mb4`
+
+#### 索引审查
+
+- [ ] 主键索引存在
+- [ ] 业务唯一字段有唯一索引
+- [ ] 高频查询条件有索引覆盖
+- [ ] 外键字段有普通索引
+- [ ] 组合索引遵循最左前缀原则
+- [ ] 索引命名符合 `uk_` / `idx_` 前缀规范
+- [ ] 单表索引数量不超过 5 个
+- [ ] 无冗余索引（已被其他组合索引覆盖的单列索引）
+
+#### 关联关系审查
+
+- [ ] 使用逻辑外键，无物理 FOREIGN KEY 约束
+- [ ] 外键字段类型与引用表主键类型一致（BIGINT）
+- [ ] 关联关系在 COMMENT 中说明
+
+### 最佳实践
+
+1. **先理解业务再建表** — 充分理解业务需求后再设计表结构，避免反复修改
+2. **适度冗余** — 允许适度的数据冗余以减少 JOIN 查询（如订单表存商品名称）
+3. **预留扩展** — 状态字段使用 TINYINT 而非 ENUM，方便扩展
+4. **避免过度设计** — 不要为不确定的未来需求添加字段
+5. **字段默认值** — 尽量为字段设置合理的默认值
+6. **注释完整** — 每个字段和表都要有清晰的中文注释
+7. **金额用分** — 如果精度要求高，可以考虑用 BIGINT 存储分，避免浮点精度问题
+8. **状态值说明** — 状态字段的 COMMENT 中列出所有可能的值及含义
+
+### 常见问题解答
+
+#### Q: VARCHAR 和 TEXT 如何选择？
+
+- 长度可预估且 ≤ 65535 字节：使用 `VARCHAR(n)`
+- 长度不可预估或超长内容：使用 `TEXT`
+- VARCHAR 可以建索引，TEXT 只能建前缀索引
+- VARCHAR 参与排序和分组性能优于 TEXT
+
+#### Q: DATETIME 和 TIMESTAMP 如何选择？
+
+推荐统一使用 `DATETIME`：
+- DATETIME 范围：1000-01-01 ~ 9999-12-31
+- TIMESTAMP 范围：1970-01-01 ~ 2038-01-19（存在 2038 年问题）
+- DATETIME 不受时区影响，存什么取什么
+- TIMESTAMP 自动时区转换，跨时区可能导致混乱
+
+#### Q: 如何处理枚举值字段？
+
+推荐使用 `TINYINT` + COMMENT 说明：
+
+```sql
+-- 推荐
+order_status TINYINT NOT NULL DEFAULT 0 COMMENT '订单状态：0-待支付 1-已支付 2-已发货 3-已完成 4-已取消'
+
+-- 不推荐：MySQL ENUM 类型
+order_status ENUM('PENDING', 'PAID', 'SHIPPED') COMMENT '订单状态'
+```
+
+原因：TINYINT 更灵活，新增枚举值不需要 ALTER TABLE。
+
+#### Q: 需要存储树形结构怎么设计？
+
+推荐使用 `parent_id` 邻接表模式：
+
+```sql
+CREATE TABLE zz_plt_department (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    parent_id BIGINT NOT NULL DEFAULT 0 COMMENT '父级ID，顶级为0',
+    name VARCHAR(100) NOT NULL COMMENT '部门名称',
+    sort INT NOT NULL DEFAULT 0 COMMENT '排序号',
+    ...
+    KEY idx_parent_id (parent_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='部门表';
+```
+
+如需高效查询整棵子树，可额外添加 `path` 字段存储路径（如 `/1/3/7/`）。
+
+---
+
+## 生成关联表流程
+
+关联表（中间表）命名规则：`{表A}_{表B}_rel`
+
+必须包含：
+- 基础字段（id, create_time, is_deleted）
+- 两个外键字段（如 `avatar_id`, `role_id`）
+- 联合唯一索引（防止重复关联）
+- 外键字段的普通索引（提升查询性能）
+
+示例：
+```sql
+CREATE TABLE `zz_plt_avatar_role_rel` (
+  `id`          BIGINT UNSIGNED  NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+  `avatar_id`   BIGINT UNSIGNED  NOT NULL COMMENT '虚拟人ID',
+  `role_id`     BIGINT UNSIGNED  NOT NULL COMMENT '角色ID',
+  `create_time`  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `is_deleted`  TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除，1-已删除',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_zz_plt_avatar_role_rel` (`avatar_id`, `role_id`),
+  KEY `idx_zz_plt_avatar_role_rel_role` (`role_id`)
+) ENGINE=InnoDB
+  DEFAULT CHARSET=utf8mb4
+  COLLATE=utf8mb4_0900_ai_ci
+  COMMENT='智作平台-虚拟人角色关联表 [zz][plt]';
+```
+
+---
+
+## 验证表结构流程
+
+检查用户提供的建表语句是否符合规范：
+
+1. **表名检查**：是否符合 `{部门}_{业务域}_{实体}` 格式
+2. **基础字段检查**：是否包含 id, create_time, update_time, is_deleted
+3. **字段注释检查**：每个字段是否有 COMMENT
+4. **索引检查**：主键、唯一约束、常用查询字段是否有索引
+5. **引擎和字符集检查**：是否使用 InnoDB 和 utf8mb4
+6. **表注释检查**：是否包含部门和业务域标识
+
+对于不符合规范的地方，给出具体的修改建议。
+
+---
+
+## 文档读取路由
+
+> 所有路径相对于 skill 目录 `docs/skills/mysql-table-generator-skill/`
+
+| 用户需求 | 需读取的文件 |
+|:--|:--|
+| 查看命名规范 | `references/命名规范.md` |
+| 查看字段类型规范 | `references/字段类型规范.md` |
+| 查看索引规范 | `references/索引规范.md` |
+| 查看完整规范 | `../../database/mysql-specification.md` |
+
+---
+
+## 快速参考
+
+### 常用字段模板
+
+```sql
+-- 编码字段
+`{entity}_code`   VARCHAR(64)      NOT NULL COMMENT '{实体}编码',
+
+-- 名称字段
+`{entity}_name`   VARCHAR(128)     NOT NULL COMMENT '{实体}名称',
+
+-- 描述字段
+`description`     VARCHAR(512)     DEFAULT NULL COMMENT '描述',
+
+-- 启用状态
+`is_enabled`      TINYINT(1)       NOT NULL DEFAULT 1 COMMENT '是否启用：0-禁用，1-启用',
+
+-- 排序权重
+`sort_order`      INT              NOT NULL DEFAULT 0 COMMENT '排序权重',
+
+-- 租户ID（多租户场景）
+`tenant_id`       BIGINT UNSIGNED  NOT NULL DEFAULT 0 COMMENT '租户ID',
+
+-- JSON配置
+`config_json`     JSON             DEFAULT NULL COMMENT '扩展配置（JSON格式）',
+```
+
+### 常用索引模板
+
+```sql
+-- 唯一索引（编码字段）
+UNIQUE KEY `uk_{表名}_{字段}` (`{字段}`),
+
+-- 普通索引（名称字段）
+KEY `idx_{表名}_{字段}` (`{字段}`),
+
+-- 联合索引（租户+删除标记）
+KEY `idx_{表名}_tenant` (`tenant_id`, `is_deleted`),
+
+-- 联合索引（状态+启用+删除）
+KEY `idx_{表名}_status` (`status`, `is_enabled`, `is_deleted`)
+```
+
+---
+
+## 输出格式
+
+生成建表语句后，按以下格式输出：
+
+```markdown
+## 生成的建表语句
+
+### 表信息
+- **表名**：{表名}
+- **归属**：{部门名称}({部门缩写}) - {业务域名称}({业务域缩写})
+- **说明**：{表的用途说明}
+
+### SQL 语句
+
+```sql
+{完整的建表语句}
+```
+
+### Spring 实体类名
+
+根据规范，Spring 实体类不需要前缀，建议使用：`{实体名首字母大写}`
+
+示例：表名 `zz_plt_role` → 实体类 `Role`
+
+### 使用说明
+
+1. 在 MySQL 客户端或工具中执行上述 SQL
+2. 创建对应的 Spring 实体类（继承 BaseEntity）
+3. 创建 Mapper 接口（继承 BaseMapper）
+4. 如需多数据源，使用 @DS 注解指定数据源
+
+### 注意事项
+
+- 所有查询必须带 `AND is_deleted = 0` 条件
+- 建议在 MyBatis Plus 中配置全局逻辑删除
+- 唯一索引字段需要在业务层做唯一性校验
+
+### 文件保存
+
+**已保存到**：`{文件路径}`（如果用户选择保存）
+
+或
+
+**未保存**：如需保存，请告诉我保存位置（如果用户选择不保存）
+```
+
+---
+
+## SQL 文件保存格式
+
+当用户选择保存为 SQL 文件时，使用 Write 工具创建文件，文件内容格式如下：
+
+```sql
+-- ============================================
+-- 表名：{表名}
+-- 说明：{表说明}
+-- 归属：{部门名称}({部门缩写}) - {业务域名称}({业务域缩写})
+-- 创建时间：{当前日期 YYYY-MM-DD}
+-- 生成工具：MySQL 建表语句生成器
+-- ============================================
+
+-- 删除已存在的表（谨慎使用）
+-- DROP TABLE IF EXISTS `{表名}`;
+
+-- 创建表
+{完整的建表语句}
+
+-- ============================================
+-- 使用说明
+-- ============================================
+-- 1. 在 MySQL 客户端或工具中执行上述 SQL
+-- 2. 创建对应的 Spring 实体类（继承 BaseEntity）
+-- 3. 创建 Mapper 接口（继承 BaseMapper）
+-- 4. 如需多数据源，使用 @DS 注解指定数据源
+--
+-- 注意事项：
+-- - 所有查询必须带 AND is_deleted = 0 条件
+-- - 建议在 MyBatis Plus 中配置全局逻辑删除
+-- - 唯一索引字段需要在业务层做唯一性校验
+-- ============================================
+```
+
+### 保存路径规则
+
+1. **项目 SQL 目录**：`docs/sql/tables/{表名}.sql`
+2. **自定义位置**：用户指定的完整路径
+
+保存前检查目录是否存在，如不存在则创建。
+
+根据规范，Spring 实体类不需要前缀，建议使用：`{实体名首字母大写}`
+
+示例：表名 `zz_plt_role` → 实体类 `Role`
+
+### 使用说明
+
+1. 在 MySQL 客户端或工具中执行上述 SQL
+2. 创建对应的 Spring 实体类（继承 BaseEntity）
+3. 创建 Mapper 接口（继承 BaseMapper）
+4. 如需多数据源，使用 @DS 注解指定数据源
+
+### 注意事项
+
+- 所有查询必须带 `AND is_deleted = 0` 条件
+- 建议在 MyBatis Plus 中配置全局逻辑删除
+- 唯一索引字段需要在业务层做唯一性校验
+```
+
+---
+
+## 示例对话
+
+**用户**："帮我创建一个角色表"
+
+**助手**：
+1. 使用 AskUserQuestion 询问部门、业务域、字段信息
+2. 根据用户回答生成完整建表语句
+3. 提供 Spring 实体类建议和使用说明
+
+**用户**："检查这个建表语句是否符合规范：CREATE TABLE user ..."
+
+**助手**：
+1. 读取用户提供的 SQL
+2. 逐项检查是否符合规范
+3. 列出不符合的地方并给出修改建议
+4. 提供修正后的完整 SQL
+
+---
+
+## 特殊场景处理
+
+### 多租户表
+自动添加 `tenant_id` 字段和相关索引：
+```sql
+`tenant_id`     BIGINT UNSIGNED  NOT NULL DEFAULT 0 COMMENT '租户ID',
+KEY `idx_{表名}_tenant` (`tenant_id`, `is_deleted`),
+```
+
+### 树形结构表
+添加父节点字段：
+```sql
+`parent_id`     BIGINT UNSIGNED  NOT NULL DEFAULT 0 COMMENT '父节点ID',
+`level`         INT              NOT NULL DEFAULT 0 COMMENT '层级',
+`path`          VARCHAR(512)     DEFAULT NULL COMMENT '路径（如：/1/2/3/）',
+KEY `idx_{表名}_parent` (`parent_id`),
+```
+
+### 状态机表
+添加状态字段和状态索引：
+```sql
+`status`        TINYINT          NOT NULL DEFAULT 0 COMMENT '状态：0-待审核，1-已通过，2-已拒绝',
+KEY `idx_{表名}_status` (`status`, `is_deleted`),
+```