Coding Standards

Sprogagnostiske anti-mønster, type-sikkerhed og test-først standarder for reviews og refaktorer

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

Virker med opsætning ★ 8.4/10

Coding Standards — Sprogagnostiske anti-mønster, type-sikkerhed og test-først standarder for reviews og refaktorer

Hvad det gør

En universel kodningsstandardreference, der kodificerer anti-mønsterdetektion (Rule of Three, SRP, DRY, error suppression, excessive type assertions), type-sikkerhedsregler (unknown + type guards over any/as), fail-fast fejlhåndtering, Red-Green-Refactor test, impact-analysis gates og sikre standarder. Udløses ved implementering af funktioner, kodegennemgang eller refaktorering. Anvendes som vejledning i kontekstvinduet snarere end at køre et værktøj.

Testrapport

Hentede SKILL.md på .claude/skills-en/coding-standards/; frontmatter har name+description. Stikprøvekontrollerede 3 refererede stier via rå hentning — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md alle HTTP 200; ingen sikkerhedsbrister ("Knowledge Cutoff Supplement" er informativ, ikke injektion). For OUTPUT skrev jeg to fetchUser()-implementeringer: baseline returnerede `data as User` (ingen validering); skill-følgende brugte `unknown` + en isUser type guard + fail-fast InvalidUserError. Kørte guarden i node mod `{id:42}`: baseline sender det fejlformede objekt igennem som User, skill guard returnerer false, så det kaster en fejl — en konkret observeret forskel, der matcher færdighedens type-sikkerheds- og fail-fast-regler.

Testet: 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

Kommandoer og eksempelprompter

/coding-standardsSprogagnostiske anti-mønster, type-sikkerhed og test-først standarder for reviews og refaktorer

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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

Læs hele rapporten →