CommunityCodierung & Entwicklunggithub.com

CodeQualität

Ein Loop für Codequalität in jedem Repository – betrachtet durch zwei Linsen: eine Werkzeuglinse (Linter, Typprüfer, Sicherheitsscanner, Dead-Code- und Duplikationsscanner) und eine Prinzipienlinse (SOLID + Clean-Code-Smells; ein Prinzip nach dem anderen).

Was ist CodeQualität?

Diese Skill bietet einen strukturierten, zweistufigen Ansatz zur kontinuierlichen Verbesserung der Codequalität in jedem Repository. Die **Werkzeuglinse** arbeitet automatisiert: Sie führt Linter, Typprüfer, Sicherheitsscanner und andere Werkzeuge aus, priorisiert die Ergebnisse nach Schweregrad (P0 Sicherheit → P1 Korrektheit → P2 Wartbarkeit) und behebt die Funde nacheinander. Dabei dienen die vorhandenen Tests als Sicherheitsnetz. Die **Prinzipienlinse** hingegen erfordert explizite Zustimmung: Sie identifiziert Designprobleme (z. B. God-Klassen, Duplikate, untestbare Kerne) und behebt ein einzelnes Prinzip aus SOLID oder Clean Code. Für jede Änderung wird zuerst ein Vorschlag unterbreitet, der bestätigt werden muss, bevor er angewendet wird. Bei ungetesteten Codeabschnitten werden zuerst Charakterisierungstests geschrieben. Die Skill unterstützt JavaScript, Python und YAML, installiert und konfiguriert alle benötigten Werkzeuge automatisch über ein zentrales Manifest (`Tools/tools.tsv`) und erstellt am Ende jeder Sitzung einen obligatorischen Qualitätsverbesserungsbericht. Sie ist für folgende Plattformen geeignet: Claude Code, Cursor, Codex und andere KI-Agenten, die über die standardisierte `AGENT_SKILLS_CONFIG`-Schnittstelle konfiguriert werden. Wichtige Anwendungsfälle: Verbesserung der Codequalität, Code-Analyse, Linting fixen, Duplikate reduzieren, Typsicherheit erhöhen, Sicherheitsscans, Refactoring, SOLID anwenden, Clean Code, Komplexität reduzieren, Legacy-Code modernisieren. Nicht geeignet für Issue-Lifecycle, Branches, PRs oder Merging – dafür ist die IssueFlow-Skill zuständig.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/CodeQuality

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Anpassung

Optionale persönliche Einstellungen: ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/CodeQuality/PREFERENCES.md.

Falls diese Datei existiert, lies sie ein und wende sie an; ansonsten arbeite mit den Standardeinstellungen der Skill. Persönliche Einstellungen nur: Alles, was eine Tatsache über ein Repository oder Produkt ist, gehört in dieses Repository (in seine .claude/workflow-profile.sh oder Tool-Konfigurationen), niemals hierher.

Was macht CodeQualität?

Ein Loop, zwei Linsen. Der Loop ist immer: erkennen → einen Punkt auswählen → hinter Tests fixen → verifizieren → wiederholen. Die Werkzeuglinse behebt, was Scanner melden, in der Prioritätsreihenfolge, mit vorhandenen Tests als Schutz. Die Prinzipienlinse behebt, was Code schwer änderbar macht (God-Klassen, Duplikate, untestbare Kerne), ein SOLID-/Clean-Code-Prinzip nach dem anderen, und wendet nie einen Design-Schritt an, ohne ihn vorher zu zeigen. Beide Linsen lesen dasselbe Werkzeug-Manifest, schreiben in dasselbe Berichtsverzeichnis und enden mit demselben Qualitätsverbesserungsbericht.

Zwei Linsen

WerkzeuglinsePrinzipienlinse
TreiberScanner-Ausgabe (summary.md)Design-Smells gemappt auf Principles.md (smell-inventory.md, roadmap.md)
Arbeitseinheitein Fund: eine Regel an einer Datei:Zeileein Prinzip an einem eingegrenzten Hotspot: ein Extract, eine Klassenaufteilung, eine Abhängigkeitsinversion
ReihenfolgeP0 Sicherheit → P1 Korrektheit → P2 WartbarkeitHebel-Hierarchie (unten), je nach Repository angepasst
Autonomiefixen, dann Diff zeigenvorschlagen → bestätigen → anwenden; nichts wird vor der Zustimmung bearbeitet
Sicherheitsnetzvorhandene Tests bleiben grünCharakterisierungstests werden zuerst geschrieben, wenn das Ziel ungetestet ist
Metrikweniger Funde, Tool erneut sauber ausführenDuplikationsgrad, zyklomatische Komplexität, Funktionslänge, Fan-In/Out, „jetzt unit-testbar“
Wann verwendenLint/Typ/Sicherheitsschulden, CI rot, „Scanner zufriedenstellen“Code, der sich gegen Änderungen sträubt; strukturelle Ebene eines Remediation-Sprints

Der Loop

SCAN → AUSWÄHLEN → SICHERHEITSNETZ → [VORSCHLAGEN → BESTÄTIGEN] → FIXEN → VERIFIZIEREN → BERICHT → WIEDERHOLEN
                             └─ verpflichtend im Prinzipienmodus, im Werkzeugmodus übersprungen ─┘

Workflow-Routing

AuslöserWorkflowErzeugt
„Qualitätswerkzeuge installieren“, „Codequalität einrichten“Workflows/Install.mdManifest-Werkzeuge installiert und verifiziert
„scannen“, „Baseline“, „Codequalität analysieren“, „Smell-Report“, „Was sollten wir zuerst fixen?“, „Refactoring-Roadmap“Workflows/Scan.mdsummary.md (A), smell-inventory.md (B), roadmap.md (C)
„Codequalität verbessern“, „Lint fixen“, „Qualitätsloop“, „[Fund] fixen“Workflows/Loop.md im Werkzeug-ModusFixes, session-log.md, Bericht
„refaktorieren“, „SOLID anwenden“, „das hier aufräumen“, „Loop starten“Workflows/Loop.md im Prinzipien-ModusFixes, session-log.md, Bericht
„Dieses Repo aufräumen“ ohne QualifikationScan A + B + C, dann Loop im Prinzipienmodusalles oben Genannte
„Remediation-Sprint“, „Remediation-Zyklus“IssueFlow Remediation verwaltet Branch, PR und Merge; Scan beschreibt den Zyklus, Loop führt ihn ausein PR pro Zyklus

Der Loop wählt seinen Modus selbst, wenn keiner angegeben ist: Werkzeug, wenn keine roadmap.md für das Repository existiert, Prinzipien, wenn eine existiert. Der Benutzer kann sowohl erzwingen.

Das Manifest

Tools/tools.tsv ist die einzige Liste der Werkzeuge in dieser Skill. Tabulatorgetrennt, eine Zeile pro Werkzeug und Sprache: language category priority tool install run notes, mit language in js | python | yaml, category in lint | format | types | security | deadcode | duplication | complexity | deps | coverage, priority in P0 | P1 | P2. Beide Skripte lesen es; die Workflows listen Werkzeuge nie inline. Zum Hinzufügen oder Entfernen eines Werkzeugs bearbeitest du eine Zeile.

SkriptLiest aus dem ManifestMacht
Tools/install-quality-tools.sh [--dry-run] [lang ...]install-Zellen der gewählten Sprachenerkennt Sprachen (package.json → js; pyproject.toml, requirements.txt oder *.py → python; *.yaml/*.yml → yaml); installiert js-Werkzeuge als devDependencies mit dem Paketmanager des Repository (lockfile → npm/pnpm/bun), Python- und YAML-Werkzeuge mit uv pip install oder pip; npm:/pip:-Prefixe überschreiben den Kanal, - installiert nichts
Tools/run-quality-baseline.sh [--dry-run] [lang ...]run-Zellenführt jedes Werkzeug in reports/codequality/<YYYY-MM-DD>-<HHMMSS>/ aus, ersetzt $OUT (Berichtsverzeichnis), $SRC (QUALITY_SRC_DIRS, Standard src falls vorhanden, sonst .), $PM und $NPX; ein nicht installiertes Werkzeug ist MISSING, ein abstürzendes ist FAILED, keines stoppt die Ausführung; schreibt summary.md mit Status pro Werkzeug, geparsten Issue-Anzahlen und P0/P1/P2-Summen; gibt den Berichtspfad aus

Zeilen, deren run - ist (Coverage-Werkzeuge), werden installiert, aber nicht von der Baseline ausgeführt: Coverage wird im Loop gemessen, begrenzt auf das Ziel. Jedes Werkzeug ist kostenlos und läuft lokal; npm audit, pip-audit und checkov erreichen das Netzwerk nur für ihre Schwachstellendatenbanken.

Hebel-Hierarchie (Standardreihenfolge der Prinzipienlinse)

  1. Namen — Code, den du nicht lesen kannst, kannst du nicht sicher ändern. Günstig, macht alles möglich.
  2. DRY / Duplikate — entfernt den meisten Code bei geringstem Risiko; legt versteckte Abstraktionen frei.
  3. Kleine Funktionen — Long Method → Extract; eine Abstraktionsebene pro Funktion.
  4. SRP — Klassen und Module aufteilen, die sich aus mehr als einem Grund ändern.
  5. OCP / DIP — Abhängigkeiten umkehren, Schnittstellen hinzufügen; hohe Auswirkung, höheres Risiko, zuerst Sicherheitsnetz.
  6. ISP / LSP — Fette Schnittstellen und gebrochene Substituierbarkeit; benötigen die Schnittstellen aus Schritt 5.

Scan Teil C passt diese Reihenfolge an das tatsächliche Inventar an (Hebel = Auswirkung ÷ Risiko; siehe Principles.md Teil 3).

Nicht verhandelbar

  • Ein Punkt pro Iteration. Ein Fund, oder ein Prinzip an einem eingegrenzten Ziel. Kleine, überprüfbare Diffs.
  • Verhaltensbewahrend. Struktur ändert sich, Verhalten nicht. Wenn sich das Verhalten ändern muss, stoppen und markieren: Das ist ein Feature, kein Fix.
  • Grün zu Grün. Tests bestehen vorher und nachher. Rot nach einer Änderung bedeutet Zurücksetzen, niemals vorwärts fixen.
  • Charakterisierungstests zuerst wenn die zu bearbeitenden Zeilen ungetestet sind. Kein Netz, keine Refaktorisierung.
  • Vor dem Anwenden vorschlagen bei jedem Design-Schritt (Prinzipienmodus). Der Werkzeugmodus darf direkt fixen, zeigt dann den Diff.
  • P0 → P1 → P2 für Werkzeugfunde, sprachübergreifend, niemals sprachspezifisch.
  • Nie einen Test oder eine Lint-Regel abschwächen, um Grün zu erreichen. Veraltete Tests werden zum neuen korrekten Verhalten verschoben; Regeln werden im Code erfüllt.
  • Boy-Scout, begrenzt. Berührte Dateien sauberer hinterlassen, aber den Umfang nicht über den aktuellen Punkt hinaus ausdehnen.
  • Evidenz, keine Meinung. Nenne die Regel oder das Prinzip und eine Metrik, falls vorhanden.

Ausgabeartefakte

Alle unter reports/codequality/ (git-ignoriert):

DateiGeschrieben von
<YYYY-MM-DD>-<HHMMSS>/summary.md + rohe Werkzeugausgaberun-quality-baseline.sh (Scan A)
<YYYY-MM-DD>/smell-inventory.mdScan B
<YYYY-MM-DD>/roadmap.mdScan C
<YYYY-MM-DD>/session-log.mdLoop, ein Eintrag pro Iteration
<YYYY-MM-DD>/quality-report.mdLoop, am Ende der Sitzung (unten)

Qualitätsverbesserungsbericht (verpflichtend)

Jede Loop-Sitzung endet mit diesem Bericht, in beiden Modi. Er ist das Lieferobjekt zusammen mit der Codeänderung und der Inhalt des PRs oder Tracker-Kommentars, wenn die Arbeit über IssueFlow ausgeliefert wird.

AbschnittInhalt
ZusammenfassungstabelleZeilen hinzugefügt / entfernt / netto; Issues vorher → nachher pro Priorität; Dead-Code-Hotspots entfernt; Tests vorher → nachher (Anzahl, alle grün)
Entfernter CodeDatei, was, Zeilen, Risiko
Hinzugefügter oder geänderter CodeDatei, was, Zeilen, Zweck
Behobene BugsSchweregrad, Beschreibung, Ursache (nur falls aufgetreten)
Komplexitätsdeltamaximale und durchschnittliche zyklomatische Komplexität vorher → nachher, mit einem ASCII-Balken pro Hotspot
ZurückgestelltGesehene, aber nicht im Scope liegende Punkte, und warum

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

BattlePlan

Daily execution plan from a task tracker (local CSV, Excel workbook, or Google Sheet). Groups open tasks by context and sub-context, estimates time, finds parallel threads, and writes ready-to-paste starting prompts per thread. Starts from yesterday instead of from zero — recaps the previous day's agent sessions and git commits, pre-fills the audit, and offers resume commands. Includes an end-of-day handoff (--close), an unattended morning draft (--draft), and task management (add, done, cancel, restore, sweep, batch import). USE WHEN plan my day, daily plan, battle plan, what should I work on, close the day, end of day handoff, morning draft, task overview, standup prep, prioritize tasks, add a task, mark task done, set up battleplan, configure task tracker.

MeetingAnalysis

Turn meetings into structured summaries and tracked action items. Transcribes recordings locally (faster-whisper on CUDA, Apple Silicon or CPU), imports Google Meet / Gemini notes through connectors, or takes pasted notetaker transcripts; writes a summary with decisions and an action table; pushes only your own items to the BattlePlan tracker. Includes an unattended inbox ingest (drop a recording, get a summary) and a hard rule that recordings never land in a git repo. USE WHEN analyze meeting, meeting summary, transcribe meeting, transcribe recording, summarize this call, what happened in the meeting, import meeting notes, Gemini notes, Google Meet notes, import meetings to tracker, auto ingest meetings, meeting inbox, process recordings folder, set up meeting analysis.

Verwandte Skills