CommunitySchreiben & Editierengithub.com

yshmr/claude-code-goal-draft-policy

Ein Skill zum Erstellen, Bearbeiten und Reparieren von `/goal`-Abschlussbedingungen für Claude Code, basierend auf der offiziellen Dokumentation mit Herkunftskennzeichnung (MIT-Lizenz).

Was ist claude-code-goal-draft-policy?

Dieser Skill bietet eine fundierte Methode zur Formulierung präziser `/goal`-Bedingungen für Claude Code, die sicherstellen, dass der eingebaute Evaluator (standardmäßig Haiku) den Abschluss korrekt und zuverlässig beurteilen kann. Er basiert auf der offiziellen Dokumentation von Anthropic und erweitert diese um eine strukturierte 5-Elemente-Architektur (Endzustand, Beweisaktion, Evidenzsignal, Leitplanke, Stoppklausel), die speziell für die Einschränkungen eines reinen Transkript-Evaluators optimiert ist. Der Skill klärt, dass der Evaluator keine Tools ausführen kann, und leitet daraus ab, dass alle Beweise im Gesprächsverlauf sichtbar sein müssen. Er enthält detaillierte Arbeitsabläufe für die Umsetzung von Benutzeranfragen in messbare Bedingungen, eine Vorlage für den Kopier-/Einfügevorgang und einen Prüf-/Reparaturmodus für bestehende Ziele. Unterstützte Plattformen umfassen Claude Code v2.1.139+. Die klare Herkunftskennzeichnung ([official], [method], [inference], [tested]) ermöglicht es Entwicklern, die Vertrauenswürdigkeit jedes Ratschlagsteils einzuschätzen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add yshmr/claude-code-goal-draft-policy

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Effektive /goal-Bedingungen erstellen

Grundwahrheit: die offizielle Dokumentation

Dieser Skill basiert auf der offiziellen /goal-Dokumentation von Claude Code, zusammengefasst in references/official-goal-reference.md (Quelle: https://code.claude.com/docs/en/goal). Lesen Sie diese Datei zuerst, wenn Sie genaues Verhalten benötigen – Versionsanforderung (v2.1.139+), Funktionsweise des Evaluators, die /goal-/ /goal clear-/Status-Unterbefehle, Wiederaufnahmeverhalten und wann /goal nicht verfügbar ist. Alles unten ist die Erstellungsmethode, die auf diesen Fakten aufbaut; falls die beiden jemals widersprechen, hat die Referenz (und ein frischer Abruf der URL) Vorrang.

Die offizielle Anleitung für eine gute Bedingung nennt drei Dinge: einen messbaren Endzustand, eine angegebene Prüfung (wie Claude sie beweist) und relevante Einschränkungen. Die 5-Elemente-Struktur in diesem Skill sind diese drei, operationalisiert – sie teilt die „angegebene Prüfung“ in den Befehl und das Evidenzsignal auf, damit der rein textbasierte Evaluator etwas Konkretes zu lesen hat, und fügt eine explizite Stoppklausel hinzu, da die Dokumentation empfiehlt, ein Ziel mit einer Zug-/Zeitklausel zu begrenzen.

Herkunftskennzeichnungen

Es gibt keinen offiziellen Anthropic-Skill zum Erstellen von /goal-Bedingungen – das einzige offizielle Material ist die obige Dokumentation. Daher mischt dieser Skill dokumentierte Fakten mit einer synthetisierten Methode. Jeder Abschnitt ist gekennzeichnet, damit Sie wissen, wie sehr Sie ihm vertrauen können:

  • [official] – in der Dokumentation / references/official-goal-reference.md angegeben. Darauf kann man sich verlassen.
  • [method] – Synthese dieses Skills, basierend auf offiziellen Fakten, aber selbst nicht offiziell. Sinnvolle Praxis, aber eine Konvention, keine Regel von Anthropic.
  • [inference] – eine plausible Ableitung aus offiziellen Fakten, die die Dokumentation nicht bestätigt. Verwenden Sie es, aber halten Sie es locker; wenn das Verhalten widerspricht, glauben Sie dem Verhalten.
  • [tested] – eine Behauptung, die durch ein kleines Experiment in references/evaluator-behavior-tests.md überprüft wurde. Stärker als [inference], aber nicht offiziell; der Test verwendet einen rekonstruierten Evaluator und kleine Stichproben, ist also ein starker Hinweis, kein Beweis.

Wofür dieser Skill gedacht ist

/goal <bedingung> versetzt Claude in eine autonome Schleife: Nach jedem Zug liest ein kleiner, schneller Evaluator (standardmäßig Haiku) die Bedingung plus die gesamte Unterhaltung und entscheidet ja/nein. „Nein“ startet einen weiteren Zug; „Ja“ löscht das Ziel.

Ihre Aufgabe ist es, eine grobe Absicht („mach weiter, bis die Tests bestehen“) in eine Bedingung zu verwandeln, die der Evaluator korrekt und nur dann, wenn sie tatsächlich wahr ist, beurteilen kann. Eine vage Bedingung wird entweder nie abgeschlossen (verbraucht Züge) oder schließt fälschlicherweise ab (Claude behauptet Sieg und der Evaluator glaubt es). Beides verschwendet Zeit und Geld des Benutzers, daher kommt es auf die Formulierung wirklich an.

Die eine Einschränkung, die alles antreibt

Der Evaluator führt keine Tools aus — [official]. Er kann keine Tests ausführen, Dateien lesen oder Git überprüfen; er beurteilt nur, was bereits als Text in der Unterhaltung aufgetaucht ist. Drei Konsequenzen folgen daraus:

  1. Aus dem Transkript überprüfbar — [official]. Die Dokumentation besagt, dass die Prüfung etwas sein muss, das „Claudes eigene Ausgabe demonstrieren kann“. Der Beweis muss auf dem Bildschirm erscheinen – die Ausgabe eines Befehls, eine grep-Zählung, ein Exit-Code. Wenn ein Mensch die Bedingung nicht durch Lesen des Transkripts bestätigen könnte, kann es der Evaluator auch nicht.
  2. Jedes Mal frische Beweise liefern — [tested]. Wir haben die naheliegende Sorge untersucht – dass ein in einem frühen Zug gedruckter Erfolg erneut gezählt wird und das Ziel fälschlicherweise abschließt – und das ist nicht passiert: Bei Tests, die vor einer späteren, nicht verifizierten Änderung bestanden haben, gab der Evaluator in 4/4 Stichproben „nein“ zurück und stellte jedes Mal fest, dass das Bestehen vor der Änderung lag (siehe references/evaluator-behavior-tests.md). Der Evaluator verfolgt die Aktualität selbst. Die eigentliche Konsequenz ist das Spiegelbild: Wenn Claude die Prüfung nach einer Änderung nicht im aktuellen Zug wiederholt, weigert sich der Evaluator (korrekt), abzuschließen, und die Schleife bleibt stecken. Formulieren Sie den Beweis also als etwas, das Claude in jedem Zug neu erzeugt („führe im letzten Zug X aus …“) – eine Anweisung, damit frische Beweise fließen, keine Versicherung gegen einen Neuberechnungsfehler.
  3. Keine subjektiven Kriterien — [official]. Die Dokumentation warnt vor Bedingungen, bei denen es „keinen Punkt gibt, an dem ‚unordentlich‘ objektiv ‚sauber‘ wird“. Ersetzen Sie „funktioniert“, „sauber“, „sieht gut aus“, „schnell“ durch eine operative Definition: einen Exit-Code, eine Zählung, einen bestimmten String in der Ausgabe.

Die 5-Elemente-Struktur — [method]

Diese Struktur ist das eigene Framework dieses Skills (siehe Herkunftshinweis): Sie erweitert die offizielle dreiteilige Anleitung, damit ein rein textbasierter Evaluator etwas Konkretes zu lesen hat. Setzen Sie jede Bedingung aus diesen Teilen zusammen. Nicht alle werden immer benötigt, aber Endzustand + Beweis + Evidenz sind obligatorisch – sie machen die Bedingung beurteilbar.

#ElementFrage, die es beantwortetBeispiel-Fragment
1EndzustandWas ist wahr, wenn fertig?„jeder Test in tests/auth besteht“
2BeweisaktionWelchen Befehl muss Claude ausführen?„führe pytest tests/auth -q aus“
3EvidenzsignalWas muss in der Ausgabe erscheinen?„die letzte Zeile zeigt 0 failed“
4LeitplankeWas darf sich auf dem Weg nicht ändern?„ändere oder lösche keine Datei unter tests/“
5StoppklauselWann aufgeben?„stoppe nach 15 Zügen oder wenn derselbe Fehler zweimal wiederholt wird – fasse dann zusammen, was blockiert“

Die Elemente 1–3 machen es beurteilbar, 4 schützt die Qualität, 5 schützt vor Durchgehen wenn das Ziel unmöglich ist. Fügen Sie immer eine Stoppklausel hinzu: Der Evaluator hat keine andere Bremse.

Wie die Umwandlung funktioniert — [method]

Die Umwandlung einer groben Anfrage in eine Bedingung ist ein Mapping: Jeder Slot hat eine Ableitungsregel, die Sie auf die Worte des Benutzers plus das Repository anwenden. Der Abschnitt Workflow unten ist die Ausführungscheckliste; dieser Abschnitt ist die Begründung hinter jedem Slot, damit Sie jedes Mal die gleiche Qualität produzieren, anstatt den Satz des Benutzers zu paraphrasieren. Wenden Sie die Regeln der Reihe nach an.

Ableitungsregeln pro Slot

  • ① Endzustand ← die Absicht des Benutzers, befördert zu einem beobachtbaren Zustand. Nehmen Sie das Verb/Objekt der Anfrage und formulieren Sie es als etwas Wahr-oder-Falsch um. „Auth reparieren“ beschreibt eine Aktion, keine Ziellinie – befördern Sie es zu „jeder Test in tests/auth besteht“. Wenn ein subjektives Wort auftaucht („sauber“, „klein“, „schnell“), ersetzen Sie es hier durch eine Zahl oder einen booleschen Wert: sauber→„0 Lint-Warnungen“, klein→„jede Datei ≤ 300 Zeilen“. Wenn Sie es nicht messbar machen können, stoppen Sie und stellen Sie dem Benutzer eine gezielte Frage, anstatt zu raten (siehe Verzweigung unten).

  • ② Beweisbefehl ← durchsuchen Sie das Repository nach einem Befehl, der tatsächlich existiert. Dies ist der tragende Schritt: Eine Bedingung, die einen Befehl nennt, den das Projekt nicht hat, wird nie abgeschlossen. Lösen Sie ihn aus dem Repository auf, nicht aus Gewohnheit (der Workflow Schritt 2 listet auf, wo Sie suchen müssen – Paketskripte, pyproject/Makefile, Cargo/Go und CI-Konfiguration als das Maß für „was grün bedeutet“). Wählen Sie den Befehl, dessen Ausgabe jedes Mal ein stabiles, greppbares Signal trägt.

  • ③ Evidenzsignal ← die konkrete Ausgabe, die dieser Befehl bei Erfolg emittiert. Lesen Sie es aus dem Befehlstyp mit der folgenden Tabelle ab. Bevorzugen Sie ein Signal, das eine gesprächige Zusammenfassung nicht vortäuschen kann – ein tatsächlich eingefügter Befehlsschwanz ist besser als „Ich habe bestätigt, dass es besteht“.

    BefehlstypErfolgssignal, das im Transkript erforderlich ist
    Test-Runner (pytest/jest/go test/…)die Zusammenfassungszeile zeigt 0 failed (oder die Anzahl der Bestehenden)
    Build / Typprüfungexit code 0 und null Fehler in der Ausgabe
    Linter0 problems / 0 errors
    grep / rg (Abwesenheitsprüfung)eine gedruckte Anzahl von 0 (z.B. die Trefferliste durch wc -l leiten) – bloßes rg gibt bei null Treffern nichts aus, und leere Ausgabe ist ein schwaches Signal
    Git-Sauberkeitgit status --short gibt nichts aus
    Warteschlange / Backlogder Auflistungsbefehl gibt eine leere Liste aus
  • ④ Leitplanke ← was der Aufgabentyp impliziert, dass sich nicht ändern darf. Auch ohne explizite Angabe aus dem Kontext ableiten: Aufgaben, die Tests ändern → „Testdateien nicht bearbeiten“ (damit Claude Tests nicht durch Abschwächen „bestehen“ kann); Refactorings → „öffentliche Exporte unverändert“; Migrationen → „unzusammenhängende Module oder Abhängigkeiten nicht anfassen“. Wo es günstig ist, machen Sie die Leitplanke selbst überprüfbar („git diff --stat berührt nur src/x/“).

  • ⑤ Stoppklausel ← eine Standardbegrenzung plus ein Auslöser für Stillstand. Fügen Sie immer eine Zugbegrenzung hinzu; fügen Sie einen Stillstandsdetektor hinzu, wenn die Aufgabe stecken bleiben kann („derselbe Fehler zweimal“, „Testanzahl verbessert sich nicht für 2 Züge“), und weisen Sie Claude an, den Blocker beim Stopp zusammenzufassen, damit der Benutzer den Grund erfährt.

Der aktuellster-Zug-Anker — [tested]

Nach dem Ausfüllen von ② und ③ formulieren Sie diese als „führe im aktuellsten Zug X aus und zeige …“. Wir haben dies zuerst hinzugefügt, um zu verhindern, dass ein alter Erfolg erneut gezählt wird, aber eine Untersuchung (references/evaluator-behavior-tests.md) zeigte, dass der Evaluator bereits dagegen schützt – er möchte einen Beweis, der nach der letzten Änderung datiert. Die eigentliche Aufgabe des Ankers ist also das Gegenteil: Er hält Claude dazu an, jedes Mal frische Beweise zu produzieren, damit die Schleife endet, anstatt mit „du hast Code geändert, aber nicht erneut verifiziert“ stecken zu bleiben. Behalten Sie ihn – er ist günstig und richtet Claude nach dem aus, was der Evaluator tatsächlich verlangt. Eine verbleibende Lücke, die die Untersuchung nicht geschlossen hat: Ein Durchlauf über eine Teilmenge von Tests, die später als „alle bestanden“ beschrieben wird, könnte immer noch durchrutschen. Verankern Sie daher den Umfang in ① (z.B. den genauen Pfad oder „die vollständige Suite“ nennen).

Ausgearbeitete Spur

Eingabe (roher Benutzersatz):

„utils.ts ist zu groß geworden – teile es auf und halte jede Datei klein.“

SchrittAngewandte RegelErgebnis
①„klein“ zu einer Zahl befördern (ein Budget bestätigen/annehmen)„jede .ts unter src/ ≤ 300 Zeilen“
②kein externer Befehl nötig; eine Zeilenanzahl-Auflistung ist selbsterklärendzeige eine wc -l-artige Auflistung von Dateien über dem Budget
③Erfolg = nichts über Budgetdie Auflistung ist leer
④Aufteilen bricht leicht die öffentliche API„halte die Exporte in src/index.ts unverändert“
⑤Standard-Zugbegrenzung„stoppe nach 20 Zügen“
Ankeraktuellster-Zug-Klausel einfügen„zeige jeden Zug …“

Ausgabe (bereit zum Einfügen):

/goal Keine .ts-Datei unter src/ überschreitet 300 Zeilen. Beweise es, indem du in jedem aktuellsten Zug eine Zeilenanzahl-Auflistung von Dateien über dem Budget zeigst (leer, wenn fertig). Halte die Exporte in src/index.ts unverändert. Stoppe nach 20 Zügen.

Verzweigung bei mehrdeutiger Eingabe

  • ① lässt sich nicht auf etwas Messbares reduzieren („mach es schöner“) → fragen Sie den Benutzer nach der einen Metrik, die über Erfolg entscheidet, und fahren Sie dann fort. Erfinden Sie keinen Stellvertreter.
  • ② hat mehrere Kandidatenbefehle (mehrere Testskripte) → behandeln Sie die CI-Konfiguration als maßgeblich; wenn keine vorhanden, wählen Sie die umfassendste und notieren Sie die Wahl in Ihrem präsentierten Ergebnis, damit der Benutzer sie korrigieren kann.
  • Kein Repository / leerer oder neuer Ordner → es gibt keinen Befehl auszuführen, wechseln Sie daher ③ zu einem artefaktbasierten Signal: eine Datei existiert, oder ihr Inhalt enthält einen bestimmten String, den Claude zurückdruckt. Alles andere im Mapping bleibt unverändert.

Kopieren-und-Einfügen-Vorlage — [method]

/goal <Endzustand>. Beweise es, indem du im aktuellsten Zug <Befehl> ausführst und
dessen Ausgabe <genaues Signal> enthält. Einschränkungen: <was sich nicht ändern darf>.
Stoppe nach <N> Zügen oder wenn <Stillstandsignal> – fasse dann den Blocker zusammen.

Arbeitsablauf — [method]

Wenn der Benutzer nach einem Ziel fragt, packen Sie seinen Satz nicht einfach in /goal. Gehen Sie so vor:

  1. Extrahieren Sie den tatsächlichen Endzustand. Fragen Sie (oder leiten Sie ab), was „fertig“ konkret bedeutet. Wenn es vage ist („das Modul aufräumen“), machen Sie es an etwas Messbarem fest (ein Zeilenbudget, keine Lint-Warnungen, ein bestehender Test), bevor Sie etwas schreiben.

  2. Finden Sie den tatsächlichen Verifikationsbefehl, indem Sie das Repository inspizieren. Raten Sie nicht npm test – schauen Sie nach. Hier verdient der Skill seinen Lohn, denn eine Bedingung, die einen Befehl nennt, den das Projekt nicht hat, wird nie abgeschlossen. Überprüfen Sie in grober Prioritätsreihenfolge:

    • package.json → scripts (test/build/lint/typecheck) und die Lock-Datei, um den Runner zu kennen (npm/pnpm/yarn/bun)
    • Python: pyproject.toml / pytest.ini / tox.ini / noxfile.py, Makefile
    • Rust Cargo.toml (cargo test, cargo build, cargo clippy), Go (go test ./..., go build ./...), Gradle/Maven, Makefile, justfile
    • CI-Konfiguration (.github/workflows, .gitlab-ci.yml) – das Maß für „was grün bedeutet“ in diesem Repository, oft die beste Quelle für den genauen Befehl
    • Für Ziele vom Typ „keine Treffer“ bevorzugen Sie eine grep -rn/rg-Zählung, die der Benutzer sehen kann Wählen Sie den Befehl, der jedes Mal ein stabiles, greppbares Signal produziert (Exit-Code, eine Zusammenfassungszeile, eine Trefferzahl).
  3. Wählen Sie das Evidenzsignal präzise. Binden Sie es an die tatsächliche Ausgabe dieses Befehls: exit code 0, 0 failed, 0 problems, no matches, git status --short leer. Bevorzugen Sie Signale, die nicht durch eine gesprächige Zusammenfassung vorgetäuscht werden können – ein tatsächlich eingefügter Befehlsschwanz ist besser als „Ich habe bestätigt, dass es besteht“.

  4. Fügen Sie Leitplanken aus dem Kontext hinzu. Alles, dessen Änderung den Benutzer verärgern würde: Testdateien, öffentliche API/Exporte, generierter Code, unzusammenhängende Module, Abhängigkeiten. Machen Sie die Leitplanke, wo nützlich, selbst überprüfbar („zeige git diff --stat; es berührt nur src/parser/“).

  5. Fügen Sie eine Stoppklausel hinzu. Eine Zugbegrenzung (stoppe nach N Zügen) und/oder einen Auslöser für Stillstand (wenn derselbe Fehler zweimal wiederholt wird, wenn sich die Testanzahl für 2 Züge nicht verbessert). Weisen Sie Claude dann an, den Blocker zusammenzufassen, damit der Benutzer den Grund erfährt.

  6. Präsentieren Sie das Ergebnis als einen einzelnen eingerahmten /goal ...-Block, bereit zum Einfügen, gefolgt von 1–2 Zeilen, die nennen, welchen Verifikationsbefehl Sie gewählt haben und warum. Wenn die automatische Genehmigung wichtig ist (Ziele, die Shell-Befehle ausführen, stoppen bei Genehmigungsaufforderungen, es sei denn, der Benutzer befindet sich im Modus acceptEdits/bypassPermissions), erwähnen Sie es kurz. Die Bedingung kann bis zu 4.000 Zeichen lang sein – lang genug, um eine kleine Abnahme-Checkliste als mehrere UND-verknüpfte Klauseln inline einzufügen, wenn die Aufgabe es rechtfertigt.

Kritik-/Reparaturmodus — [method]

Wenn der Benutzer Ihnen eine bestehende Ziel-String übergibt („warum wird

…

[truncated for translation]

Verwandte Skills