@llryiop/avatar-boot-cli 1.0.0 → 1.0.2

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

@@ -5,59 +5,205 @@ description: |
   触发词: database design, table design, DDL, schema, ER, 数据库设计, 表设计, 建表
 ---
 
-# 数据库设计技能 (Database Design Skill)
+# MySQL 建表语句生成器
 
-## 概述
+你是 Avatar Boot MySQL 建表规范的专家助手，帮助开发者快速生成符合规范的标准建表语句。
 
-本技能根据业务需求描述，生成符合 Avatar Boot 项目规范的数据库表 DDL、索引设计和优化建议。输出可直接用于 CRUD 代码生成。
+## 交互流程（必须遵守）
+
+**每次被触发时，先通过 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 | 角色名称查询 |
 ```
-设计一个订单管理系统，需要管理：
-- 订单信息：订单号、用户ID、订单金额、订单状态、备注
-- 订单商品明细：关联订单、商品ID、商品名称、数量、单价、小计
-- 订单状态包括：待支付、已支付、已发货、已完成、已取消
+
+#### 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` 选择合适的数据类型：
 
-1. **DDL 建表语句** — 完整的 CREATE TABLE 语句
-2. **索引建议** — 索引设计及理由
-3. **设计说明** — 关键设计决策的说明
+| 场景 | 推荐类型 | 示例 |
+|------|---------|------|
+| 主键 | `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 全小写 | 统一使用下划线分隔 | `t_user_order` | `T_UserOrder`, `tUserOrder` |
-| 模块前缀 `t_` | 所有业务表以 `t_` 开头 | `t_user` | `user`, `tb_user` |
-| 有意义的英文名词 | 清晰表达表的业务含义 | `t_order_item` | `t_oi`, `t_table1` |
-| 关联表命名 | 两个实体名拼接 | `t_user_role` | `t_ur` |
+| 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` |
-| 时间字段 `_time` 后缀 | 表示时间的字段 | `create_time`, `pay_time` | `created`, `payDate` |
+| 时间字段 `_at` 后缀 | 表示时间的字段 | `create_time`, `update_time` | `created`, `payDate` |
 | 状态字段 `status` | 表示状态的字段 | `order_status` | `order_state`, `sts` |
 | 外键字段 `_id` 后缀 | 引用其他表主键 | `user_id`, `order_id` | `user`, `fk_user` |
 
----
-
-## 必需字段
+### 必需字段说明
 
 每张业务表必须包含以下四个字段：
 
@@ -75,13 +221,11 @@ update_time DATETIME NOT NULL COMMENT '更新时间',
 is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已删除',
 ```
 
-> 注意：`id` 使用 BIGINT 而非 AUTO_INCREMENT，由应用层（MyBatis Plus ASSIGN_ID）生成雪花 ID。
+> **注意**：`id` 使用 BIGINT 而非 AUTO_INCREMENT，由应用层（MyBatis Plus ASSIGN_ID）生成雪花 ID。
 
----
+### 数据类型详细指南
 
-## 数据类型指南
-
-### 类型选择原则
+#### 类型选择原则
 
 | 场景 | 推荐类型 | 说明 |
 |------|----------|------|
@@ -98,7 +242,7 @@ is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已
 | JSON 数据 | `JSON` | MySQL 5.7+ 支持，需要 JSON 查询时使用 |
 | 大字段（图片、文件） | 不存库 | 存储到对象存储（OSS），数据库只存 URL |
 
-### 字段长度建议
+#### 字段长度建议
 
 | 字段类型 | 推荐长度 | 说明 |
 |----------|----------|------|
@@ -112,11 +256,9 @@ is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已
 | 订单号 | VARCHAR(32) | |
 | 密码哈希 | VARCHAR(128) | BCrypt 等哈希结果 |
 
----
-
-## 索引设计原则
+### 索引设计详解
 
-### 索引类型
+#### 索引类型
 
 | 索引类型 | 使用场景 | DDL 语法 |
 |----------|----------|----------|
@@ -125,7 +267,7 @@ is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已
 | 普通索引 | 高频查询条件 | `KEY idx_xxx (col)` |
 | 组合索引 | 多条件联合查询 | `KEY idx_xxx (col1, col2)` |
 
-### 索引命名规范
+#### 索引命名规范
 
 | 索引类型 | 前缀 | 示例 |
 |----------|------|------|
@@ -134,7 +276,7 @@ is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已
 | 普通索引 | `idx_` | `KEY idx_user_id (user_id)` |
 | 组合索引 | `idx_` | `KEY idx_status_create_time (status, create_time)` |
 
-### 组合索引最左前缀原则
+#### 组合索引最左前缀原则
 
 组合索引 `(a, b, c)` 可以满足以下查询：
 - `WHERE a = ?` — 命中
@@ -145,17 +287,17 @@ is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已
 
 设计组合索引时，将区分度高的列放在前面。
 
-### 覆盖索引
+#### 覆盖索引
 
 当查询的所有字段都在索引中时，MySQL 可以直接从索引中读取数据，无需回表：
 
 ```sql
 -- 索引: idx_status_create_time (status, create_time)
 -- 覆盖索引查询（只查索引中的字段）
-SELECT status, create_time FROM t_order WHERE status = 1;
+SELECT status, create_time FROM zz_plt_order WHERE status = 1;
 ```
 
-### 索引设计建议
+#### 索引设计建议
 
 1. **高频查询条件**必须建索引（WHERE、JOIN 条件）
 2. **区分度低的字段**不建议单独建索引（如 `status` 只有几个值）
@@ -164,17 +306,15 @@ SELECT status, create_time FROM t_order WHERE status = 1;
 5. 索引字段总长度建议不超过 **256 字节**
 6. **频繁更新的字段**不建议建索引
 
----
-
-## 外键设计
+### 外键设计原则
 
-### 逻辑外键（推荐）
+#### 逻辑外键（推荐）
 
 使用逻辑外键，不创建物理外键约束：
 
 ```sql
 -- 推荐：逻辑外键，不添加 FOREIGN KEY 约束
-CREATE TABLE t_order_item (
+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', -- 逻辑外键
@@ -184,11 +324,11 @@ CREATE TABLE t_order_item (
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单商品明细表';
 ```
 
-### 物理外键（禁止）
+#### 物理外键（禁止）
 
 ```sql
 -- 禁止：物理外键约束，影响性能和运维
-FOREIGN KEY (order_id) REFERENCES t_order(id)
+FOREIGN KEY (order_id) REFERENCES zz_plt_order(id)
 ```
 
 **原因**：
@@ -197,22 +337,20 @@ FOREIGN KEY (order_id) REFERENCES t_order(id)
 - 级联操作可能导致意外的数据变更
 - 数据完整性由应用层保证
 
----
-
-## 大表分区策略
+### 大表分区策略
 
 当预估单表数据量超过 **500 万行**时，考虑分区或分表：
 
-### 时间范围分区
+#### 时间范围分区
 
 适用于日志表、流水表等按时间增长的数据：
 
 ```sql
-CREATE TABLE t_operation_log (
+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 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)) (
@@ -223,16 +361,14 @@ PARTITION BY RANGE (TO_DAYS(create_time)) (
 );
 ```
 
-### 分表建议
+#### 分表建议
 
 当分区无法满足需求时，考虑按业务维度分表：
 
-- **按用户 ID 取模分表**：`t_order_00` ~ `t_order_15`
-- **按时间分表**：`t_order_202601` ~ `t_order_202612`
+- **按用户 ID 取模分表**：`zz_plt_order_00` ~ `zz_plt_order_15`
+- **按时间分表**：`zz_plt_order_202601` ~ `zz_plt_order_202612`
 
----
-
-## DDL 完整示例
+### DDL 完整示例
 
 以订单系统为例：
 
@@ -240,7 +376,7 @@ PARTITION BY RANGE (TO_DAYS(create_time)) (
 -- ----------------------------
 -- 订单表
 -- ----------------------------
-CREATE TABLE t_order (
+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',
@@ -248,8 +384,8 @@ CREATE TABLE t_order (
     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 COMMENT '创建时间',
-    update_time DATETIME NOT 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),
@@ -260,7 +396,7 @@ CREATE TABLE t_order (
 -- ----------------------------
 -- 订单商品明细表
 -- ----------------------------
-CREATE TABLE t_order_item (
+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',
@@ -268,8 +404,8 @@ CREATE TABLE t_order_item (
     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 COMMENT '创建时间',
-    update_time DATETIME 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),
@@ -277,15 +413,13 @@ CREATE TABLE t_order_item (
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单商品明细表';
 ```
 
----
-
-## 审查清单
+### 设计审查清单
 
 设计完成后，按以下清单逐项检查：
 
-### 表结构审查
+#### 表结构审查
 
-- [ ] 表名符合 `t_模块_实体` 命名规范
+- [ ] 表名符合 `{部门}_{业务域}_{实体}` 命名规范
 - [ ] 字段名符合 snake_case 命名规范
 - [ ] 包含 `id`, `create_time`, `update_time`, `is_deleted` 四个必需字段
 - [ ] `id` 使用 `BIGINT NOT NULL`，不自增
@@ -296,7 +430,7 @@ CREATE TABLE t_order_item (
 - [ ] 表有 `COMMENT` 注释
 - [ ] 字符集使用 `utf8mb4`
 
-### 索引审查
+#### 索引审查
 
 - [ ] 主键索引存在
 - [ ] 业务唯一字段有唯一索引
@@ -307,15 +441,13 @@ CREATE TABLE t_order_item (
 - [ ] 单表索引数量不超过 5 个
 - [ ] 无冗余索引（已被其他组合索引覆盖的单列索引）
 
-### 关联关系审查
+#### 关联关系审查
 
 - [ ] 使用逻辑外键，无物理 FOREIGN KEY 约束
 - [ ] 外键字段类型与引用表主键类型一致（BIGINT）
 - [ ] 关联关系在 COMMENT 中说明
 
----
-
-## 最佳实践
+### 最佳实践
 
 1. **先理解业务再建表** — 充分理解业务需求后再设计表结构，避免反复修改
 2. **适度冗余** — 允许适度的数据冗余以减少 JOIN 查询（如订单表存商品名称）
@@ -326,18 +458,16 @@ CREATE TABLE t_order_item (
 7. **金额用分** — 如果精度要求高，可以考虑用 BIGINT 存储分，避免浮点精度问题
 8. **状态值说明** — 状态字段的 COMMENT 中列出所有可能的值及含义
 
----
-
-## 常见问题排查
+### 常见问题解答
 
-### Q: VARCHAR 和 TEXT 如何选择？
+#### Q: VARCHAR 和 TEXT 如何选择？
 
 - 长度可预估且 ≤ 65535 字节：使用 `VARCHAR(n)`
 - 长度不可预估或超长内容：使用 `TEXT`
 - VARCHAR 可以建索引，TEXT 只能建前缀索引
 - VARCHAR 参与排序和分组性能优于 TEXT
 
-### Q: DATETIME 和 TIMESTAMP 如何选择？
+#### Q: DATETIME 和 TIMESTAMP 如何选择？
 
 推荐统一使用 `DATETIME`：
 - DATETIME 范围：1000-01-01 ~ 9999-12-31
@@ -345,7 +475,7 @@ CREATE TABLE t_order_item (
 - DATETIME 不受时区影响，存什么取什么
 - TIMESTAMP 自动时区转换，跨时区可能导致混乱
 
-### Q: 如何处理枚举值字段？
+#### Q: 如何处理枚举值字段？
 
 推荐使用 `TINYINT` + COMMENT 说明：
 
@@ -359,12 +489,12 @@ order_status ENUM('PENDING', 'PAID', 'SHIPPED') COMMENT '订单状态'
 
 原因：TINYINT 更灵活，新增枚举值不需要 ALTER TABLE。
 
-### Q: 需要存储树形结构怎么设计？
+#### Q: 需要存储树形结构怎么设计？
 
 推荐使用 `parent_id` 邻接表模式：
 
 ```sql
-CREATE TABLE t_department (
+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 '部门名称',
@@ -375,3 +505,260 @@ CREATE TABLE t_department (
 ```
 
 如需高效查询整棵子树，可额外添加 `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`),
+```