Communitygithub.com

MarkTripoli/skills

Zentralisiere ticketbezogene Ausführungsentscheidungen und delegiere die Umsetzung an isolierte, fortsetzbare Ticket-Branches mittels videogestützter iterativer Entwicklung.

Was ist skills?

Dieses Skill orchestriert die Umsetzung von Jira-Epics, GitHub-Issues oder expliziten Anforderungslisten in langlebige Auslieferungs-Warteschlangen. Es zerlegt die Arbeit in isolierte Ticket-Branches, weist jedem Umsetzungsagenten exklusive Worktrees zu und legt vor dem Dispatch einen vollständigen Ausführungsvertrag (Execution Contract) fest, der den Umfang (Backend-only, Frontend-only oder cross-layer) definiert. Die Orchestrierung behält sich alle wesentlichen Entscheidungen vor (Quellinterpretation, Ticketumfang, Verhalten, Repository-Auswahl, Abhängigkeitsreihenfolge, Branch/PR-Topologie, Abweichungen, Blocker-Bearbeitung, Lebenszyklus, finale Abnahme und Ticket-Berichterstattung) und delegiert die Ausführung an spezialisierte Unter-Skills wie `video-iterative-development`. Dazu gehören Mechanismen zur Wiederaufnahme unterbrochener Arbeit, zum Quellabgleich, zur Extraktion von Figma-Designs, zur Konformitätsprüfung und zur unabhängigen Code-Review. Ein besonderer Fokus liegt auf der strikten Trennung von Entscheidungsbefugnis und Ausführungsaufgaben, wobei alle wesentlichen Entscheidungen protokolliert werden müssen und Ausführungsagenten nur reversible, konventionelle Mechaniken anwenden dürfen. Das Skill unterstützt eine nahtlose Integration mit Slack zur Koordination und bietet klare Wiederaufnahme- und Fehlerbehebungsmechanismen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MarkTripoli/skills/tree/HEAD/skills/delivery/video-iterative-orchestration

In Ihrer bevorzugten KI fragen

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

Dokumentation

Lies den Schreibleitfaden und die Sammlungskonventionen vor dem Entwurf, der Überarbeitung oder der Antwort; ein Checkout der Sammlung enthält beide unter shared/.

Video-Iterative Orchestrierung

Skill-Typ: Starr — Bewahre Ticketumfang, unterbrochene Arbeit, Abhängigkeitsherkunft und Evidenz-Gates. Gewöhnliche Fehler führen zur Wiederherstellung; sie beenden keinen Implementierungsversuch.

Zweck und Verantwortlichkeit

Wandle ein Jira-Epic, eine GitHub-Issue-Warteschlange oder eine explizite priorisierte Anforderungsliste, optional eingegrenzt auf benannte Tickets, in eine dauerhafte Auslieferungs-Warteschlange um. Jedes ausgewählte Ticket oder jede Korrektur erhält einen exklusiven Implementierungsagenten und Worktree. Vor dem Dispatch wählt der Orchestrator den Umfang (Backend-only, Frontend-only oder Cross-Layer) und stellt einen vollständigen Ausführungsvertrag bereit. Jeder Implementierungsagent verwendet video-iterative-development, um diesen Vertrag auszuführen und seine verifizierte Abgabe zu erstellen.

Der Orchestrator delegiert die Ausführung, nicht die Entscheidungsbefugnis. Er besitzt exklusiv die Quellinterpretation, den Ticketumfang, das Produktverhalten, die Repository- und Layer-Auswahl, die Abhängigkeitsreihenfolge, die Branch- und PR-Topologie, Abweichungen, die Blocker-Bearbeitung, den Lebenszyklus-Zustand, die finale Abnahme und die Ticket-Berichterstattung. Er ruft auf, anstatt seine Begleiter neu zu formulieren:

  • resume-and-reconcile.md besitzt die Erkennung unterbrochener Arbeit und die Erkennung von Änderungen im zugeordneten Quellcode.
  • extract-figma-visuals besitzt die Figma-Hierarchieauswahl, den Export und die Bundle-Validierung.
  • feature-conformance besitzt die Quellautorität, Entscheidungsaufzeichnungen, Rückverfolgbarkeit und Validierung von Lieferansprüchen.
  • video-iterative-development besitzt die zugewiesene Implementierung, Wiederherstellungsmechanismen, Evidenz und Einreichung. Es gibt Beobachtungen und strukturierte Entscheidungsanfragen zurück; es ändert weder den Ausführungsvertrag noch weist es Lieferzustände zu.
  • agent-implementation-reviewer besitzt einen unabhängigen schreibgeschützten Plan-to-Diff-Bericht. Der Orchestrator wendet den Feature-Contract-Adapter an, ohne diesen gemeinsamen Reviewer zu ändern.
  • Die Engineering-Guidance-Review untersucht den endgültigen Diff auf Übereinstimmung mit den geltenden Repository-Konventionen. Sie zeichnet konkrete Konsequenzen und begründete Ausnahmen auf, ohne Präferenzen in neue Ticketanforderungen umzuwandeln.

Entscheidungsbefugnis

Eine folgenreiche Entscheidung ist jede Wahl, die die Quellinterpretation, den Umfang, das Produkt- oder Designverhalten, die beteiligten Repositories oder Layer, die Abhängigkeitsreihenfolge, die Branch- oder PR-Topologie, die erforderlichen Evidenzen, eine genehmigte Abweichung, die Blocker-Bearbeitung oder den endgültigen Ticketzustand ändert. Der Orchestrator trifft und zeichnet jede folgenreiche Entscheidung vor dem Dispatch oder als Antwort auf eine Worker-Anfrage auf. Automatische Quellauflösungen, die von diesem Skill autorisiert sind, gelten ebenfalls als Orchestrator-Entscheidungen.

Implementierungsagenten dürfen nur reversible, repository-konventionelle Mechanismen wählen, die den Ausführungsvertrag unverändert lassen, wie z.B. lokale Code-Organisation, Befehlsreihenfolge, Details deterministischer Selektoren oder die Art und Weise, wie ein im Umfang liegender Fehler diagnostiziert und wiederholt wird. Wenn Anweisungen unvollständig, widersprüchlich sind oder eine folgenreiche Entscheidung erfordern, darf der Worker nicht raten, den Umfang erweitern, den Prompter kontaktieren oder sich selbst einen endgültigen Zustand zuweisen. Er gibt eine strukturierte decision_request an den Orchestrator zurück und setzt alle nicht betroffenen zugewiesenen Arbeiten fort.

Eingaben

  • Ein Jira-Epic-Schlüssel/Link, eine GitHub-Issue-Warteschlange oder eine explizite priorisierte Anforderungsliste. Löse die ausgewählte Warteschlange aus der Anfrage auf; erfordere kein Jira für GitHub- oder tracker-neutrale Durchläufe.
  • Für den Korrekturmodus ein schreibgeschütztes Findings Markdown-Dokument.
  • Repository-Stammverzeichnisse, wenn sie nicht aus dem Arbeitsbereich erkannt werden können.
  • Ein optionales schreibgeschütztes Designdokument oder einen Link. Architektur ist ein Untertyp des Dokuments, keine separate Eingabekategorie.
  • Optionale schreibgeschützte Figma-Root-Frame-Links, die node-id für zutreffende UI-Tickets enthalten.
  • Eine optionale Anfrage, den Durchlauf über Slack zu koordinieren, einschließlich eines explizit genannten Kanals oder einer expliziten Anfrage für einen Direct-Message-Durchlauf. Ohne eines dieser Ziele verwendet slack-coordinator das Repository-Standard.
  • Jede explizite externe Autorität oder Frist.

Fordere keine Feature-ID, Contract-Datei, Genehmigungsflag, Figma-Revision oder Layer-Klassifizierung an. Fehlende optionale Figma- oder Designdokument-Kontexte sind kein Blocker.

Wenn eine Slack-Koordination angefordert wird, rufe slack-coordinator direkt als Teil der Orchestrierung auf; erzeuge keinen separaten Slack-Agenten oder -Bereich. Verwende einen Slack-Durchlauf und -Thread für die Orchestrierung. Der Orchestrator ist der alleinige Slack-Verbindungsglied und der alleinige Konsument seiner run_id; Implementierungsagenten berichten an den Orchestrator und rufen niemals den Coordinator auf oder konsumieren selbst die Eingabe des Eigentümers.

Nachdem der schreibgeschützte Intake das Epic und die ausgewählten Tickets aufgelöst hat, überprüfe ein bestehendes Ledger auf eine aktive Coordinator-run_id. Setze diesen Durchlauf fort, wenn vorhanden. Andernfalls bestätige, dass die ausführbare Datei verfügbar ist, und rufe run start vor der ersten zustandsändernden Aktion auf, verwende das Epic als Arbeit, das angeforderte Ergebnis als Ziel und die ausgewählten Tickets als Umfang. Übergib --channel nur für den einzelnen Kanal, der in der aktuellen Anweisung explizit genannt wurde, übergib --dm nur, wenn der Prompter explizit einen Direct-Message-Durchlauf anfordert, und ansonsten lasse den Coordinator das Repository-Standard verwenden. Zeichne die zurückgegebene run_id, den Kanal, den Thread-Zeitstempel und den Permalink im Ledger bei seinem ersten erlaubten Schreibvorgang auf. Starte niemals einen zweiten Coordinator-Durchlauf, nur weil ein Ticket startet, fortgesetzt wird, wiederholt wird oder den Besitzer wechselt.

Führe run check unmittelbar vor jeder zustandsändernden Aktion des Orchestrators und unmittelbar vor jedem Dispatch oder Folgeauftrag aus, der Implementierungsarbeit autorisiert. Exit-Code 0 erlaubt die Aktion. Bei Exit-Code 10 wende die Eingabe des Eigentümers an, beantworte sie oder lehne sie mit run resolve ab und überprüfe dann erneut. Bei Exit-Code 11 pausiere, wiederhole nach einer kurzen Wartezeit und melde den Grund; mutiere niemals den Zustand, versende Arbeiten oder falle auf einen anderen Slack-Pfad zurück, während die Koordination nicht verfügbar ist. Exit-Code 12 ist die explizite Break-Glass-Entscheidung des Operators und erlaubt es dem Durchlauf, ohne weitere Slack-Aufrufe fortzufahren.

Verwende run event für Orchestrierungsphasenwechsel, Ticket-Lebenszykluswechsel und Blocker-Start oder -Ende; der Daemon besitzt das erneute Posten von Status in ruhigen Intervallen. Rufe run finish einmal auf, wenn die Orchestrierung ihr endgültiges Ergebnis (abgeschlossen, fehlgeschlagen oder abgebrochen) erreicht hat. Befolge die Befehls-, Kanalauswahl-, Nachrichten- und Fehlerverträge des eigenständigen Skills, anstatt sie hier neu zu formulieren oder abzuschwächen. Wenn keine Slack-Koordination angefordert wurde, starte keinen Durchlauf und füge keine Slack-Gates hinzu.

Wähle den Ausführungsmodus

Verwende den Auslieferungsmodus ohne Findings: Lies den Jira-Auslieferungsworkflow für Jira oder den Auslieferungsmodus für GitHub und tracker-neutrale Warteschlangen. Verwende den Korrekturmodus, wenn die ausgewählte Warteschlange ein Findings-Dokument enthält. Lies den Korrekturworkflow.

Führe in beiden Modi vor der Erstellung eines Worktrees die Wiederaufnahme und Quellabstimmung durch. Für Jira ist der Status entscheidend: In Progress und Code Review sind resume_required und müssen bestehende Arbeit übernehmen, anstatt von der Basis zu starten.

Ticketumfang und Designautorität

Die Anforderungen und Akzeptanzkriterien des ausgewählten Tickets definieren die Grenze der Arbeit. Das Epic liefert Kontext zu Mitgliedschaft, Reihenfolge und Abhängigkeiten; es wird nie angenommen, dass es jedes in Figma oder einem Designdokument dargestellte Verhalten enthält. Ordne nur Figma-Knoten und Dokumentabschnitte zu, die ein ausgewähltes Ticket klären. Nicht zugeordnete Designinhalte sind Kontext, keine fehlende, verschobene oder außerhalb des Umfangs liegende Arbeit.

Innerhalb der Ticketgrenze:

  1. Die zugeordnete Figma ist die Standardautorität für visuelles und Interaktionsverhalten, einschließlich mehrdeutiger oder widersprüchlicher Ticketdetails;
  2. Die zugeordnete Figma überschreibt automatisch ein widersprüchliches Designdokument;
  3. Ohne zutreffende Figma löst ein zugeordnetes Designdokument mehrdeutige Ticketdetails auf;
  4. Repository- und API-Konventionen lösen verbleibende Implementierungsdetails auf.

Zeichne jede automatische Auflösung in .agent-evidence/orchestration/<run-id>/decision-log.md auf. Pausiere nur das betroffene Ticket für die seltene ungelöste Wahl, deren Alternativen den Produktumfang oder das Benutzerverhalten wesentlich ändern. Eine explizit genehmigte Abweichung von den autoritativen Quellen ist eine approved_deviation; gewöhnliche Implementierungsentscheidungen und Figma-Auflösungen sind keine Abweichungen.

Erstelle ein run-level Designdokument-Manifest unter .agent-evidence/orchestration/<run-id>/design-documents/manifest.json. Es zeichnet die Quellidentität, den gesamten SHA-256 des Dokuments und nur die stabilen IDs, Titel und SHA-256-Werte für Abschnitte auf, die ausgewählten Tickets zugeordnet sind. feature-conformance referenziert dieses Manifest; es erstellt kein weiteres.

Rufe für jede bereitgestellte UI-Root extract-figma-visuals vor dem Dispatch auf und übergib das validierte Bundle an zutreffende Worker. Eine bereitgestellte Jira-, Figma- oder Designdokument-Quelle, die nach Zugriffsprüfungen und wesentlich anderen Wiederholungen unlesbar bleibt, blockiert nur das betroffene Ticket. Ersetze niemals veraltete Inhalte, nachgebaute Mockups oder erratene Anforderungen.

Richte den Run-Zustand ein

Vor dem Dispatch:

  1. Erstelle oder setze ein Ziel für die ausgewählte Epic-Arbeit fort. Halte es aktiv, solange ein Ticket wiederherstellbare oder unabhängige Arbeit hat.
  2. Überprüfe die Repository-Anleitung, den aktuellen Status, Worktrees, Ticket-Branches, offene PRs, Regeln für generierten Code und dokumentierte Verifizierungsbefehle. Für einen bestehenden PR identifiziere seinen Quell-Worktree und den Grund, wenn dieser Worktree unbrauchbar ist. Für Cross-Layer-Arbeit löse die dokumentierte Compound-Startkonfiguration der beteiligten Repositories in ihre vollständige Prozess-Topologie auf: jeden Befehl, jedes Argument, jedes Arbeitsverzeichnis, jede Umgebungsquelle, die Abhängigkeitsreihenfolge, jeden Port, jeden Health-/Feature-Probe, jeden Migrations-/Fixture-Schritt, jeden Client-Generierungsschritt, jede Laufzeit-Define und jeden Android-Patrol-Befehl. Übergib den ausgewählten Worktree, die Verifizierungsbefehle und die aufgelöste Topologie an den Implementierungsagenten. Eine im Repository dokumentierte IDE-Compound ist eine Topologie-Definition, keine Anweisung, die IDE aufzurufen.
  3. Löse Tickets und Abhängigkeiten über die authentifizierte Oberfläche des ausgewählten Trackers auf und führe dann die Wiederaufnahme/Quellabstimmung durch. Jira verwendet Jira MCP; ein GitHub- oder expliziter Listendurchlauf bewahrt seinen eigenen Umfang und seine Statusautorität.
  4. Extrahiere und validiere zutreffende Figma-Bundles. Erstelle das einzelne Designdokument-Manifest, wenn vorhanden.
  5. Rufe feature-conformance im Preflight-Modus auf. Repariere agentengenerierte Schema- oder Zuordnungsfehler und führe es erneut aus; präsentiere sie nicht als Ticket-Blocker.
  6. Löse das explizite Aufgabenverzeichnis oder das konfigurierte Aufgaben-Stammverzeichnis auf. Verwende unveränderliche indizierte Belege wie unten beschrieben. Erstelle ein ignoriertes Ledger, decision-log.md und die neu aufbaubaren Caches resume-state.json und source-index.json. Jira, Git, PRs, aktuelle Manifeste und aktuelle Quell-Lesevorgänge bleiben autoritativ, wenn Caches fehlen oder veraltet sind.
  7. Erstelle die Abhängigkeitstabelle und zeichne den Besitzer, den ausgewählten Umfang und die unveränderten Layer, die übernommene oder neue Schreibfläche, das PR-Ziel, die Quellzuordnungen, die Vertragszeilen, die Orchestrator-Entscheidungen, das Evidenz-Gate, den kanonischen Laufzeit-Lease-Zustand, den Wiederherstellungszustand und den endgültigen Zustand auf. Wenn die Slack-Koordination aktiviert ist, zeichne auch deren run_id, Kanal, Thread-Zeitstempel, Permalink und den aktuellen Koordinationszustand auf Run-Ebene auf.

Verwende kanonische snake_case-Maschinenzustände: ready, waiting, resume_required, resume_needs_lineage, resume_source_missing, active, source_update_detected, reconciliation_active, correction_active, needs_product_decision, locally_verified, submitted, submitted_verified und blocked.

Bewahre indizierte Aufzeichnungen und Nachweise auf

index.json ist autoritativ für Aufgabenartefakte. Zeichne Vertragsbelege als feature-contract (design.contract), Konformität als feature-conformance (review.conformance), vorgeschlagene Blocker als delivery-disposition (delivery.disposition) und verifizierte Einreichungsbelege als submission-closure (delivery.closure) auf. Weise jeder dauerhaften Revision eine neue unveränderliche Iteration zu, die ihren exakten JSON-Snapshot-Pfad/-Hash, ihr Ticket, ihren Quell-Head und den relevanten Vertrags-/Prüfungsnachweis bindet. Wähle aktuelle Aufzeichnungen aus und validiere sie mit Digest, bevor du sie verwendest; ungültige Indizes fallen nie auf Scans zurück. Verwende den benachbarten optionalen Aufgabenartefakt-Helfer oder die genauen manuellen Konventionen. Nur wirklich nicht indizierte Legacy-Aufgaben verwenden nummerierte Aufzeichnungen.

Das Run-Ledger, das Wiederaufnahme-Inventar und der Quellindex sind neu aufbaubare Betriebs-Caches, kein Ersatz für unveränderliche Abnahme- oder Prüfungsbelege. Rohe visuelle Bundles und Aufnahmen bleiben ausgeschlossene lokale Evidenz. Der GitHub-PR-Body, ein separater Evidenz-Kommentar, eine direkte gehostete Aufnahme und das erneute Lesen des aktuellen Heads bleiben die Veröffentlichungsautorität; schwäche niemals installierte Veröffentlichungshooks oder Basis-/aktuelle Nachweisanforderungen ab.

Isoliere und staple die Ticketarbeit

Gib jedem aktiven Implementierungsagenten einen exklusiven Worktree und Branch in jedem Repository, das er ändert. Teile niemals einen veränderlichen Checkout oder verwerfe unterbrochene Änderungen.

  • Übernimm die ausgewählte Quelle für In Progress- und Code Review-Tickets, einschließlich eines schmutzigen Worktrees, dessen Änderungen zu diesem Ticket gehören.
  • Erstelle neue Arbeit nur für berechtigte Tickets ohne übernommene Arbeit.
  • Erstelle einen abhängigen Branch vom verifizierten eingereichten Remote-Head seiner Voraussetzung.
  • Richte einen abhängigen PR auf diesen Voraussetzungsbranch aus, sodass der PR nur das Delta seines Tickets enthält. Zeichne die gestapelte Herkunft auf.
  • Verwende einen bestehenden Korrektur-PR-Quellbranch und PR erneut. Erstelle nur einen Checkout dieses genauen Branches neu, wenn sein alter Worktree unbrauchbar ist.
  • Setze niemals zurück, bereinige, stash, force-push oder überschreibe unterbrochene Arbeit, nur um die Einrichtung zu vereinfachen.
  • Ordne überlappende Schreibflächen sequenziell an oder erstelle einen dedizierten Integrations-Ticketbranch.

Ein eingereichter Voraussetzungsbranch ist ausreichend für die nachgelagerte Implementierung, lokale Verifizierung und Einreichung ...

[truncated for translation]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills