Coding Standards

Språkagnostiska anti-mönster, typsäkerhet och test-först-standarder för granskningar och refaktoreringar

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

Fungerar med konfiguration ★ 8.4/10

Coding Standards — Språkagnostiska anti-mönster, typsäkerhet och test-först-standarder för granskningar och refaktoreringar

Vad den gör

En universell kodningsstandardreferens som kodifierar anti-mönsterdetektering (Rule of Three, SRP, DRY, felundertryckning, överdrivna typassertioner), typsäkerhetsregler (unknown + type guards över any/as), fail-fast felhantering, Red-Green-Refactor-testning, impact-analysis-grindar och säkra standardinställningar. Utlöses vid implementering av funktioner, kodgranskning eller refaktorering. Tillämpas som vägledning i kontextfönstret snarare än att köra något verktyg.

Testrapport

Hämtade SKILL.md på .claude/skills-en/coding-standards/; frontmatter har name+description. Kontrollerade 3 refererade sökvägar via rå hämtning — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md alla HTTP 200; inga säkerhetsbrister ("Knowledge Cutoff Supplement" är informativ, inte injektion). För OUTPUT skrev jag två fetchUser()-implementationer: baslinjen returnerade `data as User` (ingen validering); färdighetsföljande använde `unknown` + en isUser type guard + fail-fast InvalidUserError. Körde vakten i node mot `{id:42}`: baslinjen passerar det felaktiga objektet genom typat som User, färdighetsvakten returnerar false så den kastar ett fel — en konkret observerad skillnad som matchar färdighetens typsäkerhets- och fail-fast-regler.

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

Installation

# 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

Kommandon och exempelprompter

/coding-standardsSpråkagnostiska anti-mönster, typsäkerhet och test-först-standarder för granskningar och refaktoreringar

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →