Coding Standards

Standard agnostici al linguaggio per anti-pattern, type-safety e test-first per revisioni e refactoring

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

Richiede configurazione ★ 8.4/10

Coding Standards — Standard agnostici al linguaggio per anti-pattern, type-safety e test-first per revisioni e refactoring

Cosa fa

Un riferimento universale agli standard di codifica che codifica il rilevamento di anti-pattern (Rule of Three, SRP, DRY, soppressione degli errori, asserzioni di tipo eccessive), regole di type-safety (unknown + type guards su any/as), gestione degli errori fail-fast, test Red-Green-Refactor, gate di analisi dell'impatto e default sicuri. Si attiva durante l'implementazione di funzionalità, la revisione del codice o il refactoring. Si applica come guida nella finestra di contesto piuttosto che eseguire qualsiasi strumento.

Rapporto di test

Recuperato SKILL.md in .claude/skills-en/coding-standards/; il frontmatter ha name+description. Verificati 3 percorsi referenziati tramite raw fetch — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md tutti HTTP 200; nessun problema di sicurezza (il "Knowledge Cutoff Supplement" è informativo, non un'iniezione). Per l'OUTPUT ho scritto due implementazioni di fetchUser(): la baseline restituiva `data as User` (nessuna validazione); la skill-following usava `unknown` + un type guard isUser + InvalidUserError fail-fast. Eseguito il guard in node contro `{id:42}`: la baseline passa l'oggetto malformato tipizzato come User, il guard della skill restituisce false quindi lancia un'eccezione — una differenza osservata concreta che corrisponde alle regole di type-safety e fail-fast della skill.

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

Installazione

# 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

Comandi e prompt di esempio

/coding-standardsStandard agnostici al linguaggio per anti-pattern, type-safety e test-first per revisioni e refactoring

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →