示例技能，用于 PluginRegistry 测试
代码质量综合技能包（代码审查 + 单元测试）
RESTful API design best practices and conventions guide
Git 提交规范（Conventional Commits）
Java 编码最佳实践与设计模式
代码审查最佳实践指南
| name | database-design |
| description | 数据库设计规范与优化指南 |
| version | 1.0.0 |
| category | development |
| triggers | ["database design","数据库设计","SQL 优化","表设计","数据库规范"] |
| scriptPath | check-db.sh |
| scriptType | bash |
| autoExecute | true |
| scriptTimeout | 10 |
设计高效、可维护的数据库结构。
表名：
users, order_items, user_profiles字段名：
created_at, user_id, email_address索引名：
-- 主键：pk_表名
PRIMARY KEY pk_users
-- 唯一索引：uk_表名_字段名
UNIQUE INDEX uk_users_email
-- 普通索引：idx_表名_字段名
INDEX idx_users_created_at
-- 外键：fk_表名_关联表名
FOREIGN KEY fk_orders_users
| 数据类型 | 使用场景 | 示例 |
|---|---|---|
| INT/BIGINT | ID、数量、年龄 | user_id BIGINT |
| VARCHAR | 变长字符串 | name VARCHAR(100) |
| CHAR | 定长字符串 | country_code CHAR(2) |
| TEXT | 长文本 | description TEXT |
| DECIMAL | 金额、精确数值 | price DECIMAL(10,2) |
| DATETIME | 日期时间 | created_at DATETIME |
| ENUM | 固定选项 | status ENUM('active','inactive') |
| BOOLEAN | 布尔值 | is_deleted BOOLEAN |
注意：
推荐：
-- 自增ID（适合单机）
id BIGINT AUTO_INCREMENT PRIMARY KEY
-- 雪花ID（适合分布式）
id BIGINT PRIMARY KEY COMMENT '雪花ID'
-- UUID（分布式场景）
id CHAR(36) PRIMARY KEY COMMENT 'UUID'
避免：
使用外键的优势：
不使用外键的场景：
-- 外键示例
FOREIGN KEY (user_id)
REFERENCES users(id)
ON DELETE CASCADE
ON UPDATE CASCADE
主键索引：
PRIMARY KEY (id)
唯一索引：
UNIQUE INDEX uk_users_email (email)
普通索引：
INDEX idx_users_created_at (created_at)
联合索引（遵循最左前缀原则）：
INDEX idx_users_name_age (name, age)
-- 可以走索引: WHERE name = 'xxx'
-- 可以走索引: WHERE name = 'xxx' AND age = 25
-- 不走索引: WHERE age = 25
全文索引：
FULLTEXT INDEX ft_articles_content (content)
何时创建索引：
何时避免索引：
索引失效场景：
-- ❌ 在索引列上使用函数
WHERE YEAR(created_at) = 2025
-- ✓ 改为
WHERE created_at >= '2025-01-01' AND created_at < '2026-01-01'
-- ❌ 模糊查询前导模糊
WHERE name LIKE '%张%'
-- ✓ 改为
WHERE name LIKE '张%'
-- ❌ 类型转换
WHERE user_id = '123' -- user_id 是 INT
-- ✓ 改为
WHERE user_id = 123
**避免 SELECT ***：
-- ❌ 不推荐
SELECT * FROM users;
-- ✓ 推荐
SELECT id, name, email FROM users;
使用 LIMIT：
SELECT id, name FROM users LIMIT 100;
避免 N+1 查询：
-- ❌ N+1 问题
SELECT * FROM orders; -- 查询 N 个订单
-- 然后循环查询每个订单的用户
SELECT * FROM users WHERE id = ?;
-- ✓ 使用 JOIN
SELECT o.*, u.name
FROM orders o
JOIN users u ON o.user_id = u.id;
传统分页（大偏移量性能差）：
SELECT * FROM users LIMIT 100000, 20;
优化方案（使用 ID 范围）：
SELECT * FROM users
WHERE id > 100000
ORDER BY id
LIMIT 20;
使用覆盖索引：
SELECT id, name FROM users
WHERE status = 'active'
ORDER BY created_at
LIMIT 20;
避免 COUNT(*)：
-- ❌ 慢
SELECT COUNT(*) FROM users WHERE status = 'active';
-- ✓ 使用近似值（如缓存）
-- 或者定期统计存到另一个表
每个字段都是不可分割的原子值
消除部分依赖（非主键字段完全依赖主键）
消除传递依赖（非主键字段不依赖其他非主键字段）
为了性能适当冗余数据：
-- 订单表冗余用户名（避免频繁JOIN）
CREATE TABLE orders (
id BIGINT PRIMARY KEY,
user_id BIGINT,
user_name VARCHAR(100), -- 冗余字段
total_amount DECIMAL(10,2)
);
id BIGINT AUTO_INCREMENT PRIMARY KEY,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
is_deleted BOOLEAN DEFAULT FALSE,
created_by BIGINT,
updated_by BIGINT
version INT NOT NULL DEFAULT 0
deleted_at DATETIME NULL,
is_deleted BOOLEAN DEFAULT FALSE
按业务模块拆分表
-- 按 user_id 取模
user_0, user_1, user_2, ...
-- 按时间分表
order_202501, order_202502, ...