Communitygithub.com

Codierung

Dieses Skill dient als Einstiegspunkt für Softwarearbeit und leitet je nach Aufgabe in die passende Referenz weiter.

Was ist Codierung?

Dieses Skill fungiert als zentraler Wegweiser für alle Softwareentwicklungsaufgaben. Wenn ein Entwickler oder ein KI-Agent eine Aufgabe im Bereich Codierung erhält, wird anhand der Aufgabenart (Neuentwicklung, Refactoring, Code-Review, Debugging, Architektur usw.) die passende Referenzdatei geladen. Dies hält den Kontext schlank und vermeidet unnötige Informationen. Das Skill definiert außerdem grundlegende Regeln: Korrektheit, Sicherheit und Benutzerabsicht haben Vorrang vor Stilpräferenzen; lokale Projektkonventionen (Formatter, Linter, Tests, Build-System) überschreiben die Standardregeln des Skills. Nur wenn kein systemisches Projektmuster existiert, wird auf `./references/standards.md` zurückgegriffen. Bei unklaren Regelentscheidungen kann auf das Beispielverzeichnis `./examples/` zugegriffen werden. Unterstützt werden Plattformen wie Claude Code, Cursor und Codex, die mit Referenzdateien und Markdown arbeiten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add AnthonyPoschen/agent-skills

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Codierung?

Verwenden Sie dieses Skill als Einstiegspunkt für Softwarearbeit. Behalten Sie diese Datei im Kontext und laden Sie dann den kleinsten relevanten Referenzsatz für die Aufgabe.

Weiterleitung

  • Zum Schreiben von neuem Code oder zum Erweitern von Verhalten lesen Sie ./references/implementation.md.
  • Für Refactoring, Bereinigung, Vereinfachung, Extraktion, Umstrukturierung oder Umschreibungsarbeiten lesen Sie ./references/refactoring.md.
  • Für Code-Review, PR-Review, Diff-Kritik oder Risikobewertung lesen Sie ./references/review.md.
  • Zum Debuggen, fehlgeschlagene Tests, Regressionen, Laufzeitfehler, CI-Fehler oder Fehlerbehebungen lesen Sie ./references/debugging.md.
  • Für Architektur, API-Design, Modulgrenzen, Abhängigkeitsrichtung oder reine Design-Diskussionen lesen Sie ./references/design.md.
  • Für gemeinsame Code-Qualitätsregeln lesen Sie ./references/standards.md, wann immer Sie Code schreiben oder ändern, und nach Bedarf während des Reviews/Designs.
  • Für die Assertionsstrategie (Invariantenprüfungen, Debug-vs-Production-Assert-Entscheidungen und Fail-Fast-Verträge) lesen Sie ./references/assertions.md, wenn Sie Code schreiben oder überprüfen, der interne Annahmen validiert.

Laden Sie nur die Referenzen, die für die aktuelle Anfrage des Benutzers erforderlich sind. Wenn die Aufgabe mehrere Phasen hat, laden Sie die nächste Referenz, wenn diese Phase beginnt.

Grundlegende Regeln

  • Korrektheit, Sicherheit und Benutzerabsicht haben Vorrang vor Stilpräferenzen.
  • Projekt-Formatter, Linter, Tests, Build-System, Framework-Konventionen und systemische lokale Muster haben Vorrang vor den Standardregeln dieses Skills.
  • Ein lokales Muster ist systemisch, wenn es in mehreren benachbarten Dateien vorkommt, durch Tooling erzwungen wird oder Teil einer klaren Framework-/Anwendungskonvention ist. Kopieren Sie keine einmaligen schwachen Code-Stücke, nur weil sie benachbart sind.
  • Wenn kein systemisches Projektmuster existiert, verwenden Sie ./references/standards.md.
  • Bewahren Sie öffentliches Verhalten, APIs, Datenverträge, Migrationen und operationelle Semantik, es sei denn, der Benutzer bittet explizit um deren Änderung.
  • Halten Sie Änderungen auf die Aufgabe beschränkt. Verbessern Sie den berührten Code genug für ein kohärentes Ergebnis, aber normalisieren Sie keinen unzusammenhängenden Legacy-Code.

Beispielsuche

Verwenden Sie Beispiele nur, wenn eine Regelentscheidung unklar ist.

  • ./examples/README.md indiziert fokussierte Beispiele.
  • Öffnen Sie immer nur eine passende Beispieldatei auf einmal.

Verwandte Skills