Coding Principles

Sprachunabhängige Codierungsprinzipien für Wartbarkeit, Lesbarkeit und Codequalität

von shinpr · shinpr/claude-code-workflows

Getestet · Funktioniert ★ 8.8/10

Coding Principles — Sprachunabhängige Codierungsprinzipien für Wartbarkeit, Lesbarkeit und Codequalität

Was es kann

Eine sprachunabhängige Checkliste von Codierungsprinzipien, die Funktionsdesign, Fehlerbehandlung, Dependency Injection, Kommentierung, Refactoring und sichere Standardwerte abdeckt, plus eine Referenz für Sicherheitsprüfungen zur Überprüfung. Wird ausgelöst beim Implementieren von Features, Refactoring oder Überprüfen der Codequalität. Lenkt generierten Code hin zu parametrisierten Abfragen, geheimnis-sicherer Protokollierung, sicherem Hashing, benannten Konstanten und kleinen Funktionen mit einfacher Verantwortung.

Testbericht

SKILL.md und seine eine referenzierte Datei (references/security-checks.md, HTTP 200) aus der dev-skills-Kopie abgerufen; Frontmatter hat name+description und keine fest codierten Pfade oder Sicherheitslücken. Für den Output habe ich dieselbe registerUser-Funktion zweimal geschrieben: eine Baseline natürlich geschrieben, dann eine streng dem Inhalt folgend. Die Skill-Version behob konkret echte Defekte in meiner Baseline – SQL-String-Verkettung wurde zu einer parametrisierten Abfrage, ein console.log, das das Klartextpasswort preisgab, wurde zu einem Nur-Benutzernamen-Log, MD5 wurde zu pbkdf2 mit Salt, die magische Zahl 13 wurde zu MINIMUM_AGE, und rohe e.message hörte auf, an den Aufrufer zu gelangen. Trigger-Phrasierungen beurteilt: "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" NEIN, "set up a GitHub Actions CI pipeline" NEIN – alle 5 korrekt.

Getestet am: 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

Befehle & Beispiel-Prompts

/coding-principlesSprachunabhängige Codierungsprinzipien für Wartbarkeit, Lesbarkeit und Codequalität

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →