Coding Principles

Principes de codage agnostiques au langage pour la maintenabilité, la lisibilité et la qualité du code.

par shinpr · shinpr/claude-code-workflows

Testé · Fonctionne ★ 8.8/10

Coding Principles — Principes de codage agnostiques au langage pour la maintenabilité, la lisibilité et la qualité du code.

Ce que fait

Une liste de contrôle agnostique au langage de principes de codage couvrant la conception de fonctions, la gestion des erreurs, l'injection de dépendances, les commentaires, le refactoring et les valeurs par défaut sécurisées, plus une référence de vérifications de sécurité pour la révision. Se déclenche lors de l'implémentation de fonctionnalités, du refactoring ou de la révision de la qualité du code. Oriente le code généré vers des requêtes paramétrées, une journalisation sécurisée des secrets, un hachage sécurisé, des constantes nommées et de petites fonctions à responsabilité unique.

Rapport de test

SKILL.md et son seul fichier référencé (references/security-checks.md, HTTP 200) ont été récupérés de la copie dev-skills ; le frontmatter a name+description et aucun chemin codé en dur ni faille de sécurité. Pour la sortie, j'ai écrit la même fonction registerUser deux fois : une base écrite naturellement, puis une suivant strictement le corps. La version de la compétence a concrètement corrigé de réels défauts dans ma base — la concaténation de chaînes SQL est devenue une requête paramétrée, un console.log divulguant le mot de passe en clair est devenu un log uniquement du nom d'utilisateur, MD5 est devenu pbkdf2 avec sel, le nombre magique 13 est devenu MINIMUM_AGE, et e.message brut a cessé de fuir vers l'appelant. Phrases de déclenchement jugées : "refactoriser ce UserService de 300 lignes" OUI, "réviser ma PR pour la qualité du code" OUI, "implémenter une couche de cache avec une structure propre et maintenable" OUI, "quelle est la différence entre TCP et UDP" NON, "configurer un pipeline CI GitHub Actions" NON — les 5 correctes.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/shinpr/claude-code-workflows.git /tmp/coding-principles-src
mkdir -p ~/.claude/skills
cp -R /tmp/coding-principles-src/dev-skills/skills/coding-principles ~/.claude/skills/coding-principles
# Places SKILL.md at ~/.claude/skills/coding-principles/SKILL.md plus references/security-checks.md
# No deps, no scripts, no API keys — pure guidance skill.
# Identical copies also live under dev-workflows-frontend/ and dev-workflows-fullstack/ in the same repo.
# Plugin alternative: /plugin marketplace add shinpr/claude-code-workflows then /plugin install dev-workflows@claude-code-workflows

Commandes et exemples de prompts

/coding-principlesPrincipes de codage agnostiques au langage pour la maintenabilité, la lisibilité et la qualité du code.

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

Review this function for maintainability issues
Refactor this code to be more readable
Check this feature implementation against coding principles

Rapport complet →