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

crap-gate

/crap-gate

Czyta i naprawia ustalenia bramki CRAP (crap-check, raport hooka commita, Quality / CRAP): funkcja z raportu, dzielenie lub testowanie złożonej funkcji i decyzja o stopce Crap-Debt.

Repozytorium
mux ↗
Licencja
AGPL-3.0
Ostatnia zmiana repozytorium
27.10.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

Co robi i kiedy

Czyta i naprawia ustalenia bramki CRAP (crap-check, raport hooka commita, Quality / CRAP): funkcja z raportu, dzielenie lub testowanie złożonej funkcji i decyzja o stopce Crap-Debt.

Oryginalny opis (EN)

Read and fix CRAP gate findings (crap-check, the commit hook report, Quality / CRAP). Use when a crap-gate or crap-check report names a function, before splitting or testing a complex function, or when deciding on a Crap-Debt trailer.

Jak działa

  1. Where reports come from
  2. Reading a finding
  3. The two repairs
  4. Anti-gaming rules
  5. Crap-Debt
Sekcje z nagłówków SKILL.md, w oryginale · 97 linii, 830 słów
Podgląd SKILL.md
---
name: crap-gate
description: Read and fix CRAP gate findings (crap-check, the commit hook report, Quality / CRAP). Use when a crap-gate or crap-check report names a function, before splitting or testing a complex function, or when deciding on a Crap-Debt trailer.
---

# CRAP gate

CRAP = CC² × (1 − coverage)³ + CC per function, where CC is cyclomatic
complexity. Complex code without tests scores high. The gate stops new debt and
makes touched hotspots shrink. The scorer is Crapper (`make crap`), and the
rules live in `scripts/crap/policy.ts` with thresholds in
`scripts/crap/thresholds.ts`.

## Where reports come from

- `make crap-check` (or `bun scripts/crap/check.ts --base <ref>`): the files
  changed since the merge-base with `origin/main`, in the working tree.
  Exit 0 pass, 1 violations, 2 tool error.
- The agent hook: after a `git commit` or `git push` bash call, Xum appends the
  report to the tool result (warn mode). In block mode the hook stops the
  command before it runs. `scripts/crap/agent-gate.sh` holds the mode. A bash
  call that exits non-zero gets no report, even when a `git commit` in it
  succeeded before a later command failed. Run `make crap-check` then.
- CI: the `Quality / CRAP` job summary and its annotations. When the repo
  variable `CRAP_MODE` is `block`, its violations fail `Required`. Otherwise it
  is informational.

Without coverage, scores are CC. With `--coverage <lcov>`, scores are CRAP.

## Reading a finding

```
VIOLATION floor-cc     src/x.ts:10-25 route: CC 30 -> 31 (head CRAP 31 above 30: must not grow)
```

| Rule           | Meaning                                                                                  |
| -------------- | ---------------------------------------------------------------------------------------- |
| `floor-cc`     | An existing function gained CC and ends above the growth line.                           |
| `floor-crap`   | With coverage on both sides, an existing function gained CRAP and ends above CRAP 30.    |
| `new-function` | A new function (or a renamed one, or one moved to another file) is above CRAP 15 (CC 8). |
| `crap-tax`     | A warning: you touched a function whose base score is above 30, and it did not drop.     |

- The growth line is CRAP 30 with coverage, CC 10 without. An existing function
  may grow while its head stays at or below the line. Above it, CC and CRAP
  must not grow. A reduction always passes, at any size, so a hotspot can
  shrink one step at a time.
- The new-function limit is CRAP 15 with coverage and CC 8 without.
- `crap-tax` is always a warning: a comment or one-line fix in a hotspot
  passes, with a nudge to shrink it.
- When the changed files' total CC drops, `new-function` findings are warnings
  (net-extraction relief): splitting a hotspot is allowed even if one piece is
  still above the limit.
- Moving a step out of a function raises the total CC by 1. Such a move is
  also a warning (move relief) when the kept functions lost at least as much
  CC as the new functions hold decision points (CC − 1 each), and the new
  function is at most CC 20. A rename gets no relief.
- With coverage, both reliefs need the new function at CRAP 30 or less. An
  untested piece above that stays a violation: test it or shrink it.
- The function name and line range are in the report. Identity is
  `path::namespace::name`, so renaming a function makes it new.

## The two repairs

1. Shrink the function. Extract pure logic into a named function with its own
   tests. In React, move state and effects into a named hook, or a part of the
   tree into a child component, each with its own tests.
2. Test it. Coverage lowers CRAP, so this repairs only reports with coverage
   (`--coverage <lcov>`, the CI job's new-function findings). The hook and a
   plain `make crap-check` score CC alone: tests cannot clear their `floor-cc`
   or `new-function` findings, so shrink the function instead (or keep it at
   CC 10 or less). A test must
   assert behavior that would fail if the code broke.

## Anti-gaming rules

Never do these to lower a score:

- Replace `?.` or `??` with `!`, `as` casts, or other unchecked assumptions.
  Crapper counts `?.` and `??` as decisions, but removing a real check hides a
  bug instead of removing complexity.
- Add tests without meaningful assertions (coverage probes, snapshot-only or
  `expect(true)` tests).
- Split code into one-caller helpers that only pass state through. The CC moves,
  the complexity stays, and the reader pays twice.
- Move or rename a function only to reset its history.

## Crap-Debt

When a violation cannot be fixed in this change (a hotfix, a generated file),
use the escape hatch for where the check runs. Every violation becomes a
warning, and the report lists each use. Name the follow-up in the reason.

- Local (the commit hook, `make crap-check`): add a `Crap-Debt: <reason>`
  trailer to the commit.
- CI (`Quality / CRAP`): add the `crap-debt` label to the PR. CI reads no
  trailers, and the label does not affect the local hook.

Agents: ask the maintainer first, and add the trailer or label only after an
explicit approval for that PR. The label skips every CI block, and agent PRs run
as the maintainer's account, so GitHub cannot show who added it.

Wersje

W bazie nie ma innych skilli o nazwie crap-gate.

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

  • 95review
    Mierzy zmiany, repozytorium lub dług skrótów w kodzie, wskazując ranking problemów z wynikami CRAP.
  • 100crap-score
    Liczy wskaźnik CRAP dla nazwanej metody, klasy lub pliku .NET na podstawie pokrycia i złożoności oraz wskazuje, które testy priorytetyzować.
  • 100crap-score
    Liczy wskaźnik CRAP (Change Risk Anti-Patterns) dla metod, klas lub plików .NET na podstawie pokrycia Cobertura i złożoności cyklomatycznej, aby ocenić jakość testów i ryzykowny nietestowany kod.
  • 84audit-coverage
    Odczytuje gotowe raporty pokrycia (lcov, Cobertura, coverage.py JSON, profil Go) i podaje pokrycie linii oraz wskaźnik CRAP dla plików i funkcji.
  • 100crap-analyzer
    Tworzy oparty na ryzyku plan refaktoryzacji i testów dla ostatnio zmienionego kodu, licząc wskaźnik CRAP (złożoność razy brak testów) dla zmienionych metod w wielu językach z automatycznym wykryciem pokrycia.
  • 100bdd-coder-review
    Przeprowadza niezależny przegląd gotowego kodu przez agenta code-reviewer, z oceną CC i CRAP funkcji oraz drugą opinią o poprawności, testach i projekcie, bez edycji kodu.

Uwagi i zgłoszenia

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