前言¶

线上接口偶发超时、报表任务拖垮从库，常见原因之一是 SQL 写法或索引与执行计划不匹配。排查时往往要在慢查询日志、EXPLAIN 输出和表结构之间来回对照，再手工推演该不该加联合索引、能否改写子查询。下面介绍 SkillHub 上的社区 Skill「SQL优化器」，它把「分析慢查询、给索引建议、改写低效 SQL、解读执行计划指标」收敛成一套可复用的 Agent 能力，并以结构化 Markdown 表格输出结果。

这是什么¶

「SQL优化器」是 SkillHub 社区来源（community）的 Agent Skill，坐标为 @user_c1ff727a/sql-pro-v2，当前版本 1.0.0，分类 dev-programming，由发布者 user_c1ff727a 维护。官方简介将其定位为面向专业场景的 SQL 查询优化助手（Professional SQL query optimization assistant）：针对慢查询做分析，推荐索引策略，改写低效 SQL，并解释执行计划（execution plan）中的各项指标；输出采用结构化 Markdown 表格。标签标明 requires_api_key=false，使用该 Skill 本身不依赖额外 API Key。

SkillHub 页面：https://www.skillhub.cn/skills/user_c1ff727a/sql-pro-v2
API 条目：https://api.skillhub.cn/user_c1ff727a/sql-pro-v2

核心功能¶

以下能力均来自官方简介，未在资料中出现的细节不作延伸。

1. 慢查询分析：围绕你提供的 SQL 与上下文，梳理可能导致性能问题的写法与访问路径。
2. 索引策略建议：在表结构与查询模式基础上，给出索引方向上的建议（具体语句与权衡由模型结合 Skill 指引生成）。
3. 低效 SQL 改写：对明显不经济的写法提出改写思路或等价 SQL。
4. 执行计划指标说明：对 execution plan 中的指标项做解释，便于对照 EXPLAIN 类输出阅读。
5. 结构化 Markdown 表格：结论与对比信息以表格形式呈现，便于粘贴进文档或工单。

安装与启用¶

Skill 基于通用 SKILL.md 格式。在 SkillHub 上安装时，需要让 Agent 按官方安装说明操作，并把技能装到当前客户端能识别的 skills 目录；若未指定 --dir，默认会落到 ./skills/，可能不会被 Cursor 等环境加载。

方式一：让 AI 按 SkillHub 文档安装¶

将下面提示词发给已支持 Skills 的 AI（与 SkillHub 页面一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c1ff727a/sql-pro-v2`。

方式二：本机使用 SkillHub CLI¶

先做环境检查，再安装到对应目录。以 Cursor 为例，skills 目录一般为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 常见为 ~/.codex/skills/ 或项目下的 .agents/skills/。其他客户端路径以 https://skillhub.cn/install/skillhub.md 第四节为准。

检查 CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装（文档推荐）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill（请将 --dir 换成你当前 Agent 的 skills 目录）：

skillhub install @user_c1ff727a/sql-pro-v2 --dir ~/.cursor/skills/

安装后按你所用客户端的要求刷新或重启，使新 Skill 被加载。公开页面上该 Skill 的「安装」计数为 0，仅表示 SkillHub 统计口径下的安装次数，不代表你本机是否已配置成功，以本地目录与 Agent 是否识别为准。

典型用法¶

官方资料未附带固定示例 SQL 或截图工单，用法应围绕 Skill 声明的输入类型组织对话，便于 Agent 按 SKILL.md 流程作答。

1. 启用 Skill 后，在对话中说明数据库类型与版本（若已知）、相关表结构或 CREATE TABLE 片段。
2. 粘贴待优化的 SQL，如有慢查询日志中的耗时、扫描行数等，一并附上。
3. 提供执行计划：例如 MySQL 的 EXPLAIN / EXPLAIN ANALYZE、PostgreSQL 的 EXPLAIN (ANALYZE, BUFFERS) 等原始文本，便于对照「执行计划指标说明」能力。
4. 明确诉求：只要索引建议、只要改写、或需要表格化对比「改写前 / 改写后 / 预期影响」等；Skill 侧承诺以结构化 Markdown 表格输出，适合直接放进评审记录。

经过上面的步骤，你得到的是基于当前上下文由模型生成的分析与建议，上线前仍应在测试环境验证执行计划与数据正确性。

适用场景与注意¶

适合谁：日常写 SQL、做性能排障的后端与数据相关开发者；希望在 IDE 里用统一 Skill 拉齐「分析—索引—改写—解读计划」话术，而不是每次从零写 prompt。

社区 Skill：来源为 community，行为以仓库内 SKILL.md 与模型能力为界；复杂生产问题（分库分表、特定厂商优化器细节）仍需结合 DBA 与真实压测。

无 API Key 要求：requires_api_key=false 指 Skill 元数据未要求绑定第三方 Key；实际推理仍取决于你所用 Agent 的模型与配额。

平台数据（SkillHub 抓取，2026-10-22）：评分 100000，下载 749 次。与第三方转载的评分、下载数可能不一致，以 SkillHub 页面为准。

结尾¶

「SQL优化器」把慢查询分析、索引建议、SQL 改写与执行计划解读收成一块可安装的 Agent 能力，并用 Markdown 表格整理输出，适合作为 SQL 排障时的固定协作模板。安装与坐标以 SkillHub 为准：

• 页面：https://www.skillhub.cn/skills/user_c1ff727a/sql-pro-v2
• 坐标：@user_c1ff727a/sql-pro-v2
• API：https://api.skillhub.cn/user_c1ff727a/sql-pro-v2