Dane i analityka · Przegląd i audyt
sql-review
/sql-review
Przegląda wydajność nowych lub zmienionych zapytań SQL, indeksów, stronicowania i zapisów wsadowych, z planem wykonania.
Dla kogo
- Autor
- fengyale ↗
- Repozytorium
- harness-bootstrap ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
91/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 13
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
Licencja
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co sprawdzić przed instalacją
- SKILL.md zawiera komentarze HTML (13). Nie widać ich w podglądzie Markdown, a model je czyta.
Co robi i kiedy
Przegląda wydajność nowych lub zmienionych zapytań SQL, indeksów, stronicowania i zapisów wsadowych, z planem wykonania.
Oryginalny opis (EN)
SQL 性能评审:新增或修改 SQL、加索引、改分页、改批量写入时使用;提交前必须给出执行计划与数据量评估。
Jak działa
- 何时用
- 项目绑定(编译时替换)
- 模式(跨技术栈不变)
- 证据锚点(编译后填写)
Sekcje z nagłówków SKILL.md, w oryginale · 105 linii, 452 słów
Podgląd SKILL.md
---
name: sql-review
description: SQL 性能评审:新增或修改 SQL、加索引、改分页、改批量写入时使用;提交前必须给出执行计划与数据量评估。
---
# SQL 评审(事前)
> **本文件是骨架**:`slot:` 注释必须在安装时用项目事实替换,替换不到就整条删除。
> `harness:package` 区块是包内通用内容(升级整体替换),`harness:project` 区块是项目内容(升级永不触碰)。
## 何时用
- 新增 / 修改查询、关联、子查询、排序
- 改分页、改批量写入、循环里调数据库
- 给表加字段、加索引、改唯一约束
- 接口新增按时间 / 状态 / 组织等维度过滤
> 改代码时用本技能;线上已经变慢的排查用 `trouble-shooting/01-slow-sql`。
<!-- harness:project:begin bindings -->
## 项目绑定(编译时替换)
- 数据源与方言(Oracle / MySQL / MSSQL / PG):<!-- slot:db.datasources -->
- SQL 写在哪里(ORM / 手写 / 视图 / XML):<!-- slot:db.sql.location -->
- 表行数与索引的查询方式(客户端 / MCP / 平台):<!-- slot:db.catalog -->
- 只读执行 / EXPLAIN 的 MCP 或客户端:<!-- slot:db.mcp -->
- 只读沙箱或测试库(可跑 fixture):<!-- slot:db.sandbox -->
- 事务与批量写入的约定:<!-- slot:db.batch -->
<!-- harness:project:end -->
<!-- harness:package:begin mode -->
## 模式(跨技术栈不变)
### 步骤
1. **定位 SQL 与数据源**:哪个 module、哪次连接、命中哪张表
2. **估数据量**:查 count 或表统计;大表(> 10 万行)必须确认有可用索引
3. **看执行计划**:`EXPLAIN` / `explain plan` / `showplan`
4. **核对索引**:where / join / order by 列是否有索引;注意隐式转换与函数包列
5. **改写法**:前导通配改前缀、`not in` 改 `not exists`、深分页改游标、批量改分批
6. **写结论**:`summary.md` 加 `sql_review:` 一行(正确性四层 + 表、预估行数、访问路径)
### 正确性校验(先证明对,再评估快)
> 性能评审之前先回答:这条 SQL 会不会错。**没有正确性结论,不允许写"通过"。**
| 层 | 问题 | 判据 | 手段(见「项目绑定」) |
| --- | --- | --- | --- |
| 1 语法 / 方言 | 目标数据库能不能解析 | parse 或 `EXPLAIN` / `PREPARE` 不报语法错;方言一致 | `db.mcp` 的只读执行方式 |
| 2 结构 | 表、列、类型、约束是否存在 | 对照 `.harness/wiki/数据模型.md` 或查询 catalog | `db.catalog` 的查询方式 |
| 3 绑定 | 参数是否安全、数量与类型是否匹配 | 只用 `#{}`,无 `${}`;动态列走白名单;NULL / IN / 排序已处理 | 代码检索 |
| 4 结果 | 语义是否符合预期 | 只读沙箱用代表性参数或 fixture 跑一次,断言列、行数与关键值;写操作事务回滚或 dry-run | `db.sandbox` 的只读沙箱 |
**步骤:**
1. **还原可执行 SQL**:按本次真实分支渲染动态 SQL,记录参数集;还原不了就列出分支与参数,不能跳过。
2. **先解析**:用只读账号跑 `EXPLAIN` 或 `PREPARE`;语法错、对象不存在会在这里暴露。
3. **核对结构**:表名、列名、类型、唯一键;以项目 wiki / 迁移脚本为准,不拿测试库结构当生产。
4. **核对绑定**:参数个数、类型、空值、`IN` 列表、`ORDER BY` 白名单;禁止 `${}` 拼接。
5. **跑结果(只读)**:用 fixture 或代表性参数执行,断言返回列、行数与关键值;写操作在事务里执行后回滚,或只做 dry-run。
6. **跑计划**:`EXPLAIN` 看 `type` / `key` / `rows` / `Extra`;大表、深分页、批量写单独评估。
7. **写结论**:`sql_review:` 必须含四层结论;**无法验证的层写“未验证 + 原因”,不能写“通过”**。
**停止条件:**
- 没有只读库 / 没有 fixture / 生产数据不可用 → 只能写“未验证 + 原因”;DDL、大表、批量写等高风险 SQL 必须人工确认后才能合并
- 动态 SQL 无法还原 → 至少覆盖本次实际路径,并列出未覆盖分支
- 结果与预期不一致 → 不进阶段 5,先改 SQL 或改预期
**结论模板:**
```text
sql_review: <表名> · 语法 <OK/失败> · 结构 <OK/缺 X> · 绑定 <#{} / 无 ${}> · 结果 <已验(fixture/参数) / 未验证(原因)> · 计划 <type=ref key=idx_x rows≈N / 未跑> · 结论 <通过 / 已改写 / 待 DBA>
```
**证据:** 优先落盘到 `.harness/changes/<特性>/sql-review/`(EXPLAIN 输出、结果摘要、fixture 路径),在 `sql_review:` 里引用路径。
### 检查项
- [ ] SQL 只用一种数据源方言
- [ ] where 列无函数、无隐式类型转换
- [ ] 没有 `select *`
- [ ] 没有前导通配 `like '%x'`
- [ ] `not in` 已改 `not exists`,或确认子查询无空值
- [ ] 分页不是大 offset(> 1 万行考虑游标 / 延迟关联)
- [ ] 批量写入已分批,没有循环单条 insert
- [ ] SQL 能在目标方言解析(`EXPLAIN` / `PREPARE` 不报语法错)
- [ ] 表、列、类型、约束存在,且与项目 wiki / 迁移脚本一致
- [ ] 参数只用 `#{}`,无 `${}`,个数与类型匹配
- [ ] 只读查询用代表性参数或 fixture 跑过,结果符合预期;写操作已事务回滚或 dry-run
- [ ] 已给出执行计划或预估行数
- [ ] 无法验证的层已写“未验证 + 原因”,没有写成“通过”
### 常见错误
- 凭"应该走索引"下结论,没跑执行计划
- 只写“通过”,没跑过任何一次解析或结果验证
- 拿测试库结构当生产结构
- 一种数据库的写法直接搬到另一种
- 加索引不看写入成本与选择性
- 在索引列上套函数导致失效
<!-- harness:package:end -->
<!-- harness:project:begin evidence -->
## 证据锚点(编译后填写)
<!-- slot:evidence - 至少一条 - [E2] 真实文件路径 :: 证明了什么 -->
<!-- harness:project:end -->
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · fengyale/harness-bootstrap | 91 | MIT |
| sumankrsh/enterprise-data-skills | 100 | MIT |
| claude-dev-suite/claude-dev-suite | 95 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 7fb55effca5d (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100fai-sql-optimization-skill
Optymalizuje zapytania SQL analizą planów wykonania, strojeniem indeksów, przepisywaniem zapytań i zarządzaniem statystykami w PostgreSQL, SQL Server lub MySQL. - 100nl2sql
Zamienia pytanie w języku naturalnym na SQL i wyniki z bazy biznesowej, bez analizy i interpretacji. - 100optimizing-sql-queries
Analizuje wydajność zapytań SQL i pomaga je optymalizować z użyciem automatyzacji. - 100sql
Wspiera pisanie SQL: ANSI SQL, CTE, funkcje okna, agregacje, indeksy i optymalizacja zapytań, także planów wykonania i projektowania baz. - 100sqlserver
Wspiera Microsoft SQL Server: T-SQL, plany wykonania, strojenie indeksów, grupy dostępności Always On i profilowanie DMV, w aplikacjach .NET i administracji. - 90sql-expert
Generuje, sprawdza i optymalizuje zapytania ClickHouse SQL dla danych i analiz.