Coding Standards

Jazykově agnostické standardy pro anti-vzory, typovou bezpečnost a test-first pro revize a refaktoringy

od shinpr · shinpr/ai-coding-project-boilerplate

Funguje s nastavením ★ 8.4/10

Coding Standards — Jazykově agnostické standardy pro anti-vzory, typovou bezpečnost a test-first pro revize a refaktoringy

Co umí

Univerzální referenční standardy kódování, které kodifikují detekci anti-vzorů (Rule of Three, SRP, DRY, potlačení chyb, nadměrné typové aserce), pravidla typové bezpečnosti (unknown + type guards nad any/as), fail-fast zpracování chyb, testování Red-Green-Refactor, brány pro analýzu dopadu a bezpečné výchozí nastavení. Spouští se při implementaci funkcí, revizi kódu nebo refaktoringu. Aplikuje se jako vodítko v kontextovém okně namísto spouštění jakéhokoli nástroje.

Testovací report

Načten SKILL.md na .claude/skills-en/coding-standards/; frontmatter má name+description. Namátkově zkontrolovány 3 odkazované cesty přes raw fetch — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md všechny HTTP 200; žádné bezpečnostní problémy ("Knowledge Cutoff Supplement" je informativní, nikoli injekce). Pro OUTPUT jsem napsal dvě implementace fetchUser(): základní verze vrátila `data as User` (bez validace); verze s dovedností použila `unknown` + isUser type guard + fail-fast InvalidUserError. Spuštěn guard v node proti `{id:42}`: základní verze propustí špatně formátovaný objekt typovaný jako User, guard dovednosti vrátí false, takže vyhodí chybu — konkrétní pozorovaný rozdíl odpovídající pravidlům typové bezpečnosti a fail-fast dovednosti.

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

Instalace

# Copies the coding-standards skill (SKILL.md + references/) into ~/.claude/skills
git clone --depth 1 https://github.com/shinpr/ai-coding-project-boilerplate.git /tmp/coding-standards-src
mkdir -p ~/.claude/skills
cp -R /tmp/coding-standards-src/.claude/skills-en/coding-standards ~/.claude/skills/coding-standards
# Japanese variant also exists at .claude/skills-ja/coding-standards if preferred
# No external deps, scripts, or API keys required — pure guidance document

Příkazy a ukázkové prompty

/coding-standardsJazykově agnostické standardy pro anti-vzory, typovou bezpečnost a test-first pro revize a refaktoringy

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

Check this function for code smells
Review my pull request for anti-patterns
Refactor this module for readability

Kompletní testovací report (anglicky) →