1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | sql-optimization-patterns（合集子技能，完整标识 sql-optimization-patterns-wshobson-agents） | GitHub |
| 作者/维护者 | Seth Hobson（wshobson/agents 仓库维护者，个人开发者） | GitHub API |
| 来源链接 | https://github.com/wshobson/agents/tree/main/plugins/developer-essentials/skills/sql-optimization-patterns | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars/Forks | 合集仓库整体 38,649 / 4,122（不代表本技能自身热度） | GitHub API |
| 最新版本 | 所属 developer-essentials 插件 v1.0.4 | 仓库 plugin.json |
| 安装方式 | 见第 10 章 | — |
2. 功能介绍与亮点
SQL Optimization Patterns 是一份聚焦 SQL 查询性能调优的实操指南：
- EXPLAIN 执行计划解读：给出 PostgreSQL
EXPLAIN/EXPLAIN ANALYZE/EXPLAIN (ANALYZE, BUFFERS, VERBOSE)的用法，并逐一说明 Seq Scan、Index Scan、Nested Loop、Hash Join 等关键指标的含义与优劣判断。 - 索引策略全谱：B-Tree、Hash、GIN、GiST、BRIN 五种索引类型的适用场景，以及复合索引、部分索引、表达式索引、覆盖索引、全文检索索引、JSONB 索引的具体建表语句。
- 常见反模式对照：
SELECT *、WHERE子句中误用函数、笛卡尔积式 JOIN 等典型慢查询写法与对应的正确写法逐条给出正误代码。 - 维护与监控清单：
ANALYZE/VACUUM/REINDEX等日常维护命令，以及用pg_stat_statements定位慢查询、用pg_stat_user_tables/pg_stat_user_indexes找缺失索引与冗余索引的查询语句。 - 正文（约 5.8KB）为导航层，
references/details.md（约 6.7KB）承载更深内容：消除 N+1 查询、游标分页、高效聚合、子查询改写、批量操作、物化视图与表分区等进阶模式的正误代码对照。
3. 适用场景
所属分类：工程效率与代码质量。
适合排查慢查询的后端与全栈工程师、设计数据库 schema 时需要提前规划索引的开发者、以及希望降低数据库负载与云成本的技术团队。内容围绕“诊断并修复查询性能问题”这一具体工程动作展开，而非数据分析或可视化。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 仓库为 Claude Code 插件市场源码（.claude-plugin/plugin.json），SKILL.md 为标准 Agent Skills 格式 |
| Codex | ✅ 支持 | README 提供 npx codex-marketplace add 原生安装路径，仓库同时维护 Codex 专属清单 |
| OpenClaw | 未验证 | 已抓取材料（README、提交记录）提及 Cursor/OpenCode/Gemini/Copilot 多运行时适配，未提及 OpenClaw |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes Agent 支持 |
5. 推荐理由
慢查询往往靠猜索引、试错式加字段解决。这份技能把“怎么读 EXPLAIN 执行计划、什么场景选哪种索引、常见反模式怎么改”整理成可直接对照的正误代码，装上即可用，无需额外配置或密钥。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 4 | 第三方安装工具 Skills.sh 显示该技能单独安装量约 1.67 万次，在 wshobson/agents 全部 180 个子技能中排名第 23 位；已被 Skills.sh、Smithery（agentskills.so）、MCP.Directory、FastMCP.me 等至少 4 家独立技能市场收录分发，但暂未发现具名用户评分或评价 |
| 可用性 | 9 | 导航层+详情层结构完整，含大量可直接运行的 SQL/Python 代码示例；无付费依赖，一条命令即可安装；对应文件最近一次实质修订为 2026-05-22 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单：① shell 命令/权限：正文含 SQL/VACUUM/REINDEX 等命令示例，均为供用户参考的说明性代码块，非技能自动执行 ② 联网外发：无 ③ API key/凭据：不需要 ④ 可疑指令：未发现 ⑤ 作者信誉：个人开发者，仓库内容公开可审计、持续维护，未见刷星或造假迹象 ⑥ License：MIT，明确 ⑦ 维护时间：仓库整体活跃（最近推送 2026-08-05），本文件自身修订于 2026-05-22
综合评分 = (4+9+9)/3 ≈ 7.33
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| sql-query-optimizer（jeremylongshore/claude-code-plugins-plus-skills） | 检查查询结构与 EXPLAIN 输出，识别全表扫描、缺失索引、低效 JOIN 并给出修复建议 | 功能定位相近，但托管在一个跨数百个技能、覆盖数十个领域的巨型综合市场仓库中，单个技能获得的独立关注度更分散；本技能所在仓库聚焦开发者核心技能这一垂直方向 |
| database-designer（alirezarezvani/claude-skills） | 覆盖 schema 设计、范式分析、SQL/NoSQL 选型、数据迁移的全生命周期数据库工具 | 定位是数据库架构设计的综合顾问，查询优化只是其中一小部分；本技能专注在查询性能这一单点，EXPLAIN 解读与索引类型覆盖更深入 |
8. 用户评价
GitHub 用户 yairEO 曾在 2026 年 1 月报告本技能引用的部分参考文件缺失（postgres-optimization-guide.md、mysql-optimization-guide.md 等），该问题已随后续一次仓库级参考文件清理修订解决，当前内容已统一整合进 references/details.md。除此之外，该技能目前在第三方平台尚无具名用户评分或评价。
9. 其他补充
所属仓库同一份内容会转译为 Claude Code、Codex CLI、Cursor、OpenCode、Gemini CLI、GitHub Copilot 六种运行时格式。本技能归属 developer-essentials 插件，与 Git 高级工作流、错误处理模式、代码评审等其余 10 个开发技能同插件打包。
10. 安装使用方式
- Claude Code（官方插件市场，按插件粒度安装）：
该命令会同时装入 developer-essentials 插件下其余 10 个开发技能；本技能会在涉及慢查询排查、数据库 schema 设计、索引规划等任务时按描述自动触发。/plugin marketplace add wshobson/agents /plugin install developer-essentials - Codex CLI（原生市场安装）：
npx codex-marketplace add wshobson/agents - 仅安装本技能（社区工具 Skills.sh，不含整个插件包）：
npx skills add https://github.com/wshobson/agents --skill sql-optimization-patterns - 安装后无需重启 agent，SKILL.md 内容会在任务描述匹配时自动加载，无需手动调用。
11. 注意事项
- 官方渠道按插件粒度安装，会连带装入其余 10 个开发技能；只想要本技能可改用 Skills.sh 单独安装。
- 作者为个人开发者；正文示例以 PostgreSQL 语法为主，其他数据库引擎（MySQL、SQL Server 等）需自行迁移语法思路。
- 更深入的 N+1 消除、分页、分区等进阶模式在
references/details.md，需 agent 按需加载才能读到。