1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | sql-optimization（github/awesome-copilot 仓库 skills/ 目录下的独立子技能） |
SKILL.md |
| 作者/维护者 | GitHub 官方账号（合集仓库），2026-02-19 由 copilot-swe-agent 批量迁移合并（原为 prompts/sql-optimization.prompt.md，转格式为 SKILL.md） |
GitHub API（commits） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/sql-optimization | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 39,050 / 4,952（整个 awesome-copilot 合集仓库层面，非本子技能单独统计，见第 7 章说明） | GitHub API |
| 最新版本 | 无独立版本号，随仓库滚动更新 | GitHub API（commits） |
| 安装方式 | 复制 skills/sql-optimization/（单文件 SKILL.md）到 Agent 的 skills 目录，或用第三方安装器命令（见第 10 章） |
— |
2. 功能介绍与亮点
sql-optimization 是一份跨数据库通用的 SQL 性能优化助手，覆盖 MySQL、PostgreSQL、SQL Server、Oracle 等主流关系型数据库，帮助识别并修复常见的查询性能问题。
核心内容按七个板块展开：查询性能分析（相关子查询改窗口函数等）、索引策略设计（复合索引、覆盖索引、部分索引）、JOIN 优化、游标分页替代 OFFSET 分页、条件聚合替代多次查询、SELECT * 与 WHERE 子句中函数调用等反模式识别、以及各数据库自带的慢查询诊断语句（MySQL slow_log、PostgreSQL pg_stat_statements、SQL Server dm_exec_query_stats）。每个板块都是“❌ 反例 / ✅ 正例“的可运行 SQL 代码对照，末尾附一张覆盖查询结构、索引策略、数据类型、查询模式、性能测试五个维度的检查清单，以及一套”识别→分析→优化→测试→监控→迭代“的六步方法论。
主要亮点：
- 内容纯粹是数据库通用知识，不绑定任何厂商专属语法，四大主流数据库通吃
- 每条建议都配可直接对照运行的 SQL 代码，而非空泛的文字建议
- 末尾检查清单可当作代码评审时的速查表单独使用
3. 适用场景
固定分类：数据分析与可视化。
适合日常需要编写或评审 SQL 查询、担心线上慢查询拖垮性能的开发者与数据库使用者；对刚开始接触索引设计、执行计划分析、分页优化这些概念的初中级开发者尤其实用——它把常被当作“玄学”的 SQL 调优拆成了可对照检查的具体条目。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md 格式，description 已声明触发场景 |
| Codex | 原生支持 | 内容为纯 Markdown 指令与 SQL 代码示例，无 Claude 专属语法、无外部脚本依赖，复制文件即可读取执行 |
| OpenClaw | 原生支持 | 同上，无平台专属依赖 |
| Hermes Agent | 未验证 | 已抓取材料中未发现相关证据 |
5. 推荐理由
SQL 性能问题几乎是每个用到数据库的项目迟早会遇到的坎，但很多开发者对“该加什么索引”“为什么这条查询慢”缺乏系统判断依据。sql-optimization 把索引设计、分页策略、JOIN 优化、反模式识别等常见问题都拆成“改前/改后”的可运行代码对照，且刻意不绑定单一数据库厂商语法，覆盖面广、可直接套用到手头的查询上，零依赖、复制即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方为 GitHub 官方账号；合集仓库整体 stars 属整个仓库，不代表本技能自身热度；检索未发现针对本子技能的独立第三方讨论，多个第三方 Skills 聚合目录站点仅做镜像列出，非独立评价来源 |
| 可用性 | 8 | 单文件复制即用，内容详实（9.3KB，七大板块+可运行代码对照+检查清单+方法论），无付费依赖、无需 API key；所属仓库持续活跃维护，本子技能内容本身趋于稳定 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单： ① Shell 命令与权限：纯文档指令，不执行任何 shell 命令 ② 联网外发：无任何网络请求 ③ API key/凭据：不要求任何凭据 ④ 可疑指令：逐份核查 SKILL.md 全文，未发现夹带指令、混淆代码或隐蔽外发 ⑤ 作者信誉：由 GitHub 官方合集仓库的公开 PR 审核流程合并，无造假迹象 ⑥ License：MIT，明确 ⑦ 维护时间：所属仓库持续活跃维护（近一日内有提交），本子技能自 2026-02 由 prompt 格式迁移为 SKILL.md 后内容保持稳定
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 sql-optimization 的差异 |
|---|---|---|
| sql-code-review（github/awesome-copilot 同仓库） | SQL 代码风格与规范评审 | 侧重命名规范、注释、SQL 注入等代码质量与安全层面的评审，不涉及索引设计或执行计划分析；sql-optimization 专注性能调优本身，两者可配合使用但关注点不同 |
| postgresql-optimization（github/awesome-copilot 同仓库） | PostgreSQL 专属性能调优 | 深入 PostgreSQL 专属机制（如 VACUUM、特定扩展），仅适用单一数据库；sql-optimization 是跨数据库通用方法论，覆盖面更广但不深入任何单一数据库的专属特性 |
| bigquery-basics（google/skills） | BigQuery 查询语法入门 | 面向 BigQuery 这一云数仓产品的基础用法教学，非性能调优；两者服务场景不重叠 |
sql-optimization 的差异化在于“数据库无关”——不要求使用者绑定某一特定数据库厂商，覆盖 MySQL/PostgreSQL/SQL Server/Oracle 的通用调优原则，适合技术栈尚未固定、或同时维护多种数据库的团队。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，仅随所属合集仓库被若干 Claude/Copilot Skills 聚合目录站点收录列出。
9. 其他补充
无。
10. 安装使用方式
- Claude Code / 兼容 Agent：将
github/awesome-copilot仓库中skills/sql-optimization/SKILL.md复制到本地项目或全局的 skills 目录下即可自动被识别 - 第三方安装器：
npx -y skills add github/awesome-copilot --skill sql-optimization --agent claude-code - 触发方式：在对话中说“帮我优化这条 SQL”“这个查询为什么慢”“review my database indexes”等
- 安装后无需重启；技能会先定位查询中的性能问题类型，再给出对应的改前/改后代码对照与索引建议
11. 注意事项
- 内容为通用 SQL 优化知识与代码示例，不含可执行脚本，具体索引创建与执行计划分析仍需在实际数据库环境中验证效果
- 部分语法示例（如覆盖索引的 INCLUDE 子句）为特定数据库专属写法，已在文中标注适用范围，跨数据库迁移时需自行核对语法差异
- 跨 Agent 平台的兼容性尚未在 Hermes Agent 上验证，实际使用前建议先做小范围测试