Verbessern
Pfade: ${CLAUDE_SKILL_DIR} bedeutet den Ordner, der diese SKILL.md enthält, und ${CLAUDE_SKILL_DIR}/../.. den .claude/-Ordner des Editors zwei Ebenen darüber.
Jede Frage an den Benutzer kommt in das Fragenfeld: rufen Sie das Tool AskUserQuestion auf (2–4 Optionen, die empfohlene zuerst). Nur in einem Agenten ohne dieses Tool fragen Sie nummeriert im Text.
Dies wird in einem Checkout des Repositorys ausgeführt, für die Person, die es wartet. Eine Korrektur hier erreicht jeden Benutzer bei dessen nächstem Update. S="${CLAUDE_SKILL_DIR}/scripts". Führen Sie die Skripte mit python3 auf Mac und Linux aus, mit py auf Windows.
0. Wer führt dies aus
python3 "$S/improve.py" mode
maintainer nur in einem Git-Checkout des Repositorys mit AI_EDITOR_MAINTAINER=1: fahren Sie mit Schritt 1 fort.
user: Die eigenen Dateien des Editors werden bei jedem Update ersetzt, daher niemals bearbeiten (keine SKILL.md, Referenz, kein Skript und keine PRINCIPLES.md). Sammeln und auswählen wie unten, dann jedes akzeptierte Objekt in der eigenen Benutzerebene speichern, die Updates niemals berühren (docs/customise.md im Repository): eine Einstellung mit taste.py add ... --set; eine Wortregel mit python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<regel>"; ein Caption-Look als custom/captions/<name>.json plus taste.py set captions.preset <name>; Vorlagen-Standards als custom/templates/<type>.json. Dann taste.py suggest anbieten, damit die Maintainer es für alle beheben können. Hier stoppen.
1. Sammeln
python3 "$S/improve.py" collect [--edits D] [--no-gh]
Eine Regel pro Zeile, die am häufigsten wiederholte zuerst: wie oft sie aufgetreten ist, woher (Vorschlag, Geschmacksregression, Vorschaukorrektur, Überprüfungshinweis, GitHub-Issue), der genannte Besitzer und bis zu drei Beispiele. Eine Regel, die von mehreren Benutzern genannt oder nach ihrer Anwendung erneut gemeldet wurde, kommt zuerst.
2. Auswählen
Zeigen Sie die Spitze der Warteschlange an und fragen Sie im Fragenfeld, welche jetzt behoben werden soll (Mehrfachauswahl, die am häufigsten wiederholte zuerst, empfohlen). Fragen Sie bei jeder auch, wenn sie unklar ist: Jeder Benutzer (Empfohlen) / Nur einige Künstlergruppen-Stile (gehört in ein style.json-Feld, nicht in eine Regel) / Keine Korrektur (schließen).
3. Jede einzeln beheben, in dieser Reihenfolge
- Die Regel. Eine Zeile in
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.mdunter der richtigen Überschrift, mit Nennung, wo sie durchgesetzt wird, und dieselbe Regel in der zuständigen SKILL.md oder Referenz. Allgemein, niemals über ein einzelnes Video: „Zooms gleichen über mindestens 0,5 s aus“, nicht „der Zoom bei 0:12 ruckelte“. - Die Durchsetzung. Der kleinste Code, der die Regel ohne Erinnerungsbedarf für jeden einhält: ein FAIL in einer Prüfung (
check.py,quality.py,product.py check,ai_tells.py), eine Verweigerung im Skript, das sie verletzen würde (gates.py), ein Default, der sie nicht erzeugen kann, oder eine Zeile intests/check_plugins.pyfür eine Repository-Regel. Bevorzugen Sie die Verschärfung einer bestehenden Prüfung gegenüber dem Hinzufügen einer neuen. - Der Test. Eine Assertion im
demo()dieses Skripts (oder intests/), erstellt aus einem kleinen synthetischen Beispiel des Fehlers. Vor der Korrektur ausführen und fehlschlagen sehen, dann nach der Korrektur ausführen und bestehen sehen. Eine Regel, die nur ein Agent befolgen kann (Fragen, Erklären), erhält stattdessen einen Eval-Fall inevals/:prompt.mdplus einentool_used- oderllm-Grader. - Die Aufzeichnung.
docs/feedback-matrix.md: die Regel, wo sie festgehalten ist, was sie durchsetzt, welche Tests sie hat.
4. Alles ausführen
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
Dann tests/demos.sh (Demo jedes Skripts), node tests/test_record.mjs, und wenn der Renderer eingerichtet ist, tests/smoke.py und tests/golden.py. Alles grün, bevor übergeben wird. Nicht committen; der Maintainer prüft den Diff und committed.
Bei einem GitHub-Issue, das jetzt behoben ist, anbieten, eine einzeilige Zusammenfassung der Korrektur zu kommentieren und das Issue zu schließen (gh issue close <n> --comment "..."), nur nach Rückfrage.
Niemals
- Niemals die taste.md, taste.json, rules.json oder suggestions.jsonl eines Benutzers bearbeiten: sie gehören dem Benutzer.
- Niemals personenbezogene Daten in das Repository aufnehmen: keine Namen, Benutzernamen, E-Mail-Adressen, Dateinamen oder Aufnahmen aus dem Feedback. Schreiben Sie die allgemeine Regel und ein synthetisches Beispiel.
tests/check_plugins.pyschlägt bei bekannten privaten Namen fehl; lesen Sie jedes Beispiel, bevor es aufgenommen wird. - Niemals den Kreislauf nur mit einer Notiz schließen. Eine Regel ohne Durchsetzung und Test ist nicht erledigt.
Dateien
scripts/improve.py:mode,collect,demo. Nur lesend.${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py: der<library>/custom/-Ordner des Benutzers (im Benutzermodus wird dort geschrieben).${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py: wosuggestundissuedie Benutzerseite schreiben.