@gordon.gan/specflow 1.4.0-beta → 1.4.1

package/skills/database/elasticsearch/references/07-cluster-ops.md

@@ -0,0 +1,225 @@
+# 集群运维
+
+## 节点类型
+
+| 类型 | 角色 | 职责 | 推荐配置 |
+|------|------|------|---------|
+| **Master** | `[master]` | 集群管理、元数据、选主 | 3 个专用, 4C 8G |
+| **Data** | `[data]` | 存储数据、查询/聚合 | N 个, 8C 32G+ SSD |
+| **Ingest** | `[ingest]` | 数据预处理管道 | 日志量大时可用 |
+| **Coordinating** | `[]` | 请求分发、结果合并 | 大查询场景, 8C 32G+ |
+
+**生产环境推荐**：3 个专用 Master + N 个 Data + 2 个 Coordinating。
+
+## 发现与选主
+
+```yaml
+# elasticsearch.yml
+discovery.seed_hosts: ["node1:9300", "node2:9300", "node3:9300"]
+cluster.initial_master_nodes: ["node1", "node2", "node3"]
+```
+
+**防脑裂**：专用 Master 节点、奇数个 (≥3)、堆内存 ≤50% 物理内存。
+
+## 分片分配与再平衡
+
+```bash
+# 查看分片分配
+GET /_cat/shards?v
+
+# 延迟分片分配 (重启节点时)
+PUT /_all/_settings
+{
+  "settings": {
+    "index.unassigned.node_left.delayed_timeout": "5m"
+  }
+}
+
+# 取消再平衡 (维护时)
+PUT /_cluster/settings
+{
+  "transient": {
+    "cluster.routing.rebalance.enable": "none"
+  }
+}
+
+# 重新路由
+POST /_cluster/reroute
+{
+  "commands": [
+    {
+      "move": {
+        "index": "my_index",
+        "shard": 0,
+        "from_node": "node-1",
+        "to_node": "node-2"
+      }
+    }
+  ]
+}
+```
+
+## 快照与恢复 (Snapshot/Restore)
+
+```bash
+# 1. 注册快照仓库
+PUT /_snapshot/my_backup
+{
+  "type": "s3",
+  "settings": {
+    "bucket": "my-es-backups",
+    "region": "us-east-1",
+    "base_path": "elasticsearch/backups"
+  }
+}
+
+# 2. 创建快照
+PUT /_snapshot/my_backup/snapshot_20240101
+{
+  "indices": "logs-*,products",
+  "ignore_unavailable": true,
+  "include_global_state": true
+}
+
+# 3. 查看状态
+GET /_snapshot/my_backup/snapshot_20240101/_status
+
+# 4. 恢复
+POST /_snapshot/my_backup/snapshot_20240101/_restore
+{
+  "indices": "products",
+  "rename_pattern": "(.+)",
+  "rename_replacement": "restored_$1"
+}
+
+# 5. SLM 自动管理
+PUT /_slm/policy/daily_snapshot
+{
+  "name": "<daily-snap-{now/d}>",
+  "repository": "my_backup",
+  "schedule": "0 30 1 * * ?",
+  "retention": {
+    "expire_after": "30d",
+    "min_count": 5,
+    "max_count": 50
+  }
+}
+```
+
+## ILM — 索引生命周期管理
+
+```json
+PUT /_ilm/policy/logs_policy
+{
+  "policy": {
+    "phases": {
+      "hot": {
+        "min_age": "0ms",
+        "actions": {
+          "rollover": {
+            "max_size": "50GB",
+            "max_age": "1d",
+            "max_docs": 5000000
+          }
+        }
+      },
+      "warm": {
+        "min_age": "7d",
+        "actions": {
+          "shrink": { "number_of_shards": 1 },
+          "forcemerge": { "max_num_segments": 1 },
+          "allocate": { "require": { "box_type": "warm" } }
+        }
+      },
+      "cold": {
+        "min_age": "30d",
+        "actions": {
+          "searchable_snapshot": {
+            "snapshot_repository": "my_backup"
+          }
+        }
+      },
+      "delete": {
+        "min_age": "365d",
+        "actions": { "delete": {} }
+      }
+    }
+  }
+}
+```
+
+**生命周期**：hot (热节点 SSD) → warm (温节点 HDD) → cold (可搜索快照) → delete。
+
+## 监控命令
+
+```bash
+# 集群健康
+GET /_cluster/health?pretty
+
+# 节点信息
+GET /_cat/nodes?v&h=name,node.role,heap.percent,ram.percent,cpu,load_1m,master
+
+# 索引信息
+GET /_cat/indices?v&h=index,docs.count,store.size,pri.store.size
+GET /_cat/shards?v
+
+# 热点线程 (排查 CPU 突增)
+GET /_nodes/hot_threads
+
+# 待处理任务
+GET /_cat/pending_tasks
+
+# 节点统计
+GET /_nodes/stats/indices,os,process,jvm,fs,transport,http
+
+# 任务管理
+GET /_tasks?detailed&actions=*byquery
+POST /_tasks/<task_id>/_cancel
+```
+
+## 性能优化
+
+### 分片黄金法则
+
+- 每个分片 20-50GB (最佳)
+- 每 GB 堆内存 20-25 个分片 (含副本)
+- 案例: 1TB → 20-25 主分片 × 1 副本 = 40-50 总分片
+
+### 写入优化
+
+1. 关闭 refresh (`refresh_interval: -1`)
+2. 增加 translog 同步间隔 (`30s`)
+3. Bulk API (5-15MB/批)
+4. 副本数设为 0 (写完恢复)
+5. 合理 mapping (关闭 norms 等)
+
+### 查询优化
+
+- filter 优先 (可缓存, 不贡献算分)
+- 避免 script 查询
+- search_after 替代深度 from+size
+- 限制 _source 返回字段
+
+### 慢查询日志
+
+```bash
+PUT /_settings
+{
+  "index.search.slowlog.threshold.query.warn": "2s",
+  "index.search.slowlog.threshold.query.info": "500ms",
+  "index.search.slowlog.threshold.fetch.warn": "1s",
+  "index.indexing.slowlog.threshold.index.warn": "10s"
+}
+```
+
+### Profile API
+
+```bash
+GET /products/_search
+{
+  "profile": true,
+  "query": {
+    "match": { "title": "手机" }
+  }
+}
+```

package/skills/database/elasticsearch/references/08-elk-integration.md

@@ -0,0 +1,170 @@
+# ELK Stack 集成
+
+## Elastic Stack 架构
+
+```
+Kibana (可视化/仪表盘/Dev Tools)
+    ↓
+Elasticsearch (存储/搜索/聚合)
+    ↓
+Logstash (ETL)  ←  Filebeat (日志)  ←  Metricbeat (指标)  ←  其他 Beats
+```
+
+## Logstash 配置
+
+```ruby
+# logstash.conf — 接收文件日志, 解析后写入 ES
+input {
+  beats {
+    port => 5044
+  }
+  file {
+    path => "/var/log/app/*.log"
+    start_position => "beginning"
+  }
+}
+
+filter {
+  # 解析 Nginx 日志
+  grok {
+    match => { "message" => "%{COMBINEDAPACHELOG}" }
+  }
+  # 解析 JSON 格式
+  json {
+    source => "message"
+    target => "parsed"
+    skip_on_invalid_json => true
+  }
+  # 添加时间戳
+  date {
+    match => ["timestamp", "ISO8601"]
+    target => "@timestamp"
+  }
+  # 地理 IP 解析
+  geoip {
+    source => "client_ip"
+    target => "geo"
+  }
+  # 字段处理
+  mutate {
+    remove_field => ["message", "original"]
+    convert => ["response", "integer"]
+  }
+}
+
+output {
+  elasticsearch {
+    hosts => ["localhost:9200"]
+    index => "nginx-logs-%{+YYYY.MM.dd}"
+    user => "elastic"
+    password => "${ES_PASSWORD}"
+    ssl => true
+    cacert => "/etc/elasticsearch/certs/ca.crt"
+  }
+}
+```
+
+Logstash 是 ETL 工具，适合复杂数据转换（grok/geoip/useragent）。纯日志采集场景推荐 Filebeat（更轻量）。
+
+## Filebeat 配置
+
+```yaml
+# filebeat.yml — 轻量级日志采集
+filebeat.inputs:
+  - type: log
+    enabled: true
+    paths:
+      - /var/log/nginx/access.log
+      - /var/log/nginx/error.log
+    fields:
+      service: nginx
+      env: production
+    fields_under_root: true
+
+  - type: log
+    enabled: true
+    paths:
+      - /var/log/app/*.log
+    multiline:
+      pattern: '^\d{4}-\d{2}-\d{2}'
+      negate: true
+      match: after       # 合并多行异常堆栈
+
+filebeat.config.modules:
+  path: ${path.config}/modules.d/*.yml
+  reload.enabled: true
+
+output.elasticsearch:
+  hosts: ["localhost:9200"]
+  username: "elastic"
+  password: "${ES_PASSWORD}"
+  index: "filebeat-%{[agent.version]}-%{+yyyy.MM.dd}"
+
+setup.kibana:
+  host: "localhost:5601"
+```
+
+**Filebeat 特点**：轻量级、资源占用低、支持多行合并 (Java 异常堆栈)、模块化配置。
+
+## Metricbeat 配置
+
+```yaml
+# metricbeat.yml — 系统和应用指标采集
+metricbeat.config.modules:
+  path: ${path.config}/modules.d/*.yml
+  reload.enabled: true
+
+metricbeat.modules:
+  - module: system
+    metricsets:
+      - cpu
+      - memory
+      - network
+      - diskio
+      - filesystem
+      - process
+    period: 10s
+    enabled: true
+  - module: elasticsearch
+    metricsets:
+      - node
+      - node_stats
+      - cluster_stats
+      - index
+    period: 10s
+    hosts: ["localhost:9200"]
+```
+
+## Kibana 核心功能
+
+| 功能 | 说明 |
+|------|------|
+| **Discover** | 日志搜索浏览 (KQL / Lucene 查询) |
+| **Dashboard** | 仪表盘组合多个可视化 |
+| **Visualize** | 创建图表 (柱状图/折线图/饼图/地图) |
+| **Maps** | 地理空间分析 |
+| **Canvas** | 自定义报告设计 |
+| **Machine Learning** | 异常检测/预测 |
+| **APM** | 应用性能监控 |
+| **Security** | SIEM 安全分析 |
+
+## KQL 查询语法
+
+```
+service.name: "my-app" AND http.response.status_code >= 400
+agent.hostname: "web-*" AND NOT response_time > 5s
+```
+
+## 实战: 构建 Nginx 日志分析管道
+
+1. **Filebeat** 采集 `/var/log/nginx/access.log`
+2. **Logstash** (可选) 解析日志 → grok 提取字段 + geoip 解析 IP
+3. **Elasticsearch** 存储到 `nginx-logs-YYYY.MM.dd` 索引 (ILM 管理)
+4. **Kibana** 创建 Dashboard: 请求量趋势、状态码分布、TOP URL、地理分布
+
+**完整 pipeline 参考**：
+```bash
+# 使用 Filebeat Nginx 模块 (免手动配置)
+filebeat modules enable nginx
+filebeat setup
+```

package/skills/database/mysql/SKILL.md

@@ -0,0 +1,195 @@
+---
+name: mysql
+description: Provides comprehensive guidance for MySQL including SQL syntax, functions, indexing, optimization, replication, backup, and high availability. Use when the user asks about MySQL, needs to write MySQL queries, design database schemas, optimize performance, or manage MySQL databases.
+license: Complete terms in LICENSE.txt
+---
+
+# MySQL — 关系型数据库管理系统
+
+MySQL 是最流行的开源关系型数据库管理系统（RDBMS），以 InnoDB 存储引擎为核心，支持 ACID 事务、外键约束和多种复制架构。
+
+## Workflow — 使用流程
+
+```
+遇到 MySQL 需求时，按以下顺序决策:
+
+1. 明确场景
+├── 建库建表 / 设计 schema?    → DDL 与数据类型参考 (references/05)
+├── 复杂查询 / 报表分析?        → DML + 聚合/窗口函数 (references/03)
+├── 性能慢 / 优化 SQL?          → 索引与执行计划 (references/06)
+├── 备份 / 恢复?                → 备份与恢复 (references/08)
+├── 主从 / 高可用?              → 复制与高可用 (references/07)
+├── 存储过程 / 分区 / 事务?     → 高级特性 (references/09)
+├── 字符串/日期/JSON 函数?       → 函数参考 (references/01-04)
+└── 实战配置 / 搭建?             → 示例 (examples/)
+
+2. 引擎选择: InnoDB (99% 场景) → MyISAM (只读归档) → MEMORY (临时表)
+3. 索引设计: 主键先 → 查询/排序/JOIN 列建索引 → 检查最左前缀
+4. 生产措施: 开启慢查询 → 配置主从复制 → 制定备份策略
+```
+
+## When to Use / When NOT to
+
+| ✅ Use When | ❌ Skip When |
+|------------|-------------|
+| 需要 ACID 事务保障的业务系统（订单、支付、账户） | 高频 KV 存取（<1ms 延迟，用 Redis） |
+| 数据结构固定、关系明确的 OLTP 场景 | 文档型非结构化数据（用 MongoDB） |
+| 需要复杂 JOIN/子查询的报表分析 | 海量日志/时序数据（用 ClickHouse） |
+| 中小规模到中大规模 OLTP（百万~亿级） | 超大规模分布式事务（用 TiDB） |
+| 主从复制读写分离架构 | 图关系数据（用 Neo4j） |
+| 需要丰富内置函数和存储过程 | 全文搜索引擎为主（用 Elasticsearch） |
+
+## Boundary — 能力边界
+
+| ✅ 完全适用 | ⚠️ 有条件适用 | ❌ 不适用（替代方案） |
+|-----------|--------------|------------------|
+| OLTP 业务系统 | 单表过亿行（需分库分表） | 纯内存缓存 → Redis |
+| ACID 事务一致性 | 跨分片分布式事务（XA/Seata） | 文档存储 → MongoDB |
+| 复杂 SQL（JOIN/子查询/聚合） | 实时流计算（MySQL + Flink） | 全文搜索 → Elasticsearch |
+| 主从复制读写分离 | 强一致多主写入（Galera/PXC） | 时序大数据 → ClickHouse |
+| mysqldump/XtraBackup 备份 | JSON 深度查询（不如 MongoDB） | 分布式强一致 → TiDB |
+| 分区表（RANGE/LIST/HASH） | 高并发写入 > 1万 TPS | 图数据库 → Neo4j |
+
+## SQL 语法速查
+
+| 类别 | 核心语法 | 详情参考 |
+|------|---------|---------|
+| DDL | `CREATE/ALTER/DROP TABLE`，数据类型、约束 | references/05-sql-ddl-types.md |
+| DML | `INSERT/UPDATE/DELETE`，`ON DUPLICATE KEY UPDATE` | 同上 |
+| DQL | `SELECT/JOIN/GROUP BY/HAVING/UNION`，CTE，子查询 | references/03, 09 |
+| 事务 | `START TRANSACTION/COMMIT/ROLLBACK/SAVEPOINT` | references/09-advanced-features.md |
+| 分页 | `LIMIT/OFFSET`（小表），`WHERE id > :last` 游标（大表） | references/06-index-optimization.md |
+
+## 函数速查
+
+| 类别 | 最常用函数 | 详情参考 |
+|------|-----------|---------|
+| 字符串 | `CONCAT, SUBSTRING, REPLACE, LPAD, GROUP_CONCAT, LENGTH` | references/01-functions-string.md |
+| 日期时间 | `NOW, DATE_FORMAT, DATEDIFF, DATE_ADD, TIMESTAMPDIFF` | references/02-functions-date.md |
+| 聚合 | `COUNT, SUM, AVG, MAX, MIN, GROUP_CONCAT` | references/03-functions-aggregate-window.md |
+| 窗口 (8.0+) | `ROW_NUMBER, RANK, DENSE_RANK, LAG, LEAD, NTILE` | references/03-functions-aggregate-window.md |
+| JSON (5.7+) | `JSON_EXTRACT, JSON_SET, JSON_CONTAINS, JSON_TABLE` | references/04-functions-json.md |
+| 条件 | `IF, IFNULL, COALESCE, CASE WHEN` | references/05-sql-ddl-types.md |
+
+## 高级特性索引
+
+| 特性 | 简介 | 参考 |
+|------|------|------|
+| 视图 (View) | 存储的查询定义，简化复杂查询和权限控制 | references/09-advanced-features.md |
+| CTE (8.0+) | 命名临时结果集，支持递归树形查询 | 同上 |
+| 存储过程 | 封装多条 SQL 带事务控制的业务逻辑 | 同上 |
+| 触发器 | 自动响应 INSERT/UPDATE/DELETE 的事件处理 | 同上 |
+| 事务与锁 | ACID、MVCC、四种隔离级别、行锁/表锁/死锁 | 同上 |
+| 分区表 | RANGE/LIST/HASH/KEY 分区，数据归档加速 | 同上 |
+| 全文索引 (5.6+) | FULLTEXT + MATCH AGAINST 代替 LIKE 搜索 | references/06-index-optimization.md |
+| 函数索引 (8.0.13+) | 对表达式/函数结果建索引 | 同上 |
+| 降序索引 (8.0+) | 混合排序方向的索引优化 | 同上 |
+| 主从复制 | Binlog + Relay Log 实现数据同步 | references/07-replication-ha.md |
+| 半同步复制 | 至少一个 Slave 确认，平衡性能与一致性 | 同上 |
+| InnoDB Cluster | Group Replication + MySQL Router 原生 HA | 同上 |
+| XtraBackup | 物理热备份，支持增量 | references/08-backup-restore.md |
+| PITR | 利用 Binlog 实现时间点恢复 | 同上 |
+
+## 引擎对比
+
+| 特性 | InnoDB | MyISAM | MEMORY |
+|------|--------|--------|--------|
+| 事务 | ✅ ACID | ❌ | ❌ |
+| 外键 | ✅ | ❌ | ❌ |
+| 行级锁 | ✅ 行锁 | ❌ 表锁 | ❌ 表锁 |
+| MVCC | ✅ | ❌ | ❌ |
+| 崩溃恢复 | ✅ redo log | ❌ 需 REPAIR TABLE | ❌ 重启即丢 |
+| 全文索引 | ✅ 5.6+ | ✅ | ❌ |
+| 缓存 | Buffer Pool（数据和索引） | Key Cache（仅索引） | 全内存 |
+| 适用场景 | 99% 场景默认首选 | 只读归档（极少用） | 临时表 |
+| 表大小限制 | 64TB | 256TB | max_heap_table_size |
+
+## Gotchas — 常见陷阱
+
+| # | 反模式 | 问题 | 正确做法 |
+|---|--------|------|---------|
+| 1 | 金额用 FLOAT/DOUBLE | 浮点精度误差 | 用 `DECIMAL(10,2)` |
+| 2 | WHERE 列用函数/隐式转换 | 索引失效，全表扫描 | 避免函数操作列，类型匹配 |
+| 3 | 大批量分页用 OFFSET | OFFSET 越深越慢 | 游标分页 `WHERE id > :last` |
+| 4 | 全表无主键 | 无法行级锁，复制延迟 | 每个表必须有 BIGINT 主键 |
+| 5 | SELECT * 生产使用 | 浪费带宽，无法覆盖索引 | 显式列出需要列 |
+| 6 | 大字段无前缀索引 | 索引过大，B+ 树效率低 | 前缀索引 `col(N)` |
+| 7 | 长事务不提交 | undo log 膨胀，MVCC 开销 | 控制事务大小，及时 COMMIT |
+| 8 | 索引过多 | 写入性能降低 | 单表索引 ≤ 5-8 个 |
+| 9 | COUNT(*) InnoDB 大表 | 需要扫描全表（MyISAM 才缓存） | 用近似值或计数表 |
+| 10 | LIKE '%keyword%' 搜索 | 无法用索引 | FULLTEXT + MATCH AGAINST |
+| 11 | NOT IN (子查询) | 不做半连接优化 | 用 NOT EXISTS |
+| 12 | 字符集混用 | 乱码、索引隐性转换 | 统一 utf8mb4 |
+| 13 | TEXT/BLOB 过多 | 行溢出，性能差 | 拆分到子表或 OSS |
+| 14 | REPLACE 常见误解 | 实际是 DELETE+INSERT | 明确需求后用 ON DUPLICATE KEY UPDATE |
+| 15 | 不做备份验证 | 备份损坏但无人知 | 每月定期恢复演练 |
+
+## FAQ
+
+| # | 问题 | 答案 |
+|---|------|------|
+| 1 | 如何选择 DATETIME 还是 TIMESTAMP？ | TIMESTAMP 自动时区转换（范围 1970-2038），DATETIME 无时区影响（范围 1000-9999） |
+| 2 | VARCHAR 最大长度设多少合适？ | 根据业务设合理值（50-200），不要无意义设 255（临时表排序按定义长度分配内存） |
+| 3 | 如何快速插入百万级数据？ | `LOAD DATA INFILE` (最快)，或批量 INSERT（每批 500-1000 行），关闭 AUTOCOMMIT |
+| 4 | 什么时候需要分库分表？ | 单表 > 5000 万行或单实例 > 2TB 且预期继续增长 |
+| 5 | MySQL 8.0 vs 5.7 选哪个？ | 新项目选 8.0（窗口函数、CTE、降序索引、原子 DDL、Hash Join） |
+| 6 | 如何监控 MySQL 性能？ | 慢查询日志 + pt-query-digest + Prometheus + Grafana + performance_schema |
+| 7 | 主从延迟怎么处理？ | 检查 Slave 硬件、拆分大事务、开启并行复制、关键读走主库 |
+| 8 | 误操作删除了数据怎么办？ | 立即停止写入 → 用 Binlog PITR 恢复到误操作前的时间点 |
+| 9 | InnoDB 为什么比 MyISAM 好？ | 事务、行锁、崩溃恢复、MVCC、外键。MyISAM 已过时 |
+| 10 | 如何查看当前数据库的活跃连接？ | `SHOW PROCESSLIST;` 或 `SELECT * FROM sys.session;` |
+| 11 | 如何安全地在大表上添加索引？ | MySQL 8.0 用 `ALGORITHM=INPLACE, LOCK=NONE`；或用 pt-online-schema-change |
+| 12 | 唯一索引和普通索引怎么选？ | 需要唯一约束用 UNIQUE；只需加速查询用普通索引 |
+| 13 | 有哪些推荐的管理工具？ | CLI: mysql CLI；GUI: Sequel Ace / DataGrip / Navicat；命令行: Percona Toolkit |
+| 14 | utf8mb4 和 utf8 有什么区别？ | utf8 是 utf8mb3（最多 3 字节），不支持 emoji；utf8mb4 支持完整的 Unicode（含 emoji）|
+| 15 | 如何排查死锁？ | `SHOW ENGINE INNODB STATUS;` 查看 LATEST DETECTED DEADLOCK 部分 |
+
+## Keywords
+
+MySQL, Database, RDBMS, SQL, DDL, DML, DQL, DCL, InnoDB, MyISAM, MEMORY, ACID, transaction, index, B-Tree, EXPLAIN, query optimization, replication, master-slave, binlog, backup, restore, XtraBackup, mysqldump, PITR, partition, view, stored procedure, trigger, CTE, window function, JSON, utf8mb4, performance_schema, slow query, connection pool, sharding, high availability, HA
+
+## References
+
+### 官方文档
+- [MySQL 8.0 Reference Manual](https://dev.mysql.com/doc/refman/8.0/en/)
+- [MySQL 8.0 Release Notes](https://dev.mysql.com/doc/relnotes/mysql/8.0/en/)
+
+### 工具
+- [Percona XtraBackup](https://www.percona.com/software/mysql-database/percona-xtrabackup)
+- [Percona Toolkit](https://www.percona.com/software/database-tools/percona-toolkit)
+- [Orchestrator](https://github.com/openark/orchestrator) — MySQL 高可用管理
+- [gh-ost](https://github.com/github/gh-ost) — 在线表结构变更
+
+### 本 skill 深度参考
+- references/01-functions-string.md — 字符串函数大全
+- references/02-functions-date.md — 日期时间函数大全
+- references/03-functions-aggregate-window.md — 聚合与窗口函数
+- references/04-functions-json.md — JSON 函数
+- references/05-sql-ddl-types.md — DDL 与数据类型详解
+- references/06-index-optimization.md — 索引与执行计划
+- references/07-replication-ha.md — 主从复制与高可用
+- references/08-backup-restore.md — 备份与恢复
+- references/09-advanced-features.md — 高级特性（视图/CTE/存储过程/触发器/事务/分区）
+
+### 实战示例
+- examples/01-connection-pool.md — 连接池配置
+- examples/02-slow-query-optimization.md — 慢查询优化
+- examples/03-master-slave-setup.md — 主从复制搭建
+- examples/04-backup-strategy.md — 备份策略方案
+
+## 使用流程
+
+### Step 1: 环境准备
+确保开发环境已安装必要的依赖和工具。
+
+### Step 2: 配置初始化
+根据项目需求进行基础配置。
+
+### Step 3: 核心功能使用
+按照示例代码实现核心功能。
+
+### Step 4: 测试验证
+运行测试确保功能正常。
+
+### Step 5: 部署上线
+完成开发后进行部署和监控。

package/skills/database/mysql/examples/01-connection-pool.md

@@ -0,0 +1,75 @@
+# 示例: 连接池配置 (Java HikariCP)
+
+## 场景
+
+生产环境高并发 Web 应用中，合理配置数据库连接池是保证性能的关键。本例展示 HikariCP（Spring Boot 默认连接池）的最佳实践配置。
+
+## 问题
+
+- 连接数太少 → 请求排队等待，响应变慢
+- 连接数太多 → MySQL 连接数耗尽（`max_connections`），系统崩溃
+- 连接泄漏 → 连接未正确归还，池逐渐耗尽
+
+## 解决方案
+
+### application.yml 配置
+
+```yaml
+spring:
+  datasource:
+    url: jdbc:mysql://localhost:3306/shop?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8mb4
+    username: root
+    password: your_password
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    hikari:
+      # 核心配置
+      maximum-pool-size: 20           # 最大连接数（核心参数）
+      minimum-idle: 5                 # 最小空闲连接数
+      connection-timeout: 30000       # 等待连接超时（毫秒）
+      idle-timeout: 600000            # 空闲连接最大存活（毫秒，10min）
+      max-lifetime: 1800000           # 连接最大寿命（毫秒，30min）
+      
+      # MySQL 专用优化
+      auto-commit: true
+      connection-test-query: SELECT 1
+      pool-name: ShopHikariPool
+      
+      # 性能监控
+      register-mbeans: true           # 开启 JMX 监控
+```
+
+### 常用计算公式
+
+```
+最大连接数 = ((核心数 * 2) + 有效磁盘数)
+
+示例:
+- 4 核 CPU + 1 SSD → (4 * 2) + 1 = 9
+- 8 核 CPU + 1 SSD → (8 * 2) + 1 = 17
+
+通用建议:
+- 微服务低并发场景: 5-10
+- Web 应用中并发场景: 15-30
+- 高并发场景: 分库后每个库 20-50
+
+注意: 不是越大越好。连接池大小 × 并发请求数 = MySQL 实际并发连接。
+举例: 10 个实例 × 每个 20 连接 = 200 个 MySQL 连接。
+```
+
+### 验证配置
+
+```sql
+-- 查看实际连接数
+SHOW STATUS LIKE 'Threads_connected';
+SHOW STATUS LIKE 'Max_used_connections';
+
+-- 查看连接来源
+SELECT * FROM information_schema.processlist;
+```
+
+## 关键要点
+
+1. **连接池大小不是越大越好**：过多的连接会导致 MySQL 上下文切换开销和锁争用
+2. **max-lifetime 应小于 MySQL 的 wait_timeout**（通常 28800s），避免连接被 MySQL 断开后还留在池中
+3. **connection-test-query** 用于心跳检测，`SELECT 1` 性能最好
+4. 建议配合 `spring.datasource.hikari.leak-detection-threshold` 检测连接泄漏