Coding Standards

Standards agnostiques au langage pour les anti-patterns, la sûreté de type et le test-first pour les revues et refactorisations

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

Fonctionne avec configuration ★ 8.4/10

Coding Standards — Standards agnostiques au langage pour les anti-patterns, la sûreté de type et le test-first pour les revues et refactorisations

Ce que fait

Une référence universelle de standards de codage qui codifie la détection d'anti-patterns (Règle de Trois, SRP, DRY, suppression d'erreurs, assertions de type excessives), les règles de sûreté de type (unknown + type guards sur any/as), la gestion d'erreurs fail-fast, les tests Red-Green-Refactor, les portes d'analyse d'impact, et les valeurs par défaut sécurisées. Se déclenche lors de l'implémentation de fonctionnalités, de la révision de code ou de la refactorisation. S'applique comme guide dans la fenêtre de contexte plutôt que d'exécuter un outil.

Rapport de test

SKILL.md récupéré à .claude/skills-en/coding-standards/ ; le frontmatter contient name+description. Vérification ponctuelle de 3 chemins référencés via une récupération brute — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md tous HTTP 200 ; pas de failles de sécurité (le "Knowledge Cutoff Supplement" est informatif, pas une injection). Pour l'OUTPUT, j'ai écrit deux implémentations de fetchUser() : la référence a renvoyé `data as User` (pas de validation) ; la version suivant la compétence a utilisé `unknown` + un type guard isUser + une erreur fail-fast InvalidUserError. Exécuté le guard dans node contre `{id:42}` : la référence passe l'objet malformé typé comme User, le guard de la compétence renvoie false et lève une exception — une différence observée concrète correspondant aux règles de sûreté de type et de fail-fast de la compétence.

Testé le: 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

Commandes et exemples de prompts

  • /coding-standardsStandards agnostiques au langage pour les anti-patterns, la sûreté de type et le test-first pour les revues et refactorisations

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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