Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

query-pattern-analysis

/query-pattern-analysis

Analizuje zachowanie zapytań pod kątem poprawności i ryzyka wydajności, gdy zmienia się filtrowanie, stronicowanie, agregacja lub zapisy wsadowe.

Repozytorium
paqad-ai ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 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
8
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.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ą
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/lint-output.sh, scripts/scan-query-risks.sh

Co robi i kiedy

Analizuje zachowanie zapytań pod kątem poprawności i ryzyka wydajności, gdy zmienia się filtrowanie, stronicowanie, agregacja lub zapisy wsadowe.

Oryginalny opis (EN)

Analyzes query behavior for correctness and performance risk. Use when a request changes filtering, pagination, aggregation, eager loading, write batching or another query path that real data volume could regress.

Jak działa

  1. What It Does
  2. Use This When
  3. Inputs
  4. Procedure
  5. Output Contract
  6. Escalate / Stop Conditions
  7. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 262 słów
Podgląd SKILL.md
---
name: query-pattern-analysis
description: 'Analyzes query behavior for correctness and performance risk. Use when a request changes filtering, pagination, aggregation, eager loading, write batching or another query path that real data volume could regress.'
metadata:
  model_tier: reasoning
  cacheable: 'true'
  output_format: markdown
  paqad-meta: skill.meta.yaml
---

## What It Does

Analyzes changed query behavior for correctness, safety, and runtime cost so new data access patterns are reviewed against realistic usage rather than tiny fixture assumptions.

## Use This When

When a request changes filtering, pagination, aggregation, eager loading, write batching, or any query path that could regress with real data volume.

## Inputs

- Read the changed query code and the module query/schema docs first.
- Read `references/query-risk-guide.md` before classifying issues.
- Read any existing performance rules or query inventories relevant to the stack.

## Procedure

1. Run `scripts/scan-query-risks.sh <files...>` to surface candidate risks (orm-find-in-loop, await-in-map, select-\*, unbounded pagination, ORDER BY RANDOM, leading-wildcard LIKE, group-having).
2. For each hit, look up the remediation rule in `assets/risk-rules.txt`.
3. Confirm whether the changed query relies on schema/index assumptions; treat missing index as a Migration Safety risk, not Performance.
4. Bucket findings per `assets/output.template.md`.
5. Validate with `scripts/lint-output.sh`.

## Output Contract

- Return sections named `Correctness Risks`, `Migration Safety Risks`, and `Performance Risks`.
- Each finding must name the affected query path and the user or operational impact.
- If one bucket has no issues, write it explicitly as `none`.

## Escalate / Stop Conditions

- Ask when expected row counts, pagination strategy, or consistency rules are unknown and would change the analysis.
- Warn when a query relies on undefined ordering, broad scans, or hidden fan-out behavior.
- Do not treat micro-optimizations as findings if the changed behavior is not on a meaningful path.

## Resources

- `references/query-risk-guide.md`
- `scripts/scan-query-risks.sh`
- `scripts/lint-output.sh`
- `assets/output.template.md`
- `assets/risk-rules.txt`
- `runtime/capabilities/coding/stacks/laravel/rules/performance/guide.md`
- `agents/openai.yaml`
Pliki w paczce (8)
  • SKILL.md 2 KB
  • skill.meta.yaml 1 KB
  • agents/openai.yaml 1 KB
  • assets/output.template.md 1 KB
  • assets/risk-rules.txt 1 KB
  • references/query-risk-guide.md 1 KB
  • scripts/lint-output.sh 1 KB
  • scripts/scan-query-risks.sh 1 KB

Wersje

W bazie nie ma innych skilli o nazwie query-pattern-analysis.

Migawka bazy z 13.11.2026 · wersja paczki f44c0e4547de (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

  • 95db-advisor
    Monitoruje zapytania do bazy, wykrywa wzorzec N+1 w logach ORM i sugeruje eager loading lub grupowanie zapytań.
  • 100performance
    Pomaga optymalizować wydajność aplikacji: strategie cache, eager loading, optymalizacja zapytań, wzorce Redis i projektowanie zadań w tle.
  • 90n-plus-one-queries
    Znajduje i eliminuje problem N+1 w dostępie do bazy przez eager loading, batching lub dataloader, gdy endpoint listy zwalnia albo ORM ładuje leniwie w pętli.
  • 100filtering-query-builder
    Prawdopodobnie wspiera budowanie konstruktora zapytań z filtrowaniem w projektach API, uruchamiając się automatycznie przy frazach o konstruktorze zapytań.
  • 100review
    Przegląda pull request w ClickHouse pod kątem poprawności, bezpieczeństwa, wydajności i zgodności.
  • 100code-review
    Przegląda zmiany w dotnet/runtime pod kątem poprawności, wydajności i zgodności z konwencjami projektu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.