Coding Principles

Språkagnostiske kodingsprinsipper for vedlikeholdbarhet, lesbarhet og kodekvalitet

av shinpr · shinpr/claude-code-workflows

Bestått ★ 8.8/10

Coding Principles — Språkagnostiske kodingsprinsipper for vedlikeholdbarhet, lesbarhet og kodekvalitet

Hva den gjør

En språkagnostisk sjekkliste over kodingsprinsipper som dekker funksjonsdesign, feilhåndtering, avhengighetsinjeksjon, kommentering, refaktorering og sikre standarder, pluss en referanse for sikkerhetssjekker for gjennomgang. Utløses ved implementering av funksjoner, refaktorering eller gjennomgang av kodekvalitet. Styrer generert kode mot parameteriserte spørringer, hemmelighetssikker logging, sikker hashing, navngitte konstanter og små funksjoner med enkeltansvar.

Testrapport

Hentet SKILL.md og dens ene refererte fil (references/security-checks.md, HTTP 200) fra dev-skills-kopien; frontmatter har name+description og ingen hardkodede stier eller sikkerhetsbrister. For utdata skrev jeg samme registerUser-funksjon to ganger: en grunnlinje skrevet naturlig, deretter en som fulgte brødteksten strengt. Ferdighetsversjonen fikset konkret reelle feil i min grunnlinje — SQL strengkonkatenering ble en parameterisert spørring, en console.log som lekket passord i klartekst ble en kun brukernavn-logg, MD5 ble pbkdf2 med salt, det magiske tallet 13 ble MINIMUM_AGE, og rå e.message sluttet å lekke til anroperen. Utløserfraser vurdert: "refaktoriser denne 300-linjers UserService" JA, "gjennomgå min PR for kodekvalitet" JA, "implementer et caching-lag med ren vedlikeholdbar struktur" JA, "hva er forskjellen mellom TCP og UDP" NEI, "sett opp en GitHub Actions CI-pipeline" NEI — alle 5 korrekte.

Testet på: 2026-07-21 · Claude Code 2.x (agent harness)

Installer

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-principlesSpråkagnostiske kodingsprinsipper for vedlikeholdbarhet, lesbarhet og kodekvalitet

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →