Coding Principles

Språkagnostiska kodningsprinciper för underhållbarhet, läsbarhet och kodkvalitet.

av shinpr · shinpr/claude-code-workflows

Testad · Fungerar ★ 8.8/10

Coding Principles — Språkagnostiska kodningsprinciper för underhållbarhet, läsbarhet och kodkvalitet.

Vad den gör

En språkagnostisk checklista med kodningsprinciper som täcker funktionsdesign, felhantering, dependency injection, kommentering, refaktorisering och säkra standardvärden, plus en referens för säkerhetskontroller för granskning. Utlöses vid implementering av funktioner, refaktorisering eller granskning av kodkvalitet. Styr genererad kod mot parametriserade frågor, hemlighetssäkra loggningar, säker hashing, namngivna konstanter och små funktioner med enskilt ansvar.

Testrapport

Hämtade SKILL.md och dess enda refererade fil (references/security-checks.md, HTTP 200) från dev-skills-kopian; frontmatter har name+description och inga hårdkodade sökvägar eller säkerhetsbrister. För utdata skrev jag samma registerUser-funktion två gånger: en baslinje skriven naturligt, sedan en som strikt följde innehållet. Skill-versionen fixade konkret verkliga defekter i min baslinje — SQL-strängkonkatenering blev en parametriserad fråga, en console.log som läckte det klartextlösenordet blev en logg med endast användarnamn, MD5 blev pbkdf2 med salt, det magiska numret 13 blev MINIMUM_AGE, och rå e.message slutade läcka till anroparen. Utlösande fraser bedömdes: "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 — alla 5 korrekta.

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

Kommandon och exempelprompter

/coding-principlesSpråkagnostiska kodningsprinciper för underhållbarhet, läsbarhet och kodkvalitet.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →