Coding Principles

Sprog-agnostiske kodningsprincipper for vedligeholdelse, læsbarhed og kodekvalitet

Af shinpr · shinpr/claude-code-workflows

Testet · Virker ★ 8.8/10

Coding Principles — Sprog-agnostiske kodningsprincipper for vedligeholdelse, læsbarhed og kodekvalitet

Hvad det gør

En sprog-agnostisk tjekliste over kodningsprincipper, der dækker funktionsdesign, fejlhåndtering, dependency injection, kommentering, refaktorering og sikre standarder, plus en sikkerhedskontrolreference til gennemgang. Udløses ved implementering af funktioner, refaktorering eller gennemgang af kodekvalitet. Styrer genereret kode mod parametriserede forespørgsler, hemmelighedssikker logning, sikker hashing, navngivne konstanter og små enkeltansvarsfunktioner.

Testrapport

Hentede SKILL.md og dens ene refererede fil (references/security-checks.md, HTTP 200) fra dev-skills kopien; frontmatter har name+description og ingen hardcoded stier eller sikkerhedsbrister. Til output skrev jeg den samme registerUser funktion to gange: en baseline skrevet naturligt, derefter en, der strengt fulgte brødteksten. Skill-versionen rettede konkret reelle defekter i min baseline — SQL strengkonkatenation blev en parametriseret forespørgsel, en console.log, der lækkede plaintext-adgangskoden, blev en brugernavn-kun log, MD5 blev pbkdf2 med salt, det magiske tal 13 blev MINIMUM_AGE, og rå e.message stoppede med at lække til kalderen. Trigger-fraseringer bedømt: "refactor this 300-line UserService" JA, "review my PR for code quality" JA, "implement a caching layer with clean maintainable structure" JA, "what's the difference between TCP and UDP" NEJ, "set up a GitHub Actions CI pipeline" NEJ — alle 5 korrekte.

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

Kommandoer og eksempelprompter

/coding-principlesSprog-agnostiske kodningsprincipper for vedligeholdelse, læsbarhed og kodekvalitet

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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

Læs hele rapporten →