Selbstüberprüfung vor dem Landen
Bevor Sie signifikante Änderungen committen, gehen Sie diese Checkliste durch. Entdecken Sie Probleme, bevor die CI sie entdeckt – oder schlimmer noch, bevor Benutzer sie entdecken.
Wann verwenden
Führen Sie diesen Skill aus, wenn eines dieser Kriterien zutrifft:
- Mehr als 100 Codezeilen geändert
- Mehr als 5 Dateien modifiziert
- Kerninfrastruktur berührt (Executor, Storage, Haupt-Dispatch-Schleifen)
- Neue Abstraktionen oder öffentliche APIs eingeführt
- Unsicherheit über Randfälle oder Entwurfsentscheidungen
Schnellprüfung:
git diff --stat HEAD | tail -5 # Wie viel wurde geändert?
git diff --name-only HEAD | wc -l # Wie viele Dateien?
Überspringen, wenn
- Triviale Änderung (≤50 Zeilen, ≤3 Dateien)
- Reine Dokumentations- oder Lektionsaktualisierungen
- Reine Teständerungen (Tests sind ihre eigene Überprüfung)
- Einfacher Einzeiler-Bugfix mit offensichtlichem, begrenztem Umfang
- Mechanisches Refactoring ohne Logikänderungen
Die Checkliste
1. Randfälle
- [ ] Null/leere Eingaben behandelt?
- [ ] Grenzbedingungen getestet (Off-by-one, leere Listen, Null)?
- [ ] Gleichzeitiger Zugriff oder Race-Conditions bedacht?
- [ ] Unicode/Kodierungsprobleme bei Textverarbeitung?
2. Fehlerpfade
- [ ] Alle Ausnahmen auf der richtigen Ebene abgefangen (nicht zu breit)?
- [ ] Fehlermeldungen informativ (was ist fehlgeschlagen, warum, was tun)?
- [ ] Fehlermodi scheitern elegant, nicht still?
- [ ] Keine bloßen `except:` oder verschluckten Fehler?
3. Testabdeckung
- [ ] Kritische Pfade haben Tests?
- [ ] Oben identifizierte Randfälle haben Tests?
- [ ] Tests laufen tatsächlich und bestehen?
- [ ] Keine Test-Stubs mit `pass` oder `...` hinterlassen?
4. Dokumentation
- [ ] Docstrings/Kommentare entsprechen dem aktuellen Verhalten?
- [ ] README aktualisiert, wenn sich die öffentliche Schnittstelle geändert hat?
- [ ] Commit-Nachricht erfasst, was geändert wurde und warum?
- [ ] Relevante Architekturdokumentation noch korrekt?
5. Codequalität
- [ ] Benennung ist klar und konsistent mit umgebendem Code?
- [ ] Keine offensichtlichen Code-Gerüche (God Functions, magische Zahlen, hartcodierte Pfade)?
- [ ] Befolgt bestehende Muster in der Datei/im Paket?
- [ ] Statische Analyse / Typecheck bestanden?
Einzeiler-Smoke-Test
# Vor dem Commit ausführen (an Ihren Stack anpassen):
make format && make typecheck && pytest -x -q && echo "✅ Sauber zum Landen"
Wenn ein Schritt fehlschlägt, beheben Sie ihn vor dem Commit. Liefern Sie kein Rot aus.
Anti-Patterns
| Anti-Pattern | Lösung |
|---|---|
| "CI wird es schon fangen" | CI ist der letzte Ausweg, kein Ersatz für Ihr eigenes Urteilsvermögen. Fangen Sie es zuerst. |
| "Ich füge Tests später hinzu" | Später kommt nicht. Schreiben Sie den Test jetzt oder akzeptieren Sie die Lücke dauerhaft. |
| „Es hat bei manuellem Test funktioniert“ | Manuelle Tests sind nicht reproduzierbar. Schreiben Sie einen automatisierten Test, damit zukünftige Sitzungen ihn ebenfalls überprüfen können. |
| „Die Fehlermeldung ist ein TODO“ | TODO-Fehlermeldungen werden als TODO-Fehlermeldungen ausgeliefert. Schreiben Sie die echte Meldung jetzt. |
| „Ich sehe anhand des Codes, dass dieser Fall behandelt wird“ | Wenn es nicht getestet ist, wird eine zukünftige Refaktorierung es unsichtbar brechen. |
Warum das wichtig ist
Autonome Agenten sind darauf trainiert, Outputs zu produzieren, die gut genug sind, um Korrekturen zu vermeiden. Ohne ein strukturiertes Review-Tor umgehen autonome Code-Commits die Human-in-the-Loop-Prüfung, die normalerweise Regressionen und Randfälle abfängt. Dieser Skill fungiert als dieses Tor – fünf gezielte Linsen in Folge, sodass nichts Offensichtliches durchrutscht.
Der Nutzen summiert sich: Jeder Review-Durchlauf, der ein echtes Problem findet, spart einen CI-Roundtrip, vermeidet einen Benutzerfehler und eine nicht benötigte Revert-PR.
Verwandt
- Self-Push Skill – Qualitäts-/Faulheitsprüfung, die diese strukturelle Überprüfung ergänzt
- Multi-Lens Review Skill – tiefere parallele Überprüfung für risikoreiche Änderungen