Coding Principles

Niezależne od języka zasady kodowania dla utrzymywalności, czytelności i jakości kodu

Autor: shinpr · shinpr/claude-code-workflows

Testowano · Działa ★ 8.8/10

Coding Principles — Niezależne od języka zasady kodowania dla utrzymywalności, czytelności i jakości kodu

Co robi ten skill

Niezależna od języka lista kontrolna zasad kodowania obejmująca projektowanie funkcji, obsługę błędów, wstrzykiwanie zależności, komentowanie, refaktoryzację i bezpieczne wartości domyślne, plus odniesienie do kontroli bezpieczeństwa do przeglądu. Uruchamia się podczas implementacji funkcji, refaktoryzacji lub przeglądu jakości kodu. Kieruje generowany kod w stronę sparametryzowanych zapytań, bezpiecznego logowania tajemnic, bezpiecznego haszowania, nazwanych stałych i małych funkcji o pojedynczej odpowiedzialności.

Raport z testu

Pobrano SKILL.md i jeden odwołujący się do niego plik (references/security-checks.md, HTTP 200) z kopii dev-skills; frontmatter ma name+description i brak zakodowanych na stałe ścieżek lub zagrożeń bezpieczeństwa. Dla wyniku napisałem tę samą funkcję registerUser dwukrotnie: bazową napisaną naturalnie, a następnie jedną ściśle zgodną z treścią. Wersja z umiejętnością konkretnie naprawiła rzeczywiste defekty w mojej bazowej — konkatenacja ciągów SQL stała się sparametryzowanym zapytaniem, console.log wyciekający hasło w postaci jawnej stał się logiem tylko z nazwą użytkownika, MD5 stało się pbkdf2 z solą, magiczna liczba 13 stała się MINIMUM_AGE, a surowy e.message przestał wyciekać do wywołującego. Frazy wyzwalające ocenione: „refaktoryzuj ten 300-liniowy UserService” TAK, „przejrzyj mój PR pod kątem jakości kodu” TAK, „zaimplementuj warstwę cache z czystą, utrzymywalną strukturą” TAK, „jaka jest różnica między TCP a UDP” NIE, „skonfiguruj potok CI GitHub Actions” NIE — wszystkie 5 poprawnych.

Testowano: 2026-07-21 · Claude Code 2.x (agent harness)

Instalacja

git clone --depth 1 https://github.com/shinpr/claude-code-workflows.git /tmp/coding-principles-src
mkdir -p ~/.claude/skills
cp -R /tmp/coding-principles-src/dev-skills/skills/coding-principles ~/.claude/skills/coding-principles
# Places SKILL.md at ~/.claude/skills/coding-principles/SKILL.md plus references/security-checks.md
# No deps, no scripts, no API keys — pure guidance skill.
# Identical copies also live under dev-workflows-frontend/ and dev-workflows-fullstack/ in the same repo.
# Plugin alternative: /plugin marketplace add shinpr/claude-code-workflows then /plugin install dev-workflows@claude-code-workflows

Komendy i przykładowe prompty

/coding-principlesNiezależne od języka zasady kodowania dla utrzymywalności, czytelności i jakości kodu

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

Review this function for maintainability issues
Refactor this code to be more readable
Check this feature implementation against coding principles

Pełny raport →