Communitygithub.com

Agent Lean Safe Coding

Fenster-sicheres, schlankes Codierungs-Skill und Plugin-Paket für Codex, Claude Code und KI-Agenten.

Was ist Agent Lean Safe Coding?

Dieses Skill leitet KI-Codierungsagenten (unterstützt u.a. Codex und Claude Code) zu einer Disziplin an, die sowohl schlanke als auch sichere Änderungen fördert. Es bietet drei Betriebsmodi: "full" (Standard) für eine vollständige Triage-Leiter inklusive Windows- und Text-Sicherheitshülle, Abhängigkeitsprüfung, Patch-Budget und Verifikation; "lite" für schnelle Ersteinschätzung mit schmalem Kontext und minimalem Patch; sowie "audit" zur reinen Überprüfung ohne eigene Änderungen. Der Kernprozess besteht aus sieben Schritten: Klassifikation des Aufgaben typs, Anwendung einer Sicherheitshülle für Windows-Pfade und nicht-ASCII-Inhalte, Durchlaufen einer Wiederverwendungsleiter (vom Entfernen der Anforderung bis hin zum Vorschlag neuer Abhängigkeiten), Festlegen eines begrenzten Patch-Budgets, lokale Bearbeitung unter Erhalt des Stils, Verifikation mit dem engsten sinnvollen Test und abschließendem Bericht. Das Skill vermeidet Overengineering, bewahrt Zeilenenden und Zeichenkodierung und schützt vor riskanten Shell-Operationen – besonders wertvoll in gemischten Umgebungen mit Windows und textlastigen Repositories.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add AgentPilotLab/agent-lean-safe-coding

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Agent Lean Safe Coding?

Verwenden Sie dieses Skill, um Codierungsagenten sowohl schlanker als auch sicherer zu halten: Bauen Sie nur das benötigte Verhalten, nutzen Sie bereits Vorhandenes wieder und schützen Sie Windows-/textlastige Repositories vor fragilen Änderungen.

Standardmodus ist full.

  • lite: schnelle Ersteinschätzung, schmaler Kontext, kleinster sicherer Patch.
  • full: Triage-Leiter, Windows-/Text-Sicherheitshülle, Abhängigkeitsprüfung, Patch-Budget, Verifikation.
  • audit: keine Änderungen; Überprüfung eines Plans oder Diffs auf Overengineering, doppelte Logik, Abhängigkeitsrisiken, Windows-/Text-Risiken und schwache Verifikation.

Ausführungsschleife

  1. Klassifizieren Sie die Aufgabe.
  2. Legen Sie riskante Dateien in die Sicherheitshülle.
  3. Durchlaufen Sie die Triage-Leiter, bevor Sie Code schreiben.
  4. Legen Sie ein Patch-Budget fest.
  5. Bearbeiten Sie lokal und erhalten Sie den Stil.
  6. Verifizieren Sie das kleinste objektive Tor.
  7. Berichten Sie das Ergebnis mit Hinweisen zu Wiederverwendung und Risiken.

1. Klassifizieren

Benennen Sie den Aufgabentyp vor dem Bearbeiten:

  • bugfix: Finden Sie die gemeinsame Ursache; überprüfen Sie benachbarte Aufrufer, bevor Sie Guards verteilen.
  • feature: Prüfen Sie, ob das angeforderte Verhalten bereits von der Plattform, dem Framework oder dem Repository bereitgestellt wird.
  • refactor: Fordern Sie eine konkrete Vereinfachung oder Risikoreduzierung; vermeiden Sie Umstellungen aus Geschmacksgründen.
  • review: Weisen Sie auf Löschungen, Wiederverwendungsmöglichkeiten, unsichere Shell-/Textoperationen und fehlende Prüfungen hin.
  • docs/text: Schützen Sie Kodierung, Zeilenenden, Markdown-Struktur und Beispiele.

Wenn die Anfrage unklar ist, aber eine konservative Voreinstellung sicher ist, fahren Sie mit dieser Voreinstellung fort und geben Sie die Annahme kurz an.

2. Sicherheitshülle

Verwenden Sie die Sicherheitshülle, wenn eines dieser Elemente vorhanden ist: Windows-Pfade, PowerShell oder cmd, nicht-ASCII-Text, chinesischer Text, Emojis, Markdown, Prompts, Vorlagen, Lokalisierungsdateien, exakte Ersetzungen, unsichere Kodierung, CRLF/LF-empfindliche Dateien oder generierte Ausgaben, die mit Quellcode verwechselt werden könnten.

Innerhalb der Hülle:

  • Bevorzugen Sie Patch-Werkzeuge für kleine Änderungen.
  • Vermeiden Sie die Übergabe von nicht-ASCII-Inhalten über Shell-Pipelines oder Inline-PowerShell-Strings.
  • Erhalten Sie den vorhandenen Zeilenumbruch-Stil, es sei denn, ein Formatierer besitzt die Datei.
  • Verwenden Sie Pfad-APIs oder zitierte Literalpfade für Skripte.
  • Behandeln Sie Konsolen-Mojibake nur als Anzeigebeweis; überprüfen Sie Bytes oder UTF-8-Lesevorgänge vor dem Überschreiben.
  • Bearbeiten Sie keine generierten Ordner, Abhängigkeitsordner, Caches, Binärdateien, Screenshots oder Archive, es sei denn, der Benutzer bittet ausdrücklich darum.

Lesen Sie references/windows-text-safety.md nur, wenn eine Aufgabe ein Risiko für Kodierung, Zeilenumbrüche, Pfade oder Shell-Fragilität birgt.

3. Triage-Leiter

Bevor Sie benutzerdefinierten Code schreiben, halten Sie auf der ersten Ebene an, die die Aufgabe sauber löst:

  1. Entfernen Sie die Notwendigkeit: Kann die Anfrage durch Löschen, Konfigurieren oder Dokumentieren eines bestehenden Pfads erfüllt werden?
  2. Nutzen Sie Projektcode wieder: Helfer, Komponente, Hook, Validator, Test-Utility, Befehl, Schema oder etabliertes Muster.
  3. Verwenden Sie Sprach- oder Standardbibliotheksverhalten.
  4. Verwenden Sie Plattform- oder Framework-Verhalten: Browser-Steuerungen, CSS, Datenbank-Constraints, Framework-Routing, Validierung, Caching, Serialisierung oder Build-Tooling.
  5. Verwenden Sie eine bereits installierte Abhängigkeit.
  6. Fügen Sie eine kleine lokale Implementierung hinzu.
  7. Schlagen Sie eine neue Abhängigkeit oder größere Implementierung nur mit klarem Grund, Risiko und Genehmigungsbedarf vor.

Fügen Sie niemals automatisch eine Produktionsabhängigkeit hinzu. Wenn eine neue Abhängigkeit gerechtfertigt erscheint, erklären Sie, was sie ersetzt, warum installierte Optionen nicht passen, das Wartungsrisiko und den genauen Installationsbefehl.

Lesen Sie references/reuse-ladder.md nur, wenn die Entscheidung über Abhängigkeit/Wiederverwendung nicht offensichtlich ist.

4. Patch-Budget

Legen Sie vor dem Bearbeiten ein kleines Budget fest:

  • Dateien, die voraussichtlich geändert werden.
  • Dateien, die absichtlich in Ruhe gelassen werden.
  • Vorhandener Code oder Plattformfunktion zur Wiederverwendung.
  • Minimaler Verifikationsbefehl oder Grund, warum kein Befehl sinnvoll ist.

Bevorzugen Sie weniger Dateien, weniger Abstraktionen und direkte Änderungen nahe am Verhalten. Fügen Sie keine Schnittstellen, Fabriken, Dienstschichten, Konfigurationsschalter, zukünftige Erweiterungspunkte oder Wrapper hinzu, es sei denn, die aktuelle Aufgabe benötigt sie.

5. Patch-Regeln

  • Beheben Sie den Stammpfad einmal, anstatt wiederholt Workarounds auf der Aufruferseite zu platzieren.
  • Löschen Sie redundanten Code, wenn das Verhalten korrekt bleibt.
  • Halten Sie Formatierungsänderungen aus dem Diff heraus.
  • Halten Sie Kommentare selten; verwenden Sie nur einen prägnanten Kommentar, wenn eine beabsichtigte Grenze später sichtbar sein muss.
  • Wenn eine Abkürzung eine bekannte Obergrenze hat, nennen Sie die Obergrenze und das Upgrade-Auslöser in diesem Kommentar.
  • Machen Sie aus einer kleinen Funktion kein Subsystem.

6. Verifikation

Führen Sie das engste frische Tor aus, das die Änderung nachweist:

  • Vorhandener Test für das betroffene Verhalten.
  • Fokussierter Unit-Test oder Selbstprüfung für nicht triviale neue Logik.
  • Syntax-/Typ-/Lint-Prüfung für bearbeitete Sprachdateien, wenn Tests nicht verfügbar sind.
  • Diff-Review für reine Dokumentation oder triviale Einzeiler-Änderungen.

Nicht triviale Verzweigungen, Parser, Geld-/Sicherheitspfade oder Datenverlustpfade benötigen nach Möglichkeit eine ausführbare Prüfung. Triviale Einzeiler benötigen kein neues Test-Gerüst.

7. Abschlussbericht

Halten Sie den Abschlussbericht kurz:

Geändert - ...
Triage - wiederverwendet/stdlib/Plattform/installierte Abhängigkeit/lokaler Code/neuer Abhängigkeitsvorschlag
Sicherheit - Windows-/Text-Risiken behandelt oder nicht relevant
Verifiziert - Befehl/Ergebnis oder Grund
Risiken - verbleibende Grenze, falls vorhanden

Geben Sie für den Modus audit zuerst die Ergebnisse mit Datei-/Zeilenverweisen zurück, wenn verfügbar, dann eine Lösch-/Wiederverwendungsliste und die kleinste Verifikationslücke.

Verwandte Skills