Coding Standards

Niezależne od języka standardy anty-wzorców, bezpieczeństwa typów i test-first dla przeglądów i refaktoryzacji

Autor: shinpr · shinpr/ai-coding-project-boilerplate

Działa po konfiguracji ★ 8.4/10

Coding Standards — Niezależne od języka standardy anty-wzorców, bezpieczeństwa typów i test-first dla przeglądów i refaktoryzacji

Co robi ten skill

Uniwersalna referencja standardów kodowania, która kodyfikuje detekcję anty-wzorców (Rule of Three, SRP, DRY, error suppression, excessive type assertions), reguły type-safety (unknown + type guards zamiast any/as), obsługę błędów fail-fast, testowanie Red-Green-Refactor, bramki impact-analysis i secure defaults. Uruchamia się podczas implementacji funkcji, przeglądania kodu lub refaktoryzacji. Stosuje się jako wskazówka w oknie kontekstowym, a nie uruchamia żadnego narzędzia.

Raport z testu

Pobrano SKILL.md pod .claude/skills-en/coding-standards/; frontmatter ma name+description. Sprawdzono 3 referencyjne ścieżki via raw fetch — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md wszystkie HTTP 200; brak security smells ("Knowledge Cutoff Supplement" jest informacyjny, nie injection). Dla OUTPUT napisałem dwie implementacje fetchUser(): baseline zwrócił `data as User` (brak walidacji); wersja zgodna z umiejętnością użyła `unknown` + isUser type guard + fail-fast InvalidUserError. Uruchomiono guard w node przeciwko `{id:42}`: baseline przepuszczał źle sformułowany obiekt jako User, guard umiejętności zwraca false, więc rzuca wyjątek — konkretna obserwowana różnica zgodna z regułami type-safety i fail-fast umiejętności.

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

Instalacja

# 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

Komendy i przykładowe prompty

/coding-standardsNiezależne od języka standardy anty-wzorców, bezpieczeństwa typów i test-first dla przeglądów i refaktoryzacji

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

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

Pełny raport →