Tune-Fertigkeit
Feinabstimmung ist eine Reihe kleiner, belegter Bearbeitungen einer bereits bestehenden Fertigkeit – keine Neuschreibung. Ziel ist eine Fertigkeit, die bei den richtigen Anfragen auslöst, ihren Geschwistern nicht in die Quere kommt und Arbeit in einer definierten Form weitergibt.
Grundregeln
- Lies zuerst die echte SKILL.md. READMEs, Repo-Beschreibungen und Auflistungen weichen von der Datei ab, die der Agent tatsächlich lädt. Jede Behauptung über eine Fertigkeit muss aus ihrer SKILL.md oder ihren Referenzen stammen. Wenn du keine Datei öffnen kannst, nenne sie und sage, was du stattdessen annimmst.
- Überprüfe deine eigenen Behauptungen. Wenn eine später gelesene Datei etwas früher Gesagtem widerspricht, sage das klar und korrigiere es. Umgehe es nicht stillschweigend.
- Minimale Bearbeitungen, die Stimme des Autors. Ändere nur, was das Audit gefunden hat, und sonst nichts. Behalte Frontmatter-Schlüssel, die du nicht erkennst (
version,argument-hint,user-invocable). Schwäche niemals Ehrlichkeits-, Sicherheits- oder Datenschutzregeln. - Behaupte nicht, was du nicht ausgeführt hast. Sage, welche Prüfungen gelaufen sind, welche Testfälle nur geschrieben wurden und welche Dateien du nie gesehen hast.
Arbeitsablauf
1. Sammeln
Hole die SKILL.md der Zielfertigkeit und jeder Geschwisterfertigkeit, die sie berührt, sowie alle erreichbaren Referenzen. Wenn der Benutzer einen Link angibt, den du nicht öffnen kannst, frage nach dem Dateitext oder der URL. Wenn die Fertigkeit ein Ordner auf der Festplatte ist, führe das Prüfskript (Schritt 6) jetzt für eine erste Lesung aus.
2. Kartieren
Erstelle eine kurze Inventarliste pro Fertigkeit: was ihre Beschreibung verspricht, ihre Modi oder Befehle, die referenzierten Dateien und was sie an wen übergibt. Setze Geschwisterbeschreibungen und Befehlslisten nebeneinander. Überschneidungen zeigen sich nur, wenn du beide sehen kannst.
3. Auditieren
Arbeite references/audit-checklist.md durch. Notiere für jeden Befund den Beleg (zitiere die Zeile), die Schwere (bricht Auslösung, verwirrend oder kosmetisch) und die kleinste Korrektur. Melde die schwerwiegendsten zuerst.
4. Grenzen festlegen
Wenn zwei Fertigkeiten dieselbe Anfrage beanspruchen, gib ihr einen Besitzer. Verwende die Aufteilung, die das eigene Design des Benutzers bereits nutzt (z. B. Urteil versus Artefakt: eine Fertigkeit beurteilt, die andere schreibt). Frage den Benutzer nur, wenn sein Design es nicht klärt, und frage einmal.
5. Bearbeiten
Nimm die kleinste Änderung vor, die jeden Befund behebt. Wenn der Benutzer das Ergebnis direkt in ein Repository einfügen wird, gib ganze Ersatzdateien zurück und kopiere unveränderten Text exakt. Wenn eine Korrektur ein neues gemeinsames Stück benötigt (etwa ein Übergabeformat), füge eine neue Referenzdatei hinzu, anstatt eine zu bearbeiten, die du nicht gesehen hast. Liste alle Referenzdateien auf, die wahrscheinlich eine entsprechende Aktualisierung benötigen.
6. Validieren
Führe das Prüfskript in jedem Fertigungsordner aus:
python scripts/check_skill.py <pfad-zum-fertigungsordner>
Es prüft, ob der Name dem Ordner entspricht, die Beschreibung das 1024-Zeichen-Limit einhält und Auslöse- und Grenzformulierungen enthält, die H1 dem Namen entspricht, referenzierte Dateien existieren und der Textkörper eine angemessene Länge hat. Behebe jedes FAIL. Bewerte jedes WARN. Wenn du nur eingefügten Text hast, speichere die SKILL.md in einem nach der Fertigkeit benannten Ordner und führe sie dort aus; Warnungen zu fehlenden Referenzen sind in diesem Fall zu erwarten.
7. Testfälle schreiben
Folge references/test-cases.md. Jede von dir geänderte Grenze bekommt einen Fall auf jeder Seite. Führe sie manuell anhand der Beschreibungen aus. Manche Agenten liefern in ihren Authoring-Tools eine automatisierte Auslöseschleife; wenn du keine ausgeführt hast, behaupte nicht, dass du es getan hast. Sage, welche du ausgeführt hast.
8. Berichten
Halte es kurz:
- Was sich geändert hat, pro Fertigkeit, und warum (eine Zeile pro Änderung).
- Korrekturen zu allem, was du früher gesagt hast.
- Was du nicht sehen oder nicht ausführen konntest.
- Ein nächster Schritt.
Beginne mit den Änderungen, nicht mit dem Prozess.