Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

quality-pass

/quality-pass

Przeprowadza przegląd jakości kodu: wyszukuje złe wzorce i projekt, upraszcza, usuwa zbędne reguły i brudne sztuczki.

Repozytorium
loci ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 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ść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
2
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Skrypty: fnlen.py

Co robi i kiedy

Przeprowadza przegląd jakości kodu: wyszukuje złe wzorce i projekt, upraszcza, usuwa zbędne reguły i brudne sztuczki.

Oryginalny opis (EN)

Run a code-quality pass on loci (review, verify, apply, check, record). Use when asked to review the codebase for smells or bad design, make it more readable or robust, shrink it, or drop unneeded rules and dirty tricks.

Jak działa

  1. 1. Measure the baseline
  2. 2. Review
  3. 3. Verify each finding yourself
  4. 4. Apply
  5. 5. Check
  6. 6. Re-review and record
Sekcje z nagłówków SKILL.md, w oryginale · 93 linii, 763 słów
Podgląd SKILL.md
---
name: quality-pass
description: Run a code-quality pass on loci (review, verify, apply, check, record). Use when asked to review the codebase for smells or bad design, make it more readable or robust, shrink it, or drop unneeded rules and dirty tricks.
---

# Quality pass

A pass makes loci easier to understand and more robust while making it smaller. It ends when the
re-review finds nothing worth applying and the checks pass. It does not end when the code merely looks better.

## 1. Measure the baseline

Record these before any edit, so the result is measured, not asserted:

```sh
python3 .claude/skills/quality-pass/fnlen.py        # functions, over 40/60 lines, longest, mean
git ls-files -co --exclude-standard 'crates/*/src/*.rs' 'crates/*/src/**/*.rs' | xargs cat | wc -l
```

Runtime invariant checks in production code (test modules excluded):

```sh
for f in $(git ls-files -co --exclude-standard 'crates/*/src/*.rs' 'crates/*/src/**/*.rs'); do
  awk '/#\[cfg\(test\)\]/{exit} {print}' "$f"; done | grep -cE '\.expect\(|panic!\(|unreachable!\('
```

Compare only counts taken with these exact commands.

## 2. Review

Spawn reviewer agents (read-only, in the background), one per lens, each briefed with the scope and the
rules below. For a small scope, one agent covering all lenses is enough.

- **Design and boundaries:** internals exposed across modules or crates (pub fields, raw paths or
  strings that should be types); free functions that belong as methods; an Option, bool or String
  standing in for an enum; one concept modelled twice; lookups repeated after a type could carry the result.
- **Shrink:** dead or single-use code, speculative flexibility, rules and special cases that can go,
  hand-rolled code where std or an existing dependency does it, duplicate tests, dirty tricks
  (re-slicing text to recover what the parser knew, hand-counted offsets, magic constants).
- **Robustness:** silent fallbacks and skips, unchecked preconditions, check-then-act file races, writes
  that follow symlinks, `expect`s a type could make impossible, errors that lose what failed, edge cases
  (empty input, no frontmatter, CRLF, BOM, non-UTF-8 names). Prove each with a concrete input.
- **Readability:** names narrower or wider than the thing, comments the code no longer matches, control
  flow a reader must simulate, state spread over variables that one type would hold.
- **Code versus docs:** `docs/specs/*.md`, `docs/RUNBOOK.md` and recent `docs/DECISIONS.md` entries
  against the code; stale module docs and refusal-code lists; decisions naming functions that no longer exist.

Rules for reviewers:
- Every finding cites a file:line the reviewer actually read, and gives a concrete fix.
- Length alone is not a defect. Do not propose splitting a function unless its parts are separate ideas
  and the split reads better.
- Search `docs/DECISIONS.md` before proposing to undo something, and cite the D-number.
- Findings hold no vault content and use neutral examples (D53, D62).

## 3. Verify each finding yourself

Open the cited code before acting. Each finding gets one of these outcomes:
- **Apply:** the claim holds and the fix is simpler or more correct.
- **Ask the user:** the fix changes user-visible behaviour, or undoes a recorded decision.
  The user's decision outranks a reviewer's finding.
- **Decline with a reason:** the claim is wrong, already handled, or the fix is not an improvement.
  Recheck the reason before reporting it; a wrong decline reason is a defect too.

## 4. Apply

- One finding at a time. Run the tests after each group of related edits.
- A bug fix gets a test that fails without it.
- A behaviour change also updates the spec line that describes it.
- Splits: keep a function whole when its steps belong together; extract only a separate idea.
- When a change makes something unused, remove it. Leave unrelated dead code alone and mention it instead.
- Propose any new abstraction (a type, a trait, a constructor) in two or three sentences before building it.
- Do not stage or commit. Run `git add -N` on new files only, so the flake sees them.

## 5. Check

All of these must pass before reporting:

```sh
cargo fmt && cargo clippy -q --all-targets -- -D warnings
cargo test -q
RUSTDOCFLAGS="-D warnings" cargo doc -q --no-deps --workspace
nix flake check
```

When the parser changed, run the parse-span fuzz at 30k cases. Temporarily set `with_cases(30000)` in
`crates/loci-core/tests/parse_spans.rs`, then run `cargo test --release -p loci-core --test parse_spans`,
then restore the 2000. `PROPTEST_CASES` does not override it. To confirm the larger count ran, check that
the test recompiled and that its time grew.

## 6. Re-review and record

- Re-run step 2 on the changed code. Stop when it finds nothing worth applying. Do not stop because
  findings were left unexamined; every finding gets an outcome from step 3.
- Measure again (step 1) and report before and after.
- Append a D-entry to `docs/DECISIONS.md`. It is append-only: supersede an old entry, never edit it.
  The entry covers what changed, what was declined and why, and the numbers.
Pliki w paczce (2)
  • SKILL.md 5 KB
  • fnlen.py 1 KB

Wersje

W bazie nie ma innych skilli o nazwie quality-pass.

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

  • 100code-quality
    Przegląda kod w poszukiwaniu problemów jakości, naruszeń stylu i code smells.
  • 100quality-review
    Przeprowadza przegląd jakości kodu po sprawdzeniu zgodności ze specyfikacją, także pod kątem bezpieczeństwa, w niezależnym podagencie.
  • 100review-code
    Przeprowadza przegląd kodu na poziomie starszego inżyniera: review PR, zmian i jakości kodu.
  • 100clean-code
    Stosuje zasady czystego kodu przy refaktoryzacji i przeglądzie jakości: wyszukuje code smells, upraszcza złożoność, poprawia nazewnictwo i stosuje SOLID, także w fazie refaktoryzacji cyklu TDD.
  • 100code-review-specialist
    Przeprowadza przegląd kodu z analizą bezpieczeństwa, wydajności i jakości, przy ocenie pull requestów i jakości kodu.
  • 100quality-review
    Ocenia zmiany w kodzie pod kątem standardów jakości z pliku AGENTS.md, gdy trzeba zrobić przegląd implementacji.

Uwagi i zgłoszenia

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