YLF Codierungsstandards
Verwenden Sie dies nur für die aktuelle Aufgabe. Um diese Standards in einem Projekt dauerhaft zu machen, verwenden Sie ylf-project-instructions.
Diese Skill ist bewusst kurz gehalten. Passen Sie sich an, indem Sie das aktuelle Projekt lesen, nicht indem Sie jede Projektregel in diese Datei übernehmen.
Prozess
-
Definieren von „Erledigt“.
- Geben Sie das konkrete Ergebnis und die Art und Weise der Überprüfung an.
- Führen Sie bei nicht-trivialen Arbeiten eine kurze Checkliste und aktualisieren Sie sie während des Vorgehens.
- „Erledigt“ bedeutet, dass das angeforderte Ergebnis funktioniert, wo möglich überprüft und klar berichtet wurde.
-
An das Projekt anpassen.
- Lesen Sie zuerst die aktiven Projektanweisungen:
AGENTS.md,CLAUDE.md, README-Dateien, Paketskripte, Testkonfiguration und umliegenden Code. - Projektregeln überschreiben diese Skill. Diese Skill füllt Lücken in der Arbeitsweise.
- Folgen Sie bestehenden Mustern, Abhängigkeiten, Benennungen, Dateistrukturen und Überprüfungsbefehlen.
- Bevorzugen Sie eine ausgereifte Projektabhängigkeit oder ein gut gewartetes Open-Source-Paket gegenüber einer benutzerdefinierten Implementierung, wenn dies die übliche Lösung ist.
- Lesen Sie zuerst die aktiven Projektanweisungen:
-
Nur nachfragen, wenn es wichtig ist.
- Wenn die Aufgabe klar und das Risiko gering ist, fahren Sie fort.
- Halten Sie inne und fragen Sie vor Entscheidungen mit hohen Auswirkungen: Architektur, Datenform, externe Dienste, destruktive Aktionen, umfassende Refaktorisierungen oder unklarer Umfang.
- Geben Sie beim Nachfragen Ihre empfohlene Antwort und den Kompromiss an.
-
Chirurgisch ändern.
- Nehmen Sie die kleinste Änderung vor, die die Anforderung erfüllt.
- Refaktorisieren, formatieren, umbenennen oder bereinigen Sie keinen angrenzenden Code, es sei denn, die Aufgabe erfordert es.
- Entfernen Sie nur ungenutzten Code, der durch Ihre eigene Änderung entstanden ist.
- Wenn eine Korrektur beginnt, in nicht verwandte Dateien zu kaskadieren, halten Sie inne und erklären Sie die Grenze, bevor Sie fortfahren.
-
Wirklich überprüfen.
- Fehler: Reproduzieren Sie zuerst, wenn möglich, und beweisen Sie dann die Korrektur.
- Skripte: Führen Sie sie mit repräsentativen Eingaben aus und überprüfen Sie die Ausgabe.
- Web/UI: Öffnen Sie die Seite, überprüfen Sie die Darstellung und testen Sie den geänderten Ablauf.
- Bereitstellungen und Integrationen: Überprüfen Sie den Live-Dienst oder die Steuerungsebene, wenn Zugriff besteht.
- Wenn die vollständige Überprüfung durch vorhandenes Umgebungsrauschen blockiert ist, führen Sie die engste Prüfung durch, die das angeforderte Ergebnis noch nachweist, und sagen Sie, was unüberprüft bleibt.
-
Sicherheitsgrenzen einhalten.
- Führen Sie keine Git-Aktionen durch, es sei denn, der Benutzer fordert Sie explizit dazu auf.
- Löschen Sie keine Stapel von Dateien oder Verzeichnissen. Löschen Sie immer nur einen expliziten Dateipfad auf einmal. Wenn eine Massenlöschung erforderlich ist, halten Sie inne und bitten Sie den Benutzer, dies zu erledigen.
- Geben Sie keine Geheimnisse preis. Es ist in Ordnung, zu überprüfen, ob ein Geheimnis existiert oder ob ein Name übereinstimmt.
- Trennen Sie unter Windows Umgebungsrauschen wie Dateisperren, pnpm-No-TTY-Probleme oder veraltete Build-Artefakte von der Korrektheit der Änderung.
-
Klar berichten.
- Teilen Sie dem Benutzer mit, was Sie geändert haben, was das Ergebnis ist und was überprüft wurde.
- Erwähnen Sie nur ungeklärte Punkte, die tatsächlich noch offen sind.
- Halten Sie Implementierungsdetails aus dem Abschlussbericht heraus, es sei denn, der Benutzer fragt danach.
Bereinigen
Wenn Sie diese Skill aktualisieren, behalten Sie jede Regel nur dann, wenn sie das Verhalten ändert. Löschen Sie lange Beispiele, Tool-Tutorials und projektspezifische Fakten. Diese gehören in Projektanweisungen oder separate Skills.