Was macht auto-improve?
Autonoms, bewertungsgesteuerte Selbstverbesserung für jedes Textartefakt. Siehe README.md für die vollständige Anleitung; dies ist die agentenorientierte Kurzreferenz.
Wann verwenden
Der Benutzer möchte etwas messbar Besseres, nicht nur Umgeschriebenes — und ist bereit, „besser" als Rubrik zu formulieren. Gute Beispiele: Kaltakquise-E-Mails, Landing-Texte, Prompts, Skill-Definitionen, Blogbeiträge, Anschreiben, Dokumentationen, Verträge, Menüs.
Ausführen
export GEMINI_API_KEY=... # https://aistudio.google.com/apikey
python3 improve.py \
--artifact path/to/file.md \ # muss sich in einem Git-Repo befinden
--tag v1 \ # → Branch improve/v1, results/v1.tsv
--max-iterations 8 \
--criteria path/to/rubric.md # OPTIONAL — weglassen, um eine Rubrik automatisch abzuleiten; oder hinzufügen
# --goal "was gut ist" zur Steuerung der abgeleiteten Rubrik
Wenn Sie --criteria nicht übergeben, schreibt auto-improve zuerst eine Rubrik aus dem Artefakt und
speichert sie unter results/<tag>.rubric.md — lesen Sie sie, um zu sehen, worauf optimiert wird.
Überprüfen Sie einen abgeschlossenen Lauf: python3 improve.py --status --tag v1.
Das Ergebnis befindet sich auf dem Git-Branch improve/<tag> — git diff main improve/v1 -- <datei>.
Wie es entscheidet (der Anti-Schludrigkeits-Teil)
- Mutieren — Best-of-N Kandidatenbearbeitungen, angewendet als chirurgische Diffs (absturzsicher).
- Bewerten — Jeder Kandidat wird anhand der Rubrik von einem separaten Modellaufruf benotet.
- Entscheiden — Der beste Kandidat wird paarweise gegen den Champion bewertet (beide Reihenfolgen, verzerrungsbereinigt); nur behalten, wenn er wirklich gewinnt, sonst rückgängig gemacht.
Der Mutator bewertet niemals seine eigene Arbeit, und selbstbewusste, aber schlechtere Umschreibungen werden verworfen — so ist der Aufstieg real und jeder Commit ein bestätigter Gewinn.
Die Rubrik schreiben
Eine Markdown-Datei mit gewichteten Dimensionen, die in der Summe 100 ergeben — verankert
(50/70/90), belohnungsorientiert, spezifisch. Siehe criteria/README.md und die
Arbeitsbeispiele in criteria/.
Schlüsselregeln
- Der Mutator und der Evaluator teilen niemals den Kontext.
- Ein Artefakt, eine Rubrik, ein
--tagpro Lauf. - Der Git-Branch ist die Quelle der Wahrheit;
results/<tag>.tsvist das Aufstiegsprotokoll (nicht versioniert). - Niemals außerhalb des Artefakts bearbeiten; kleine chirurgische Diffs, keine vollständigen Umschreibungen.