code-quality

Co robi i kiedy

Pilnuje jakości kodu, komentarzy, testów i dokumentacji przy pisaniu i przeglądzie.

Jak działa

SKILL.md bez nagłówków drugiego poziomu · 19 linii, 150 słów

---
name: code-quality
description: Use when writing or reviewing code, comments, tests, or docs.
metadata:
  internal: true  # repo tooling: hidden from `npx skills add superdesigndev/treg`
---

# Code quality

1. **Enforce, don't instruct.** If a machine can check a rule, add the check.
   Apply these rules to code you change; fix old code in its own PR.

2. **Comments: none by default.** Keep one only for behavior we cannot change
   (vendor, platform, protocol) or a public contract. A reason worth keeping
   moves to a test, the docs, or the commit message.

3. **Tests must be able to fail.** Test behavior through the real entry point;
   if a test still passes with every dependency returning None, it is fake.
   Break the behavior, show the failing run, then land it. Never turn CI
   green by skipping, retrying, sleeping, or loosening an assertion.

4. **Docs say only what code cannot.** Keep a sentence only if, without it,
   the next person would change the code wrongly. Each fact once, where it
   belongs; when docs and code disagree, fix the doc.

Wersje

Migawka bazy z 28.10.2026 · wersja paczki a8afaba9c304 (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

• 100testing
  Stosuje TDD świadome repozytorium, projekt testów obserwujących zachowanie i odpowiednie kontrole jakości przy zmianie zachowania, pisaniu testów i przeglądzie ich jakości.
• 100testing
  Stosuje dobre praktyki testów jednostkowych, integracyjnych i E2E przy pisaniu testów, przeglądzie pokrycia i projektowaniu kodu.
• 100comments-docs
  Ocenia jakość komentarzy i praktyk dokumentacyjnych: cztery typy komentarzy, kolejność komentarze najpierw oraz psucie się komentarzy z czasem.
• 95code-comments
  Ustala zasady pisania komentarzy w kodzie: wbudowane, dokumentacyjne (TSDoc, GoDoc, docstringi) i TODO, także przy przeglądzie diffów.
• 100code-comments
  Wyodrębnia lokalizacje komentarzy z plików kodu do analizy, przy czyszczeniu komentarzy, audycie dokumentacji i analizie wzorców komentowania w różnych językach.
• 90test-audit
  Pilnuje jakości testów przy pisaniu i przeglądzie, wskazuje testy słabe, zależne od implementacji lub zduplikowane.