db-query-optimization

📁 kentoshimizu/sw-agent-skills 📅 1 day ago
1
总安装量
1
周安装量
#75869
全站排名
安装命令
npx skills add https://github.com/kentoshimizu/sw-agent-skills --skill db-query-optimization

Agent 安装分布

amp 1
cline 1
opencode 1
cursor 1
continue 1
kimi-cli 1

Skill 文档

DB Query Optimization

Overview

Use this skill to improve query performance based on execution evidence, not intuition.

Scope Boundaries

  • Hot-path latency or database CPU/IO usage is query-bound.
  • Query plans are unstable across parameter distributions.
  • Workload changes expose previously acceptable query anti-patterns.

Core Judgments

  • Dominant bottleneck: scan cost, join explosion, sort spill, lock wait, network round trips.
  • Rewrite scope: query shape, index changes, schema adjustment, or materialization.
  • Plan stability and parameter-sensitivity risk.
  • Correctness risk from aggressive rewrite or approximation.

Practitioner Heuristics

  • Start from actual execution plans and runtime metrics.
  • Optimize the highest-impact query families, not one-off outliers.
  • Sargability and predicate selectivity usually dominate early wins.
  • Keep optimization readable; opaque SQL hacks create long-term maintenance debt.

Workflow

  1. Identify high-impact queries by frequency and user/business impact.
  2. Capture plan/runtime evidence under representative parameters.
  3. Propose rewrites and access-path changes with expected effects.
  4. Compare candidates for latency gain versus complexity and risk.
  5. Roll selected change and monitor plan stability and resource usage.
  6. Record conditions that should trigger re-optimization.

Common Failure Modes

  • Tuning for small dev datasets misleads production behavior.
  • Index-only fixes mask poor query shape.
  • Query changes improve p50 while degrading tail latency.

Failure Conditions

  • Stop when no representative workload evidence is available.
  • Stop when optimization changes correctness semantics.
  • Escalate when required performance target is unattainable without model changes.