Coding Principles

Principi di codifica agnostici al linguaggio per manutenibilità, leggibilità e qualità del codice

di shinpr · shinpr/claude-code-workflows

Promosso ★ 8.8/10

Coding Principles — Principi di codifica agnostici al linguaggio per manutenibilità, leggibilità e qualità del codice

Cosa fa

Una checklist agnostica al linguaggio di principi di codifica che copre progettazione di funzioni, gestione errori, dependency injection, commenti, refactoring e default sicuri, più un riferimento di security-checks per la revisione. Si attiva durante l'implementazione di funzionalità, il refactoring o la revisione della qualità del codice. Orienta il codice generato verso query parametrizzate, logging sicuro per i segreti, hashing sicuro, costanti nominate e piccole funzioni a responsabilità singola.

Rapporto di test

Recuperati SKILL.md e il suo unico file referenziato (references/security-checks.md, HTTP 200) dalla copia dev-skills; il frontmatter ha name+description e nessun percorso hardcoded o security smell. Per l'output ho scritto la stessa funzione registerUser due volte: una baseline scritta naturalmente, poi una seguendo rigorosamente il corpo. La skill versione ha concretamente corretto difetti reali nella mia baseline — la concatenazione di stringhe SQL è diventata una query parametrizzata, un console.log che esponeva la password in chiaro è diventato un log solo username, MD5 è diventato pbkdf2 con salt, il numero magico 13 è diventato MINIMUM_AGE, e e.message raw ha smesso di essere esposto al chiamante. Frasi trigger giudicate: "refactor this 300-line UserService" SÌ, "review my PR for code quality" SÌ, "implement a caching layer with clean maintainable structure" SÌ, "what's the difference between TCP and UDP" NO, "set up a GitHub Actions CI pipeline" NO — tutte e 5 corrette.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

/coding-principlesPrincipi di codifica agnostici al linguaggio per manutenibilità, leggibilità e qualità del codice

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →