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

complexity-management

/complexity-management

Pomaga naprawić nieudaną bramkę złożoności kodu albo funkcję zbliżającą się do limitu.

Licencja
CC0-1.0
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

96/ 100Klasa: dobry
Format25 / 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
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

CC0-1.0, otwarta.

Co robi i kiedy

Pomaga naprawić nieudaną bramkę złożoności kodu albo funkcję zbliżającą się do limitu.

Oryginalny opis (EN)

Use when the complexity gate fails or a function approaches a limit.

Jak działa

  1. Use This Skill When
  2. Commands
  3. Rules
  4. Verification
Sekcje z nagłówków SKILL.md, w oryginale · 34 linii, 263 słów
Podgląd SKILL.md
---
name: complexity-management
description: Use when the complexity gate fails or a function approaches a limit.
---

# Complexity Management

## Use This Skill When

- `make complexity` reports a function over a limit.
- A function grows towards a limit and should be split before it fails.

## Commands

- `make complexity` runs the complexity lints alone and prints only complexity findings.
- `make static-analysis` runs the full strict lint, which includes the same four lints.

## Rules

- The limits live in `clippy.toml` and are quoted in `quality-standards` only; never copy a number into another file and never raise a limit to pass.
- Never add `#[allow]` or `#[expect]` to silence a complexity lint; refactor.
- Too long: extract a named function for each step of the body, keeping the call order readable.
- Too complex: replace nested `if` chains with early returns, guard clauses or a `match` on one value; move each branch into a small function.
- Too deeply nested: return early, use `?` instead of `match` on `Result`, flatten with iterator adaptors.
- Too many arguments: group related arguments into a struct or a value object of the domain, and pass the struct.
- Handlers follow the pattern of the architecture document: the trait method only delegates to an inherent `async fn`, and each step of the logic is its own function.
- Keep a refactor behaviour-preserving: run the unit tests before and after.
- Test code is relaxed for two of the lints, production code is not.

## Verification

```bash
make complexity
make unit-tests
```

Continue with `testing-workflow` when a test breaks after the refactor and with `architecture-boundary-fixer` when code must move between layers.

Wersje

W bazie nie ma innych skilli o nazwie complexity-management.

Migawka bazy z 13.11.2026 · wersja paczki 3384b2247d88 (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-complexity
    Analizuje metryki złożoności kodu: cyklomatyczną, kognitywną, długość funkcji i sprzężenie, by wskazać cele refaktoryzacji i śledzić zdrowie bazy kodu.
  • 91timeline-site-build
    Pomaga naprawić nieudaną budowę strony i potwierdza, że zbudowane strony działają.
  • 90complexity-grill
    Pomaga jakościowo zidentyfikować prawdziwe źródła złożoności, zanim zaczną się liczyć metryki.
  • 100lizard-complexity
    Uruchamia Lizard na kodzie produkcyjnym, by egzekwować progi złożoności cyklomatycznej (CCN), NLOC i liczby parametrów funkcji w ponad 30 językach, z jedną bramką w CI.
  • 100time-complexity
    Szacuje złożoność czasową kodu Big-O na podstawie analizy statycznej, wskazując gorące punkty wydajności.
  • 100find-complexity
    Wyszukuje funkcje i metody o wysokiej złożoności cyklomatycznej, nadmiernej długości lub zbyt wielu parametrach jako kandydatów do refaktoryzacji.

Uwagi i zgłoszenia

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