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
- Klassifizieren Sie die Aufgabe.
- Legen Sie riskante Dateien in die Sicherheitshülle.
- Durchlaufen Sie die Triage-Leiter, bevor Sie Code schreiben.
- Legen Sie ein Patch-Budget fest.
- Bearbeiten Sie lokal und erhalten Sie den Stil.
- Verifizieren Sie das kleinste objektive Tor.
- 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:
- Entfernen Sie die Notwendigkeit: Kann die Anfrage durch Löschen, Konfigurieren oder Dokumentieren eines bestehenden Pfads erfüllt werden?
- Nutzen Sie Projektcode wieder: Helfer, Komponente, Hook, Validator, Test-Utility, Befehl, Schema oder etabliertes Muster.
- Verwenden Sie Sprach- oder Standardbibliotheksverhalten.
- Verwenden Sie Plattform- oder Framework-Verhalten: Browser-Steuerungen, CSS, Datenbank-Constraints, Framework-Routing, Validierung, Caching, Serialisierung oder Build-Tooling.
- Verwenden Sie eine bereits installierte Abhängigkeit.
- Fügen Sie eine kleine lokale Implementierung hinzu.
- 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.