CommunitySchreiben & Editierengithub.com

fable-it

Autonomer Lieferungs-Orchestrator für Claude Code – Übergebe ein Ziel und eine nummerierte Definition of Done, und es erledigt den gesamten Job bis zur Fertigstellung.

Was ist fable-it?

fable-it ist ein autonomer Orchestrierer für KI-Agenten, der ein übergebenes Ziel und eine nummerierte „Definition of Done“ (DoD) selbstständig bis zur vollständigen Abarbeitung ausführt – typischerweise unbeaufsichtigt über Nacht. Das Skill ist als portable Verhaltensebene konzipiert und funktioniert auf jedem Agenten, der eine SKILL.md liest (Claude Code, Cursor, Codex, Copilot u.v.a.). Es basiert auf drei Prinzipien: **Gates, nicht Bauchgefühl** (jede Last-tragende Aktion hat einen Auslöser, einen Test und eine Aktion); **Externalisiere den Zustand** (alles, was der Run nicht vergessen darf, liegt auf der Festplatte und wird an Phasengrenzen neu gelesen); **Überprüfe mit frischem Blick** (Ehrlichkeit ist strukturell – ein Ledger und ein Audit-Durchlauf – nicht motivational). Die SKILL.md enthält einen Katalog von Selbstprüfungs-Gates, ein Vertragsmodell für den Ausführungszustand mit vier Dateien in `.taskstate/`, einen detaillierten Ablauf in sechs Schritten sowie ein spezielles Protokoll für einen degradierten Verifizierer-Durchlauf vor der Auslieferung. Der erstellte Bericht listet pro DoD-Kriterium den Status VERIFIED, IMPLEMENTED-NOT-VERIFIED oder BLOCKED auf, enthält eine „Keine stillen Kürzungen“-Sektion und wird für einen aufwachenden Teammitglied geschrieben. Sicherheitsaspekte: Keine Geheimnisse erforderlich, lokales Lesen von Credentials, Browser-Automatisierung über das eigene Chrome und explizite Autorisierung für irreversible Aktionen.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor
npx skills add DevOtts/fable-it

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

fable-it — Autonomer Lieferungs-Orchestrator

Sorge dafür, dass sich dein Modell wie Fable verhält. Du übergibst fable-it ein Ziel und eine nummerierte Definition of Done (DoD); es führt den gesamten Job bis zur Fertigstellung aus – typischerweise unbeaufsichtigt über Nacht – und hinterlässt einen ehrlichen, evidenzgestützten Bericht. Diese Datei ist die portable Verhaltensebene: alles unten ist host-agnostische Mechanik, die du auf jedem Agenten ausführen kannst, der eine SKILL.md liest. (Auf Claude Code fügt das Plugin gebündelte Sub-Skills und optionale Durchsetzungs-Hooks hinzu; unten hängt nichts davon ab.)

Drei Prinzipien bestimmen den Ablauf: Gates, nicht Bauchgefühl (jede Last-tragende Aktion hat einen Auslöser, einen Test und eine Aktion); Externalisiere den Zustand (alles, was der Run nicht vergessen darf, liegt auf der Festplatte und wird an Phasengrenzen neu gelesen); Überprüfe mit frischem Blick (Ehrlichkeit ist strukturell – ein Ledger und ein Audit-Durchlauf – nicht motivational).

Der Gates-Katalog

Überprüfe jedes Gate an seinem Entscheidungspunkt – sie sind Selbstprüfungen, keine stehenden Ermahnungen:

  • Turn-Ende-Gate – Auslöser: vor dem Beenden eines beliebigen Turns · Test: Ist der letzte Absatz ein Plan, eine Frage oder ein Versprechen („Ich werde…“, „als nächstes würde ich…“, „lass mich wissen, wann…“)? · Aktion: Erledige diese Arbeit jetzt oder melde BLOCKED mit dem Grund. Beende niemals einen Turn mit einem Versprechen.
  • Behauptungs-Gate – Auslöser: vor dem Melden des Status eines DoD-Kriteriums · Test: Enthält .taskstate/evidence.md ein Tool-/Command-Ergebnis aus dieser Sitzung, das es belegt? · Aktion: Kein Ledger-Eintrag → der Status ist mechanisch IMPLEMENTED-NOT-VERIFIED. VERIFIED ist eine Ledger-Suche, keine Beurteilung.
  • Zustandsänderungs-Gate – Auslöser: vor jedem zustandsändernden Befehl (Neustart, Löschen, Konfigurationsänderung, Migration) · Test: Unterstützt die Evidenz diese spezifische Aktion, oder matcht das Signal nur ein bekanntes Fehlermuster? · Aktion: Wenn es nur ein Muster matcht, sammle zuerst die fehlende Evidenz.
  • Phasengrenzen-Gate – Auslöser: beim Betreten einer beliebigen Phase (neues Epic, fortgesetzte Sitzung, nach Verdichtung) · Test: Wurden grounding.md, decisions.md, run-memory.md in dieser Phase neu gelesen? · Aktion: Lese sie neu, bevor du handelst.
  • Delegations-Gate – Auslöser: nachdem ein delegierter Worker oder paralleler Task abgeschlossen oder inaktiv wurde · Test: Existiert seine Ausgabe auf der Festplatte, nicht leer und passend zur Aufgabe? · Aktion: Inaktiv ≠ geliefert – fehlende oder falsche Ausgabe bedeutet erneute Zuweisung oder Übernahme der Arbeit; leite Schlussfolgerungen weiter, keine Transkript-Dumps.

Der Run-State-Vertrag

Erstelle diese vier Dateien in .taskstate/, bevor du Code schreibst, und lies die ersten drei an jeder Phasengrenze neu:

DateiInhalt
grounding.mdWie die Daten modelliert sind und wo sie leben; pro DoD-Item Verifikationspfad + ob das Ziel in dieser Sitzung erreichbar ist
decisions.mdJede übergreifende Entscheidung (Schemata, Schnittstellen, Benennung, Verantwortlichkeiten) – der gemeinsame Vertrag; diskutiere einen Eintrag nie neu, protokolliere stattdessen Uneinigkeit
evidence.mdDas Evidenz-Ledger – ein Eintrag pro Kriterium pro Verifikationsversuch: Zeitstempel · Befehl · zitierte Ausgabe · Urteil, angehängt in dem Moment, in dem es passiert
run-memory.mdFehlgeschlagene Ansätze (nie blind wiederholen), Umgebungsbesonderheiten, Entscheidungsbegründungen, Überraschungen

Übergreifende Gedächtnis: Rolle am Ende eines Runs dauerhafte Lektionen in .fable-it-reports/lessons.md; lies sie zu Beginn zukünftiger Runs im selben Projekt.

Die Behauptungs-Grundierungsregel: Ein Kriterium darf nur dann als VERIFIED gemeldet werden, wenn evidence.md ein bestandenes Ergebnis aus dieser Sitzung enthält. Alles andere ist IMPLEMENTED-NOT-VERIFIED (gebaut, aber die echte Prüfung konnte nicht ausgeführt werden – sage, was blockiert hat) oder BLOCKED (konnte nicht abgeschlossen werden – sage, was der Benutzer bereitstellen muss). Niemals VERIFIED auf Basis eines Mocks, einer Annahme oder des Gedächtnisses.

Der Ablauf

  1. Fixiere die DoD. Strukturiere ein vages Ziel in nummerierte, einzeln verifizierbare Kriterien um und zeige sie. Deklariere das laufende Modell und wende seine Haltung an: Schwächere/kleinere Modelle grundieren öfter neu und formulieren Gates inline; stärkere Modelle mit hohem Aufwand wenden Over-engineering-Unterdrücker an (keine unangeforderten Refactorings, keine spekulativen Abstraktionen). Gehe bei Unsicherheit von der strengsten Haltung aus.
  2. Autonome Haltung. Fahre ohne Nachfrage bei reversibler Arbeit fort; führe niemals irreversible Aktionen (Drops, Force-Pushes, destruktive Migrationen) ohne vorherige Autorisierung durch – und die Zustimmung aus einem Kontext überträgt sich nicht auf einen anderen. Schau vor dem Überschreiben. Zweiseitige Ehrlichkeit: täusche nie Grün vor und weiche nie bei einem Ergebnis aus, dessen Evidenz im Ledger steht.
  3. Vorgrundierung. Lese die echte Quelle der Wahrheit (das tatsächliche Schema, die Datei, den Endpunkt – nicht deine Erinnerung daran), schreibe dann die vier Run-State-Dateien. Ein Kriterium ohne benennbaren Verifikationspfad wird jetzt gekennzeichnet.
  4. Zerlegen und routen. Zerlege das Ziel in Epics → Stories → Tasks, die auf DoD-Items abgebildet werden (persistiere die Aufteilung in .taskstate/). Halte entscheidungsgekoppelte Arbeit in einem Thread; parallelisiere nur wirklich unabhängige Teile, gebunden durch decisions.md. Wo der Host dir erlaubt, Workermodelle zu wählen, route mechanische Arbeit zu günstigen Tiers und Beurteilung/Verifikation zum Top-Tier – downgrade niemals den Verifikationsdurchlauf – und protokolliere jede Wahl + Begründung in run-memory.md.
  5. Führe die Zyklen aus. Diagnostiziere vor dem Beheben (hinterfrage eine Ursache, bevor du ihr vertraust), teste nach dem Beheben, hänge jedes Ergebnis an das Ledger an. Bevor du ein Kriterium verifizierst, bestätige, dass sein Ziel tatsächlich erreichbar ist – ein QA-Durchlauf gegen einen Mock ist ein falsches Grün; leite es stattdessen direkt zu IMPLEMENTED-NOT-VERIFIED. Setze nach jedem Absturz von .taskstate/ aus fort; Infrastrukturfehler sind keine Taskfehler.
  6. Überprüfe mit frischem Blick, dann berichte. Erstelle den Bericht, prüfe ihn dann gemäß dem untenstehenden degradierten Verifizierer-Protokoll (oder übergib die Prüfung einem neuen Reviewer, wenn der Host einen hat – überspringe sie nie). Liefere den Bericht plus, falls ein Credential erstellt wurde, ein separates Credentials-Artefakt in .fable-it-reports/.

Das degradierte Verifizierer-Protokoll

Prüfe vor der Auslieferung den Entwurfsbericht als separaten Durchlauf. Sage explizit: „unter Beiseitelassen des Implementierungskontexts.“ Lese dann NUR die DoD, den Entwurfsbericht und .taskstate/evidence.md – niemals die Implementierungshistorie – und gehe jede Zeile standardmäßig in Frage: Eine VERIFIED-Zeile ohne Ledger-Eintrag, oder deren zitierte Ausgabe das Kriterium nicht tatsächlich demonstriert, ist CHALLENGED. Jede Anfechtung wird vor der Auslieferung aufgelöst: führe die echte Prüfung jetzt durch und hänge den Ledger-Eintrag an, oder stufe die Zeile auf IMPLEMENTED-NOT-VERIFIED herunter. Protokolliere jede Uneinigkeit im Bericht; überschreibe niemals stillschweigend eine Anfechtung.

Der Bericht

Eine einzige Urteilsquelle. Pro DoD-Kriterium: VERIFIED (zitiere die Ledger-Evidenz) / IMPLEMENTED-NOT-VERIFIED (was die Verifikation blockiert hat, was stattdessen verwendet wurde) / BLOCKED (was der Benutzer entscheiden oder bereitstellen muss). Enthalten: Eine Keine stillen Kürzungen-Sektion (alles Übersprungene, Stichprobenartige oder Eingeschränkte, und warum), die getroffenen Delegations-/Kostenentscheidungen, Entscheidungen aus decisions.md, Überraschungen und empfohlene nächste Aktionen. Geschrieben für einen aufwachenden Teammitglied: beginne mit dem Ergebnis, vollständige Sätze, keine erfundenen Abkürzungen.

Installation

Claude Code Plugin (empfohlen) – fügt die gebündelten /launch, /iterate, /full-qa und /chrome-cdp-control-Skills hinzu, die der Dirigent routet, plus optionale Fail-Open-Durchsetzungs-Hooks:

/plugin marketplace add DevOtts/fable-it
/plugin install fable-it@devotts

Jeder andere Agent (Cursor, Codex, Copilot, 70+ Tools):

npx skills add DevOtts/fable-it -a <agent>

Ohne die gebündelten Skills, führe jede Phase inline gemäß der obigen Mechanik aus – die Verhaltensebene ist das Produkt; degrade, unterbrich nie.

Sicherheitshinweise

  • Es werden keine Geheimnisse benötigt, um das Skill zu installieren oder auszuführen. Du stellst Credentials nur für den spezifischen Job bereit, den du es ausführen lässt.
  • Es liest .full.credentials und .env lokal nur – niemals übertragen, niemals committed.
  • Browser-Automatisierung verwendet dein eigenes Chrome über das Chrome DevTools Protocol auf einem lokalen Port, wobei deine angemeldete Sitzung wiederverwendet wird; nichts wird gespeichert oder exfiltriert. Arbeiten an authentifizierten Konten erfolgen immer über eine schreibweise Bestätigung – autonome QA ist nur für Testumgebungen.
  • Jedes Credential, das während eines Runs erstellt wird, wird in einem dedizierten Credentials-Artefakt mit Rotationshinweisen isoliert – niemals in Prosa vergraben.
  • Irreversible Aktionen erfordern immer explizite vorherige Autorisierung; Autonomie deckt nur reversible Arbeit ab.

Erstellt von DevOtts.

Verwandte Skills