Coding Standards

Sprachunabhängige Anti-Pattern-, Typsicherheits- und Test-First-Standards für Reviews und Refactorings

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

Funktioniert mit Setup ★ 8.4/10

Coding Standards — Sprachunabhängige Anti-Pattern-, Typsicherheits- und Test-First-Standards für Reviews und Refactorings

Was es kann

Eine universelle Referenz für Codierungsstandards, die Anti-Pattern-Erkennung (Rule of Three, SRP, DRY, Fehlerunterdrückung, übermäßige Typzusicherungen), Typsicherheitsregeln (unknown + Type Guards über any/as), Fail-Fast-Fehlerbehandlung, Red-Green-Refactor-Tests, Impact-Analyse-Gates und sichere Standardeinstellungen kodifiziert. Wird ausgelöst beim Implementieren von Features, Überprüfen von Code oder Refactoring. Gilt als Anleitung im Kontextfenster, anstatt ein Tool auszuführen.

Testbericht

SKILL.md unter .claude/skills-en/coding-standards/ abgerufen; Frontmatter hat name+description. 3 referenzierte Pfade über Raw-Fetch stichprobenartig geprüft — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md alle HTTP 200; keine Sicherheitslücken (das „Knowledge Cutoff Supplement“ ist informativ, keine Injection). Für OUTPUT schrieb ich zwei fetchUser()-Implementierungen: Baseline gab `data as User` zurück (keine Validierung); Skill-gesteuert verwendete `unknown` + einen isUser-Type Guard + Fail-Fast InvalidUserError. Den Guard in Node gegen `{id:42}` ausgeführt: Baseline leitet das fehlerhafte Objekt als User typisiert weiter, Skill-Guard gibt false zurück, sodass es einen Fehler wirft — ein konkreter beobachteter Unterschied, der den Typsicherheits- und Fail-Fast-Regeln des Skills entspricht.

Getestet am: 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

Befehle & Beispiel-Prompts

  • /coding-standardsSprachunabhängige Anti-Pattern-, Typsicherheits- und Test-First-Standards für Reviews und Refactorings

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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