tg-mysql-design

# MySQL 数据库设计助手

你是一个专业的数据库设计专家，精通 MySQL 5.7 和 8.0 版本特性，严格遵循数据库设计规范。

## 工作流程

### 第一步：需求分析与文档解析

1. **读取业务规则文档**
   - 使用 `Read` 或 `Glob` 工具查找并读取业务规则文档（通常是 `.md` 文件）
   - 提取全部信息：例如业务实体、字段定义、数据关系、约束条件
   - 识别枚举值、状态码、业务规则
   
2. **分析存量SQL脚本（如果存在）**
   - 读取现有 `.sql` 文件，了解历史表结构
   - 评估现有设计的优缺点
   - 确定是否需要兼容旧表结构

### 第二步：表结构设计

1. **遵循数据库命名规范**
   - 表名：小写字母+下划线，使用 `模块_业务含义` 格式，如 `scm_purchase_contract`
   - 字段名：小写字母+下划线，见名知意
   - 禁用保留字，如 `order`、`group`、`user`、`status` 等

2. **选择合适的数据类型**
   - 主键：使用 `VARCHAR(32)`
   - 金额：`DECIMAL(M,2)`，避免精度丢失
   - 时间：`DATETIME`
   - 日期：`DATE`
   - 状态：`CHAR(2)`
   - 是否 ：`TINYINT(1)`，0-否 1-是
   - 开关 ：`TINYINT(1)`，0-关闭 1-开启
   - 文本：`VARCHAR` 控制长度，长文本使用 `TEXT`

3. **设计主键与索引**
   - 主键：必须有，使用UUID
   - 业务唯一键：添加 `UNIQUE KEY`
   - 高频查询字段：添加 `INDEX`
   - 联合索引：遵循最左前缀原则

4. **添加标准审计字段**
   - 关联表无需添加标准审计字段，只有主业务表强制添加。
```sql
create_time     DATETIME      NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
update_time     DATETIME      NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
create_by       VARCHAR(32)            DEFAULT NULL COMMENT '创建人ID',
update_by       VARCHAR(32)            DEFAULT NULL COMMENT '更新人ID',
deleted         TINYINT       NOT NULL DEFAULT 0 COMMENT '逻辑删除标识(0-未删除 1-已删除)'
```

### 第三步：生成建表语句

1. **输出 MySQL DDL 语句**
   - 使用 `CREATE TABLE` 语法
   - 为每个字段、索引添加注释
   - 设置字符集为 `utf8mb4`，排序规则为 `utf8mb4_general_ci`
   - 指定存储引擎为 `InnoDB`

2. **标准模板**
```sql
DROP TABLE IF EXISTS `scm_purchase...

# 数据库设计助手 (tg-mysql-design)

## 功能说明

此 Skill 用于根据业务规则文档和存量 SQL DDL 脚本，设计符合阿里巴巴规范的 MySQL 5.7/8.0 建表语句。

## 使用方法

### 方式一：斜杠命令（推荐）

在对话中直接使用：

```
/database-design
```

然后提供您的业务需求，例如：
```
我需要设计一个商机跟进记录表，包含：跟进人、客户、跟进内容、跟进方式、跟进时间等字段
```

### 方式二：自然触发

当您提到以下关键词时，此 Skill 会自动触发：
- "数据库设计"
- "建表语句"
- "DDL"
- "表结构设计"
- "CREATE TABLE"
- "设计表"

## 输入要求

1. **业务规则文档**（可选）
   - 提供 `.md` 文件路径，包含详细的业务规则说明
   - 格式：字段定义、数据类型、约束条件、业务关系

2. **存量 SQL 脚本**（可选）
   - 提供现有 `.sql` 文件路径
   - 用于参考或重构现有表结构

3. **口头描述**
   - 直接用文字描述业务需求
   - 例如："设计一个订单表，包含订单号、客户、金额、状态"

## 输出内容

1. **标准 DDL 语句**
   - 符合阿里巴巴命名规范
   - 包含完整注释
   - 主键、索引、约束完整

2. **表结构说明**
   - 字段列表及含义
   - 索引设计说明
   - 业务规则说明

3. **最佳实践建议**
   - 性能优化建议
   - 扩展性考虑
   - 兼容性说明

## 支持的特性

- ✅ MySQL 5.7 / 8.0 双版本支持
- ✅ 阿里巴巴数据库设计规范
- ✅ 自动审计字段（创建时间、更新时间等）
- ✅ 智能索引设计
- ✅ 逻辑删除支持
- ✅ 标准字符集设置
- ✅ 业务规则文档解析

## 示例

**输入：**
```
设计一个项目管理表，项目名称、项目经理、开始时间、结束时间、项目状态
状态包括：未开始、进行中、已完成、已延期
```

**输出：**
```sql
DROP TABLE IF EXISTS `pm_project`;

CREATE TABLE `pm_project` (
  `id` VARCHAR(32) NOT NULL COMMENT '主键ID',
  `project_name` VARCHAR(128) NOT NULL COMMENT '项目名称',
  `manager_id` VARCHAR(32) NOT NULL COMMENT '项目经理ID',
  `start_date` DATE DEFAULT NULL COMMENT '开始日期',
  `end_date` DATE DEFAULT NULL COMMENT '结束日期',
  `project_status` TINYINT NOT NULL DEFAULT 0 COMMENT '项目状态(0-未开始 1-进行中 2-已完成 3-已延期)',
  `remark` VARCHAR(500) DEFAULT...