Coding Standards

Språkuavhengige anti-mønster, typesikkerhet og test-først standarder for gjennomganger og refaktoriseringer

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

Krever oppsett ★ 8.4/10

Coding Standards — Språkuavhengige anti-mønster, typesikkerhet og test-først standarder for gjennomganger og refaktoriseringer

Hva den gjør

En universell kodingsstandardreferanse som kodifiserer anti-mønsterdeteksjon (Rule of Three, SRP, DRY, feilundertrykkelse, overdreven type-påstander), typesikkerhetsregler (unknown + type guards over any/as), fail-fast feilhåndtering, Red-Green-Refactor testing, impact-analysis gates, og sikre standarder. Utløses ved implementering av funksjoner, gjennomgang av kode, eller refaktorisering. Anvendes som veiledning i kontekstvinduet i stedet for å kjøre et verktøy.

Testrapport

Hentet SKILL.md på .claude/skills-en/coding-standards/; frontmatter har name+description. Stikkprøvet 3 refererte stier via rå henting — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md alle HTTP 200; ingen sikkerhetsbrister ("Knowledge Cutoff Supplement" er informativ, ikke injeksjon). For OUTPUT skrev jeg to fetchUser()-implementasjoner: baseline returnerte `data as User` (ingen validering); ferdighets-fulgt brukte `unknown` + en isUser type guard + fail-fast InvalidUserError. Kjørte guarden i node mot `{id:42}`: baseline passerer det feilformede objektet gjennom typet som User, ferdighetsguarden returnerer false så den kaster en feil — en konkret observert forskjell som matcher ferdighetens typesikkerhets- og fail-fast-regler.

Testet på: 2026-07-31 · Claude Code 2.x (agent harness)

Installer

# 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-standardsSpråkuavhengige anti-mønster, typesikkerhet og test-først standarder for gjennomganger og refaktoriseringer

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →