Communitygithub.com

agentic-workflow-kit/jig

Produzierte Oberfläche der agentic-workflow-kit-Suite: Pakete, unterstützende Produkte und Lernschleife.

Was ist jig?

Dieses Skill orchestriert die ausführungsgesteuerte Arbeit basierend auf den aktuellen Designverträgen von Jig. Es ist ein lokales Kompositions-Runbook, keine Laufzeitimplementierung, kein CLI, Provider-Adapter oder Datensatzspeicher. Der Skill stellt sicher, dass Ausführungspläne die erforderlichen Eigenschaften wie Story-Set, Abhängigkeiten, Arbeitsgrenzen und Nachweisanforderungen enthalten, wie im Vertrag `execution-plan-contract-v0.md` beschrieben. Der Skill prüft, bindet, plant, stoppt oder berichtet, darf aber keine Geschichten erfinden, Abhängigkeiten überarbeiten oder Richtlinien schwächen. Entscheidungen, Autorisierungen, Stopps und Beobachtungen müssen gemäß dem Vertrag `observability-records-contract-v0.md` aufzeichnbar sein. Der Skill unterstützt die Plattformen Claude Code, Cursor und Codex und bietet eine strukturierte Möglichkeit, Arbeit zu orchestrieren, Nachweise zu sammeln und die Einhaltung von Richtlinien und Rollentrennung sicherzustellen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add agentic-workflow-kit/jig

In Ihrer bevorzugten KI fragen

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

Dokumentation

Orchestriere Jig

Vertrag

Koordiniere ausführungsgesteuerte Arbeit basierend auf den aktuellen Designverträgen von Jig. Dieser Skill ist ein lokales Kompositions-Runbook, keine Jig-Laufzeitimplementierung, kein CLI, Provider-Adapter oder Datensatzspeicher. Er darf eine menschliche/Codex-unterstützte Ausführung nur so weit organisieren, wie es die genehmigten Eingaben, die aktuelle Werkzeugoberfläche, die Richtlinienhaltung und die Aufzeichnungsfähigkeit erlauben.

Der Ausführungsplan besitzt den Umfang. Er muss bereits den Story-Satz, Abhängigkeiten, Arbeitsgrenzen, Anforderungen an „erledigt“ und Nachweise, Autoritätserwartungen, Verweise auf Richtlinie/Arbeitsprofil/Repo-Boden, Einschränkungen und die Kompatibilitätshaltung enthalten, die in docs/design/contracts/execution-plan-contract-v0.md beschrieben sind. Dieser Skill darf ablehnen, binden, planen, stoppen oder berichten. Er darf keine Geschichten erfinden, Abhängigkeiten überarbeiten, Richtlinien schwächen, Akzeptanzkriterien hinzufügen, Nachweise für „erledigt“ auswählen, nicht in den Umfang fallende Oberflächen neu interpretieren oder fehlende Planfakten in Laufzeitentscheidungen umwandeln.

Aufzeichnungen sind der Nachweis. Jede regierte Entscheidung, Autorisierung, jeder Stopp, jede Nachweisbeobachtung, jedes Überprüfungsergebnis und jede ausführende Aktion muss unter docs/design/contracts/observability-records-contract-v0.md aufzeichnbar sein, bevor sie als wahr behandelt wird. Eine separate Erzählung, Chat-Zusammenfassung, Checkliste oder ein Arbeiterbericht überschreibt niemals das aufzeichnbare Nachweispaket.

Referenzgrenze

Der zurückgezogene workflow-kit orchestrierte Liefer-Skill ist nur Vorarbeit. Übernimm diese Lehren, wenn sie Jigs eigene Verträge bewahren:

  • Prüfe die Ausführungseingabe vor dem Versand;
  • Binde Laufzeitfakten nach der Prüfung, nicht während der Planung;
  • Halte vom Arbeiter erzeugte Änderungen getrennt von ausführenden privilegierten Aktionen;
  • Fordere unabhängige Nachweise, bevor der Zustand „erledigt“ oder „gelandet“ erreicht wird;
  • Hinterlasse einen wiederherstellbaren, benannten Stopp anstatt durch fehlende Fähigkeiten zu raten.

Importiere nicht die Ausführungspaket-Pfade von workflow-kit, das Tracker-Schema, die Story-Prompt-Ordner, Modell-Routing-Tabellen, das Provider-Paket-Layout, die v-next-Branch-Richtlinie, die alten PR-Veröffentlichungsregeln oder die alten Laufzeitansprüche. Wenn eine Regel aus der Vorarbeit nicht auf Jigs v0-Plan- oder Aufzeichnungseigenschaften abbildbar ist, ignoriere sie und benenne stattdessen den Stopp oder die Designlücke.

Eingaben

Erfordere alle diese vor jedem Arbeiter-Versand oder jeder privilegierten Aktion:

  • einen genehmigten Ausführungsplan, der mit execution-plan-contract-v0 kompatibel ist;
  • die Richtlinienreferenz, die Arbeitsprofilreferenz und die Repo-Bodenreferenz, an die der Plan gebunden ist;
  • Eigentümer-Zustimmung zum Starten oder Vorschauen an der angeforderten Grenze;
  • aktuelle Repo/Worktree-Fakten für den Ausführungsort;
  • für Start-, Ausführungs- oder Landegrenzen: aktuelle Treiber/Naht-Fakten für Agent, Ausführungshost, Forge und Arbeitsquelle, oder einen expliziten Stopp, wenn eine erforderliche Naht nicht inspiziert werden kann;
  • für Nur-Vorschau-Grenzen: ausreichende Bindungsfakten, um run.previewed aufzuzeichnen, ohne eine Laufzeitidentität, Arbeitsbereichszuweisung, Provider-Verkabelung oder privilegierte Nebenwirkungen zu benötigen;
  • aktuelle Verifikationsbefehle und Nachweisanforderungen aus dem Plan und der Richtlinie;
  • einen Aufzeichnungspfad, Aufzeichnungsspeicher oder ein dauerhaftes Aufzeichnungspaket-Format, das observability-records-contract-v0-Eigenschaften für diese lokale Ausführung bewahren kann.

Unbekannte Laufzeitfakten bleiben unbekannt, bis sie inspiziert werden. Fehlende Planfakten sind keine Laufzeitfakten; sie sind Plan-Prüfungsfehler.

Prüfung (Preflight)

Führe dieses Tor vor Versand, Bearbeitungen, Push, PR, Merge, Statusveröffentlichung oder jeder Behauptung aus, dass Jig gestartet hat.

  1. Bestätige, dass die Repo-Anweisungen und die maßgeblichen Dokumente für die berührte Oberfläche gelesen wurden: AGENTS.md, docs/product/jig.md, docs/product/guarantees.md, docs/product/concepts.md, docs/design/README.md, docs/design/contracts/execution-plan-contract-v0.md, docs/design/contracts/observability-records-contract-v0.md, docs/design/core/orchestration.md und docs/design/core/records.md.
  2. Überprüfe, ob der Plan vom Eigentümer oder dem besitzenden Planungsschritt genehmigt wurde. Wenn die Genehmigung fehlt, stoppe als plan-not-approved.
  3. Überprüfe, ob der Plan die erforderlichen v0-Eigenschaften enthält:
    • Planidentität und Herkunft;
    • Spur-Bindung;
    • Story-Satz;
    • Abhängigkeits- und Berechtigungsmodell;
    • Anforderungen an „erledigt“ und Nachweise;
    • Autoritäts- und Genehmigungsanforderungen;
    • Richtlinien- und Arbeitsprofilverweise;
    • Stack-Naht-Anforderungen;
    • Einschränkungen und Grenzen.
  4. Überprüfe, ob die Version oder der Kompatibilitätsmarker des Plans verstanden wird. Wenn nicht, stoppe als plan-format-unsupported.
  5. Überprüfe, ob jede ausgewählte Story eine stabile ID, beabsichtigte Grenze, Abhängigkeitsliste, Nachweisanforderungen und Autoritätserwartungen hat. Wenn eine ausgewählte Story den Ausführenden oder Arbeiter bittet, den Umfang abzuleiten, stoppe als plan-scope-incomplete.
  6. Überprüfe, ob die Abhängigkeitsreihenfolge ohne Umschreiben des Plans abgeleitet werden kann. Wenn der Graph zyklisch, widersprüchlich ist oder eine erfundene Reihenfolge benötigt, stoppe als plan-dependency-invalid.
  7. Überprüfe, ob die Verweise auf Richtlinie, Arbeitsprofil und Repo-Boden vorhanden und mit der angeforderten Ausführung kompatibel sind. Wenn sie fehlen, inkompatibel sind oder die Start-Richtlinie schwächen würden, stoppe als binding-input-missing.
  8. Überprüfe, ob die angeforderte Grenze unterstützt wird: Vorschau, lokale Ausführungskoordination, Nachweiserfassung, vom Ausführenden besessene Veröffentlichung oder Stopp. Vorschau ist nicht verbindlich: Sie erfordert Laden, Validieren, Binden und ein aufzeichnbares run.previewed-Ereignis, aber keine Laufzeitidentität, Arbeitsbereich, Provider oder privilegierte Nebenwirkung. Wenn der Benutzer echtes Jig-Verhalten anfordert, das im aktuellen Repo nicht existiert, stoppe als jig-runtime-unavailable.

Die Prüfung kann eine vorgeschlagene Ausführungssequenz, eine Ablehnung oder einen benannten Stopp erzeugen. Sie darf den Plan nicht reparieren.

Laufzeitbindung

Nach bestandener Prüfung binde nur aktuelle Fakten:

  • Worktree-Pfad, Repo-Root, Branch, Base und Sauberkeit;
  • derzeit geltende Richtlinien-, Arbeitsprofil- und Repo-Bodenverweise;
  • ausgewählte Geschichten und derzeit berechtigte Geschichten aus dem Plangraphen;
  • aktuelle Verifikationsbefehle, Überprüfungsanforderungen und Fähigkeitsnachweisanforderungen;
  • aktueller Genehmigungsstatus des Eigentümers und angeforderte Stopp-Grenze;
  • für Start-, Ausführungs- oder Landegrenzen: Verfügbarkeit und Beglaubigungshaltung der Treiber für Agent, Ausführungshost, Forge und Arbeitsquelle;
  • für Nur-Vorschau-Grenzen: Vorschau-Bindungshaltung und die aufzeichnbare run.previewed-Basis, ohne Provider-Verkabelung zu erzwingen;
  • Aufzeichnungsziel oder Aufzeichnungspaket-Ort und dessen Schwärzungs-/Export-Haltung;
  • vom Ausführenden besessene Aktionen, die auf der aktuellen Oberfläche verfügbar sind, wie Push, PR-Erstellung, Status-/Kommentar-Veröffentlichung und Merge.

Zeichne diese Bindungen vor dem Start auf. Start-Bindungen sind über Wiederaufnahmen hinweg unveränderlich: Eine Wiederaufnahme kann von einer gestoppten Ausführung fortfahren, aber sie darf nicht stillschweigend Richtlinie, Arbeitsprofil, Repo-Boden, Plan oder Treiberfakten austauschen. Geänderte sicherheitsrelevante Annahmen erfordern frische Eigentümer-Genehmigung und frische Nachweise, bevor fortgefahren wird.

Ausführenden- und Arbeitergrenze

Bewahre die Produkt-Autoritätsgrenze aus docs/product/concepts.md und docs/design/core/orchestration.md.

  • Der Arbeiter darf nur innerhalb der autorisierten Story-Grenze lesen, bearbeiten, nicht-privilegierte Prüfungen ausführen, einen Diff erzeugen, Nachweise erzeugen und Blockierungen melden.
  • Der Arbeiter darf nicht pushen, PRs öffnen oder aktualisieren, Status/Kommentare veröffentlichen, mergen, Autorität erweitern, Richtlinien-Böden bearbeiten, Stories als gelandet markieren oder Aufzeichnungen als Autorität des Geschehenen verfassen.
  • Der Ausführende koordiniert Berechtigung, Autorisierung, Nachweisbewertung, Aufzeichnungen, Eskalation an den Eigentümer, Push, PR-Erstellung, Status-/Kommentar-Veröffentlichung, Merge, Stopp, Wiederaufnahme und Export.
  • Privilegierte Aktionen erfordern Ausführenden-Autorität plus Richtlinien-/Nachweisbasis. Eine Selbstauskunft des Arbeiters reicht niemals aus, um eine privilegierte Aktion als abgeschlossen zu markieren.
  • Eine Anfrage außerhalb der erklärten Autorität schlägt geschlossen fehl oder wird an den Eigentümer weitergeleitet; sie wird niemals zu einer breiteren stillschweigenden Gewährung.

Wenn die aktuelle Oberfläche diese Trennung nicht aufrechterhalten kann, stoppe als authority-boundary-unsupported.

Koordinationsschleife

Verwende den Plangraphen und Jig-Lebenszyklusbegriffe, ohne neue Zustände hinzuzufügen.

  1. Starte nur Stories, deren Voraussetzungen gemäß dem Plan und den aktuellen Aufzeichnungen gelandet sind.
  2. Halte nicht berechtigte Stories wartend; bitte Arbeiter nicht, ihre eigenen Abhängigkeitsentscheidungen zu treffen.
  3. Für eine berechtigte Story entsende den Arbeiter mit der Story-Grenze, Planverweisen, Autoritätserwartungen, Nachweisanforderungen, Verifikationsbefehlen, Nicht-Zielen und Mutationsgrenzen.
  4. Behandle die Ausgabe des Arbeiters als vorgeschlagene Arbeit und Nachweise, nicht als Zustandsautorität.
  5. Bewerte „erledigt“ nur anhand von richtlinienkonformen Nachweisen, die vom Ausführenden oder einem delegierten Prüfer beobachtet wurden.
  6. Bewahre „erledigt“ und „gelandet“ als separate Meilensteine: Eine Story kann erledigt sein, wenn die Nachweise erbracht sind, während der Merge noch durch Überprüfung, Branch-Schutz, Konflikt, Warteschlange oder Eigentümergrenze zurückgehalten wird.
  7. Lande nur durch eine vom Ausführenden besessene Aktion, nachdem die erforderlichen Nachweise, die Genehmigung des Eigentümers/Prüfers (wenn erforderlich) und das Anhängen/Vorbereiten des Aufzeichnungspakets alle erfolgreich waren.
  8. Wenn eine Story blockiert, zeichne den Grund und die betroffenen nachgelagerten Stories auf; unabhängige Geschwister können fortfahren, wenn Richtlinie und Fähigkeit es erlauben.

Füge keinen Tracker, kein Story-Paket, Prompt-Paket oder Merge-Back-Modell hinzu, es sei denn, ein zukünftiger Jig-Designvertrag führt eines ein.

Nachweis- und Aufzeichnungstor

Bevor ein Zustandsübergang oder eine regierte Entscheidung als akzeptiert behandelt wird, bereite ein aufzeichnbares Paket mit den v0-Eigenschaften vor, die für die angeforderte Grenze gelten:

  • für festgelegte Start-/Wiederaufnahme-/Ausführungspfade: Laufzeitidentität, Versuchsidentität, Planverweis, Spurenverweis, Richtlinien-/Arbeitsprofil-/Repo-Bodenverweise und Treiberkontext;
  • für Nur-Vorschau-Pfade: Planverweis, Spurenverweis, Richtlinien-/Arbeitsprofil-/Repo-Bodenverweise und die nicht verbindliche run.previewed-Basis, ohne eine Laufzeitidentität oder einen Treiberkontext zu erfinden;
  • Ereignisfamilie und Ergebnis unter Verwendung der aktuellen Ereignisfamilien-Höhe von Jig;
  • Verantwortlicher Akteur oder Komponente: Arbeiter, Ausführender, Eigentümer, delegierter Prüfer oder Treiber;
  • Basis: Richtlinienregel, Nachweisbeobachtung, Genehmigung, Fähigkeitsnachweis, vorheriges Ereignis oder Planverweis;
  • Story-ID, wenn zutreffend;
  • Schwärzungs-/Export-Haltung;
  • Ordnungsinformationen, die ausreichen für Wiederholung oder Wiederaufnahme;
  • jede Blockierung, jeden Stopp, Hinweis, Wiederaufnahme-Checkpoint oder Basis für keine Doppelwirkung.

Automatisierte Prüfungen, Überprüfungen und Fähigkeitsbeglaubigungen müssen beobachtet oder unabhängig verifiziert werden. Wenn Nachweise fehlen, veraltet, nur selbstberichtet, nicht verifizierbar oder nicht aufzeichnbar sind, ist die Story nicht erledigt und muss als evidence-insufficient gestoppt werden.

Stopps

Bevorzuge benannte Stopps gegenüber improvisierter Ausführung. Ein Stoppbericht muss den Stoppnamen, die betroffene Ausführung oder Story, das fehlgeschlagene Tor, die aufzeichnbare Basis, den sicheren Wiederaufnahme-Checkpoint (falls verfügbar) und die nächste Aktion des Eigentümers enthalten.

Verwende diese Stoppnamen, es sei denn, es existiert ein spezifischerer, planbesitzender Name:

  • plan-not-approved — kein genehmigter Ausführungsplan oder Startgenehmigung.
  • plan-format-unsupported — Kompatibilitätsmarker oder Form des Plans ist unbekannt.
  • plan-scope-incomplete — Umfang, Grenze, Nachweise oder Autoritätsanforderungen der ausgewählten Story fehlen.
  • plan-dependency-invalid — Abhängigkeitsgraph kann nicht wie geschrieben ausgeführt werden.
  • binding-input-missing — Richtlinie, Arbeitsprofil, Repo-Boden oder Kompatibilitätsverweise fehlen oder sind inkompatibel.
  • jig-runtime-unavailable — Das angeforderte Verhalten erfordert Jig-Laufzeitfähigkeiten, die über das aktuelle lokale Trockenlauf-CLI hinausgehen (jig preview / jig run / jig inspect).
  • driver-capability-unavailable — Eine erforderliche Fähigkeit von Agent, Ausführungshost, Forge oder Arbeitsquelle kann nicht nachgewiesen werden.
  • authority-boundary-unsupported — Die aktuelle Oberfläche kann vom Ausführenden besessene privilegierte Aktionen und die eingeschränkte Arbeiterautorität nicht bewahren.
  • records-store-unavailable — Kein dauerhafter Aufzeichnungsspeicher oder aufzeichnbares Paket kann v0-Aufzeichnungseigenschaften bewahren.
  • evidence-insufficient — Erforderliche Nachweise fehlen, sind nicht verifizierbar, veraltet oder nur selbstberichtet.
  • owner-decision-required — Die Richtlinie leitet eine enge Entscheidung an den Eigentümer weiter.
  • safety-reapproval-required — Regelgebende oder sicherheitsrelevante Eingaben haben sich vor Wiederaufnahme oder Landung geändert.

Stoppen ist ein gültiges Ergebnis. Schwäche einen Stopp nicht zu einer Warnung ab, wenn die fehlende Bedingung Teil von Jigs Kontroll-, Nachweis-, Wiederherstellungs- oder Beobachtbarkeitsgarantien ist.

Ausgabe

Gib ein kompaktes Ausführungs-Journal zurück, keinen Transkript-Dump:

  • Planverweis und ausgewählte Story-IDs;
  • gebundene Richtlinien-, Arbeitsprofil- und Repo-Bodenverweise;
  • untersuchte Laufzeitfakten und ungelöste unbekannte Fakten;
  • aufzeichnbare Zustände: berechtigt, gestartet, geparkt, blockiert, erledigt, gelandet, abgelehnt, gestoppt, fortgesetzt oder abgeschlossen;
  • beobachtete Nachweise und ausgeführte Verifikationsbefehle;
  • vom Ausführenden besessene Aktionen, die ergriffen wurden oder explizit nicht ergriffen wurden;
  • Stoppnamen, Gründe, sichere Wiederaufnahme-Checkpoints und nächste Aktionen des Eigentümers;
  • Aufzeichnungspaket/Speicherverweise und Schwärzungshaltung;
  • nicht unterstützte Fähigkeiten oder Designlücken, die an die besitzende Jig-Design/Planungsoberfläche zurückverwiesen werden.

Wenn keine aufzeichnbaren Nachweise für einen behaupteten Zustand existieren, melde den Zustand als unverifiziert und stoppe.

Verwandte Skills