Coding Principles

Jazykově agnostické principy kódování pro udržovatelnost, čitelnost a kvalitu kódu

od shinpr · shinpr/claude-code-workflows

Otestováno · Funguje ★ 8.8/10

Coding Principles — Jazykově agnostické principy kódování pro udržovatelnost, čitelnost a kvalitu kódu

Co umí

Jazykově agnostický kontrolní seznam principů kódování pokrývající návrh funkcí, zpracování chyb, dependency injection, komentování, refaktorování a bezpečné výchozí hodnoty, plus referenci bezpečnostních kontrol pro revizi. Spouští se při implementaci funkcí, refaktorování nebo revizi kvality kódu. Směřuje generovaný kód k parametrizovaným dotazům, logování bezpečném pro tajemství, bezpečnému hašování, pojmenovaným konstantám a malým funkcím s jednou odpovědností.

Testovací report

Načteny SKILL.md a jeho jeden odkazovaný soubor (references/security-checks.md, HTTP 200) z kopie dev-skills; frontmatter má name+description a žádné pevně zakódované cesty nebo bezpečnostní rizika. Pro výstup jsem napsal stejnou funkci registerUser dvakrát: základní verzi napsanou přirozeně, poté jednu striktně podle těla. Verze s dovedností konkrétně opravila skutečné vady v mé základní verzi — zřetězení SQL řetězců se stalo parametrizovaným dotazem, console.log unikající heslo v prostém textu se stalo logem pouze s uživatelským jménem, MD5 se stalo pbkdf2 se solí, magické číslo 13 se stalo MINIMUM_AGE a raw e.message přestalo unikat volajícímu. Spouštěcí fráze posouzeny: "refaktoruj tuto 300řádkovou UserService" ANO, "zkontroluj můj PR pro kvalitu kódu" ANO, "implementuj vrstvu cache s čistou udržovatelnou strukturou" ANO, "jaký je rozdíl mezi TCP a UDP" NE, "nastav GitHub Actions CI pipeline" NE — všech 5 správně.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

/coding-principlesJazykově agnostické principy kódování pro udržovatelnost, čitelnost a kvalitu kódu

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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

Kompletní testovací report (anglicky) →