name: mysql-design slug: mysql-design-adodo displayName: MySQL 设计与使用助手 description: 帮助Agent为项目进行MySQL Schema设计、索引设计、查询设计，并提供场景化使用指南。当用户需要设计数据库表结构、优化查询性能、规划分库分表方案时触发。 version: 1.0.2 metadata: clawdbot: emoji: "🐬" requires: anyBins: ["mysql"] os: ["linux", "darwin"]

MySQL 设计与使用助手

7w4.net小葱技能。

触发条件

当用户出现以下意图时激活本 Skill： - 设计 MySQL 表结构 / Schema - MySQL 索引优化 / 查询优化 - 分库分表方案 - 数据迁移方案 - "如何设计 xxx 的数据库"

设计流程（Agent 执行路径）

0. 版本检查 → 加载 references/version-major.md 对比用户版本，识别废弃项和重大变更。同时加载所有 version-X.Y.md（X.Y ≤ 用户目标版本），后续设计过程中 Agent 从已加载的上下文中自主匹配深度特性
1. 需求分析 → 理解业务实体和关系
2. 概念设计 → ER模型，识别实体/关系/属性
3. 规范约束 → 加载 references/design-spec.md，确保命名/字段/索引符合规范
4. 逻辑设计 → 表结构DDL，含索引/约束/注释
5. 物理设计 → 存储引擎/字符集/分区策略
6. 使用指引 → 加载 references/usage-guide.md，给出场景化操作
7. 优化建议 → 加载 references/best-practices.md，给出性能建议
8. 模板参考 → 加载 references/patterns.md，匹配业务模板

快速参考

必备三字段

每张表必须包含：id (BIGINT UNSIGNED AUTO_INCREMENT) / create_time (DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP) / update_time (DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP)

命名铁律

数据类型速查

索引核心原则

1. 唯一特性字段必须建唯一索引
2. 超三表禁止 JOIN — 在应用层组装
3. VARCHAR 索引必须指定长度 — idx_name(name(20))
4. 禁止左模糊/全模糊查询 — 用全文索引或搜索引擎
5. 组合索引区分度高的在左 — idx_status_created(status, created_at)，status 区分度高
6. 覆盖索引避免回表 — 将查询字段纳入索引
7. 延迟关联优化超多分页 — 先查主键再关联

字符集

• 必须使用 utf8mb4（utf8 是3字节，无法存 emoji）
• 排序规则：utf8mb4_unicode_ci（通用）/ utf8mb4_bin（精确匹配）
• JOIN 时 collation 必须一致

渐进式加载

详细内容按需加载 references/：

版本参考文档启用规则

1. 模块激活时 — 始终加载 references/version-major.md，Agent 需主动对比用户使用的 MySQL 版本，若存在废弃项或重大变更，立即提示用户
2. 深度特性 Step 0 自动加载 — 版本检查时加载所有 version-X.Y.md（X.Y ≤ 用户目标版本）。设计过程中 Agent 从已加载的上下文中自主检索匹配相关特性，用户无需指定版本号
3. 深度特性按大版本拆分，小版本持续追加 — 如 version-8.0.md 包含该大版本下所有小版本的设计级特性。更新时在文件中新增 ## X.Y.Z 版本节即可，不单开文件

硬规则

1. 设计规范内容来自权威资料（阿里规约/MySQL官方文档），不编造
2. 所有 CREATE TABLE 必须包含 COMMENT（表注释 + 字段注释）
3. 所有表必须有主键（BIGINT UNSIGNED AUTO_INCREMENT 或分布式ID）
4. 禁止物理删除，使用 is_deleted 逻辑删除
5. 小数禁止用 FLOAT/DOUBLE，必须 DECIMAL
6. 表必须有 create_time 和 update_time
7. 单表超过 500 万行或 2GB 时必须考虑分库分表

这个 Skill 质量不错，内容专业实用，涵盖了 MySQL 表设计、索引优化、分库分表等核心场景。规范严谨、版本支持全面是其亮点，快速参考指南也很实用。不足之处是内容偏向专业规范，普通用户理解起来有一定门槛，且实际应用案例相对较少。建议有一定数据库基础的用户使用效果会更好。