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

structure-review

/structure-review

Sprawdza strukturę projektu: cykliczne importy, reguły warstw, zduplikowany kod, powtórzone listy i zbyt duże pliki, z tabelą do decyzji.

Licencja
MIT
Ostatnia zmiana repozytorium
06.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.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 robi i kiedy

Sprawdza strukturę projektu: cykliczne importy, reguły warstw, zduplikowany kod, powtórzone listy i zbyt duże pliki, z tabelą do decyzji.

Wyzwalacze z opisu

check for duplicatesno repetitionis it modularcircular dependencies
Oryginalny opis (EN)

Check a project's structure - circular imports, layer rules, duplicated code, repeated lists and text, oversized files - then verify each finding and hand the owner one table to decide from. Use for "check for duplicates", "no repetition", "is it modular", "circular dependencies", or before a release.

Jak działa

  1. Steps
  2. Notes
Sekcje z nagłówków SKILL.md, w oryginale · 18 linii, 337 słów
Podgląd SKILL.md
---
name: structure-review
description: Check a project's structure - circular imports, layer rules, duplicated code, repeated lists and text, oversized files - then verify each finding and hand the owner one table to decide from. Use for "check for duplicates", "no repetition", "is it modular", "circular dependencies", or before a release.
---

# Structure review

The scripts count; you reason. Findings first, fixes only after the owner has filled in the decision column.

## Steps
1. **Config.** Read `review.config.json`. If it has no `structure` block, copy it from `templates/review.config.json`, adapt the `layers` to the project's real folders (ask the owner when unclear), and show it before going on. Ask for `design.next` too if it is missing: the plug-in test needs it.
2. **Run the scripts.** From the project root: `node <kit>/scripts/structure.mjs --report structure-report.md`. Exit code 1 means a gated check found something. Do not edit code.
3. **Verify every row.** Start the `structure-reviewer` agent in a fresh context with the project path, the config, the kit path and the draft report, and none of your own opinions of the code. It opens the cited lines, drops what is not real, writes concrete fixes and runs the plug-in test. Then check its Highs yourself by reading the cited code. Its verification rules live in `agents/clean-code/structure-reviewer.md`.
4. **Merge.** Take the agent's verified rows and concrete fixes, keep the effort column honest, and drop any row you could not confirm.
5. **Deliver.** Use `templates/structure-report.md`: the summary, then one table per check, ranked by effort-to-benefit, with an empty **Your decision** column. Show it in the reply as tables and, if the owner will share it, publish it as a page too.
6. **Decide together.** The owner fills in the decision column (fix, accept, later). Fix only the "fix" rows, one pass, then re-run step 2. Gated checks must end at zero or be explicitly accepted by the owner in the config (`gate` list).

## Notes
- The agent runs the plug-in test (files that change per planned feature); read its table and challenge any row that lists more than one place without a reason.
- Do not edit the kit for one project. Layer maps and limits live in that project's `review.config.json`.
- Say plainly what the scripts cannot see: runtime wiring, code generated at build time, copies that differ by a word.

Wersje

RepozytoriumWynikLicencja
Ta strona · yuvarajsalla20/code-review-kit90MIT
tamerardall/groundwork100MIT

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

  • 100import-discipline
    Porządkuje importy w plikach: grupowanie, sortowanie, rozdzielanie, cykliczne zależności i zasada, że importy są spisem treści pliku.
  • 100techdebt
    Wykrywa dług techniczny: zduplikowany kod, martwy kod, TODO i zbyt duże funkcje w całej bazie kodu, na koniec sesji lub przy audycie higieny kodu.
  • 96circular-import-analysis
    Wykrywa cykliczne importy w bibliotece ddtrace i proponuje poprawki architektury, gdy przy zmianach pojawiają się nowe cykle.
  • 100agentic-linter
    Egzekwuje granice warstw architektury zdefiniowane w AGENTS.md: wykrywa i naprawia naruszenia importów, zależności cykliczne i błędy warstw.
  • 100refactor-clean
    Porządkuje rozrośnięty, zduplikowany lub zaśmiecony kod: poprawia strukturę i usuwa martwy kod bez zmiany obserwowalnego zachowania.
  • 100component-boundary-identifier
    Wyznacza granice między modułami i komponentami przez statyczną analizę kodu Python i Java: wykrywa naruszenia granic, cykliczne zależności i sprzężenie komponentów.

Uwagi i zgłoszenia

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