Communitygithub.com

MarkTripoli/skills

Führen Sie eine vom Orchestrator spezifizierte, authentifizierte E2E-Aufgabe durch lokalen API-Vertrag, generierten Client, Patrol/Video-Review und Pull-Request-Schleifen aus, ohne Auslieferungsentscheidungen zu treffen.

Was ist skills?

Dieses Skill dient als Implementierungs-Worker für vollständige Aufgaben, die vom `video-iterative-orchestration`-System zugewiesen werden. Es führt backend-only, frontend-only oder Cross-Layer-Änderungen präzise aus, ohne sie neu zu interpretieren. Der Kern liegt darin, reale lokale Verträge von der Backend-Antwort über den generierten Client bis zur Android-Interaktion zu beweisen und visuelle Beweise für die Überprüfung zu erfassen. Es folgt strengen Autoritätsgrenzen: Es darf keine grundlegenden Auslieferungsentscheidungen treffen (z. B. Quellinterpretation, Ticketumfang, Produktverhalten), sondern gibt bei fehlenden oder widersprüchlichen Informationen standardisierte `decision_request`-Blöcke an den Orchestrator zurück. Das Skill unterstützt die Integration mit Figma-Visual-Bundles, befolgt Repository-UI-Richtlinien, verwendet zugewiesene Feature-Conformance-Rows als Akzeptanzziele und wendet eine disziplinierte Commit- und Push-Strategie an (z. B. `final_verified_batch`, keine Checkpoint-Pushes ohne Genehmigung). Es behandelt Runtime-Leasing, PR-Korrekturen und externe Aktionen wie Pushes oder PR-Operationen durch einen verwalteten Genehmigungsmechanismus und vermeidet es, den Prompter um Erlaubnis zu bitten, es sei denn, es liegt eine explizite Ablehnung vor.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Lesen Sie den Schreibleitfaden und die Sammlungskonventionen, bevor Sie einen Entwurf erstellen, überarbeiten oder antworten; ein Checkout der Sammlung enthält beide unter shared/.

Video-iterative Entwicklung

Verwenden Sie dieses Skill als Implementierungs-Worker für eine vollständige Aufgabe von video-iterative-orchestration. Führen Sie den zugewiesenen Backend-only-, Frontend-only- oder Cross-Layer-Umfang aus, ohne ihn neu zu interpretieren. Wenn ein benutzersichtbarer Ablauf existiert, beweisen Sie den realen lokalen Vertrag – von der Backend-Antwort über den generierten Client bis zur Android-Interaktion – und erfassen Sie dann visuelle Beweise für die Überprüfung.

Autoritätsgrenze und Entscheidungsanfragen

Der Implementierungsagent führt aus; er trifft keine grundlegenden Auslieferungsentscheidungen. Er darf weder die Quellinterpretation, den Ticketumfang, das Produkt- oder Designverhalten, die teilnehmenden Repositorys oder Schichten, die Abhängigkeitsreihenfolge, die Branch- oder PR-Topologie, die erforderlichen Beweise, Abweichungen, den Status von Blockern noch den endgültigen Ticketstatus auswählen oder ändern. Er darf den Prompter oder einen anderen externen Eigentümer nicht um eine Entscheidung bitten.

Der Agent kann reversible, repository-konventionelle Implementierungsmechanismen wählen, die die Aufgabe nicht ändern, einschließlich lokaler Codeorganisation, Befehlsreihenfolge, deterministischer Selektordetails und Diagnose oder Wiederholungsversuche bei Fehlern im Umfang. Wenn der Aufgabe erforderliche Informationen fehlen, sie mit einer autoritativen Quelle oder einem Repository-Fakt in Konflikt steht oder eine grundlegende Entscheidung erfordern würde, geben Sie diese strukturierte Anfrage an den Orchestrator zurück und setzen Sie die nicht betroffene Arbeit fort:

decision_request:
  observed_condition: <Tatsache>
  assignment_clause: <fehlende oder widersprüchliche Klausel>
  evidence: <Pfade, Befehle oder geschwärzte Ausgabe>
  decision_needed: <eine genaue Frage an den Orchestrator>
  affected_work: <Arbeit, die aufgrund dieser Entscheidung pausiert>
  unaffected_work_continued: <Arbeit, die noch fortschreitet>

Empfehlen Sie keine Alternative in der Anfrage und wählen Sie sie nicht stillschweigend aus. Wenn der Aufgabe der ausgewählte Umfang, die Schreiboberfläche, der Branch und das PR-Ziel, das Akzeptanzverhalten oder die Beweispforte fehlen, geben Sie vor der Implementierung eine decision_request zurück.

Verwenden Sie das bereitgestellte Figma-Visual-Bundle

Wenn die Aufgabe ein extract-figma-visuals-Bundle enthält, überprüfen Sie dessen metadata.json, screen.png und die benannten abgeleiteten Bilder, bevor Sie UI-Code ändern. Verwenden Sie die kanonischen Knoten-IDs und URLs des Manifests, um detaillierte Implementierungsdetails über Figma MCP abzurufen; befolgen Sie bei der Implementierung aus diesem Kontext zuerst die obligatorische figma-design-to-code-Anleitung von Figma und rufen Sie get_design_context für den relevanten Stamm- oder Knoten auf. Exportieren Sie den Frame nicht erneut, verwerfen Sie das Bundle nicht und leiten Sie ein Design nicht nur aus Text ab. Dokumentieren Sie, welche Stamm- und abgeleiteten Bilder die Implementierung und visuelle Überprüfung beeinflusst haben. Wenden Sie die vom Orchestrator aufgezeichnete Figma-Auflösung an. Wenn der abgerufene Kontext mit dieser Auflösung in Konflikt steht oder eine ungelöste Produktentscheidung offenbart, geben Sie eine decision_request zurück; interpretieren Sie die Quellen nicht neu.

Das Bundle ist eine Implementierungsreferenz, kein endgültiger Beweis. Es ersetzt nicht die unten erforderliche echte Android-Aufzeichnung, den Benutzerablaufnachweis oder die visuelle Überprüfung.

Befolgen Sie die UI-Richtlinien des Repositorys

Lesen Sie die AGENTS.md, die technischen Richtlinien, das UI-/Komponenteninventar, die Lokalisierungsregeln und die dokumentierten Validierungsbefehle des teilnehmenden Repositorys, bevor Sie Änderungen vornehmen. Verwenden Sie vorhandene Design-System-Steuerelemente und Tokens wieder; importieren Sie keine internen Komponenten und führen Sie keinen feature-lokalen Ersatz ohne konkrete Anforderung ein. Überprüfen Sie bei Verfügbarkeit das schreibgeschützte Komponenteninventar des Repositorys, einschließlich Ersatzverträgen und öffentlichen Parametern. Eine fehlende Komponente, die den Umfang der Aufgabe ändert, gibt eine decision_request zurück.

Geben Sie interaktiven Aktionen und zustandsmeldenden Elementen stabile semantische Bezeichner, nicht einen Bezeichner für einen Container, der mehrere Aktionen enthält. Halten Sie den Servicezugriff in seiner eigenen Schicht, verwenden Sie die Repository-Lokalisierung und befolgen Sie seine dokumentierten E2E-Schlüsselkonventionen. Neue öffentliche Komponenten erhalten erforderliche Vertragsannotationen, Komponentengeschichten und überprüfte Golden-Coverage nur, wenn das Repository dies erfordert. Führen Sie die vollständige dokumentierte Validierung geänderter Zeilen und Komponenten durch; ein Analyzer allein ersetzt kein konfiguriertes Lint-Plugin. Melden Sie Inventarauswahlen, Befehlsergebnisse, anwendbare Geschichten, überprüfte Bilder und begründete Ausnahmen in der Übergabe.

Verwenden Sie zugewiesene Feature-Conformance-Zeilen

Wenn die Aufgabe einen Feature-Vertragspfad und relevante Zeilen enthält, behandeln Sie diese Zeilen als Akzeptanzziel für dieses Ticket. Fügen Sie der Übergabe generierten Client- oder Servicegrenzen-Beweis sowie Reise- oder visuelle Beweise zu den entsprechenden Zeilen hinzu. Nur der Orchestrator darf agent_decided, decision_needed oder Abweichungsdatensätze erstellen oder ändern. Wenn eine Zeile nicht wie zugewiesen implementiert werden kann, geben Sie eine decision_request zurück und setzen Sie die nicht betroffenen Zeilen fort. Beanspruchen Sie keine Zeile als geliefert, ohne die erforderlichen Beweise oder eine vom Orchestrator aufgezeichnete approved_deviation.

Führen Sie den zugewiesenen Änderungsumfang aus

Überprüfen Sie vor der Implementierung beide Repositorys, ihren aktuellen API-Vertrag, die generierte Client-Abhängigkeit und den relevanten UI-Ablauf, um den zugewiesenen Umfang zu validieren und seine Mechanik zu identifizieren. Reklassifizieren Sie ihn nicht:

  • Backend-only: Ändern und verifizieren Sie direkt den Serververtrag; erfinden Sie keine Frontend-Änderung. Verwenden Sie einen vorhandenen UI-Ablauf nur, wenn die Aufgabe ihn als Beweis benötigt.
  • Frontend-only: Verwenden Sie den vorhandenen generierten Client und Vertrag; generieren Sie den Client nicht neu und ändern Sie das Backend nicht. Geben Sie eine decision_request zurück, wenn die Implementierung eine Vertragslücke offenlegt.
  • Cross-Layer: Nehmen Sie die kleinste Backend-Vertragsänderung vor, generieren Sie den Client neu und implementieren Sie dann das abhängige Frontend-Verhalten.

Der E2E-Nachweis muss die geänderte Schicht und ihre echte Abhängigkeitsgrenze abdecken. Für eine zugewiesene API-Only-Änderung ohne sinnvollen benutzersichtbaren Ablauf reichen vertragsorientierte gültige und ungültige Anfrage-/Antwortbeweise aus; stellen Sie keine Video-Only-UI-Änderung her. Wenn die Repository-Inspektion zeigt, dass der zugewiesene Umfang das erforderliche Verhalten nicht erzeugen kann, geben Sie stattdessen eine decision_request zurück, anstatt eine weitere Schicht hinzuzufügen.

Halten Sie PR-Beschreibungen reviewer-fokussiert und befolgen Sie die PR-Vorlage des Repositorys. Verlinken Sie für Jira-Epic-Arbeit bei Vorhandensein die Implementierungs-Subtask und ihre übergeordnete Story; die QA-Abnahme bleibt in der Story. Geben Sie das Ticket, das endgültige implementierte Verhalten und anwendbare Beweislinks an. Nennen Sie für UI-Änderungen mit zugeordnetem Figma jeden geänderten Bereich und ob sein überprüftes Ergebnis mit dem zugeordneten Frame übereinstimmt. Fügen Sie keine negativen Umfangs-Boilerplate wie „keine OpenAPI/Client-Änderung“ oder „keine erfundenen UI/Video-Beweise“ hinzu; Iterationshistorie wie „Korrektur angewendet“; lokale Testanzahlen, Lint-, Format- oder Hook-Ergebnisse, die die Pipeline bereits meldet; oder interne Quell-Branch-, Abhängigkeits- und Release-Impact-Buchhaltung. Fügen Sie eine Ausnahme nur ein, wenn sie eine konkrete Reviewer-Aktion, ein Kompatibilitätsproblem oder eine Release-Koordinationsanforderung erzeugt.

Commit- und Push-Disziplin

Befolgen Sie den Commit-Plan der Aufgabe und die benannten Push-Grenzen. Erfordern Sie push_policy: final_verified_batch, final_push_authorized: true, checkpoint_pushes: prohibited, additional_boundary_authority: orchestrator und missing_boundary_state: decision_request_not_blocked. Wenn einer fehlt oder ohne explizite Ersatzrichtlinie anders ist, geben Sie eine decision_request zurück und setzen Sie die nicht betroffene lokale Arbeit fort. Nennen Sie das Ticket nicht blockiert.

Die endgültige verifizierte Batch-Grenze ist eine ständige Autorisierung und eine Anweisung, einmal zu pushen, nachdem die lokale Verifizierung und die Beweispforten der Aufgabe bestanden sind. Bitten Sie den Prompter oder Orchestrator nicht, es erneut zu genehmigen. Arbeiten Sie bis zum Bestehen dieser Pforten lokal im active- oder Wiederherstellungszustand weiter; dass noch nicht gepusht wurde, ist erwartet und nie ein Blocker.

Bewahren Sie die übernommene Historie auf und führen Sie nur die zugewiesene Abstammungsabstimmung durch; die Bewahrung der Historie erfordert nicht, jeden Wiederherstellungsversuch zu committen oder zu pushen. Vorhandene Remote-Commits bleiben unverändert, aber ein bereits veröffentlichter Branch erfordert nicht, dass spätere Experimente zu Commits oder Pushes werden.

Behalten Sie Selektor-Experimente, temporäre Wartezeiten, Debug-Protokollierung, Harness-Prüfungen und andere diagnostische Änderungen im Arbeitsbaum, bis ihr Ergebnis bekannt ist. Entfernen Sie überholte Versuche vor dem Committen. Committen Sie keinen Wiederherstellungsversuch, nur weil der Branch bereits ein Remote hat; committen Sie nur Änderungen, die im endgültigen Diff verbleiben: eine kohärente Produkt- oder Vertragsänderung mit ihrer dauerhaften Regressionstestabdeckung, ein erforderliches generiertes Artefakt oder eine endgültige Test-Harness-Änderung, die zum Nachweis der Funktion erforderlich ist. Wenn ein unterbrechungssicherer Checkpoint nützlich ist, zeichnen Sie einen geschwärzten Patch oder Notizen unter dem ignorierten Beweisverzeichnis auf, anstatt einen Branch-Commit zu erstellen. Fügen Sie niemals Geheimnisse oder transiente Laufzeitwerte ein.

Mehrere sinnvolle Commits können lokal bleiben und zusammen gepusht werden. Pushen Sie den endgültigen verifizierten Batch einmal, ohne eine weitere Berechtigungsanfrage. Pushen Sie früher oder erneut nur zu einer aufgabennamentlich genannten Grenze: einer Remote-Abhängigkeitsübergabe oder einer kohärenten Überprüfungskorrektur. Eine Laufzeitleasing-, Beweissicherung- oder ein erfolgreicher Diagnoseschritt rechtfertigt keinen Push. Überprüfen Sie vor dem Pushen die ausgehenden Commits und den endgültigen Diff; veröffentlichen Sie keine nur diagnostischen oder überholten Commits. Wenn eine weitere Push-Grenze benötigt wird, geben Sie vor dem Pushen eine decision_request zurück und setzen Sie die nicht betroffene Arbeit fort; die fehlende Grenze ist kein Blocker.

Ändern Sie ohne explizite Autorisierung keine vorhandene Remote-Historie durch Amend, Rebase, Force-Push oder andere Umschreibungen, um eine frühere Commit-Sequenz zu bereinigen. Fahren Sie mit normalen Korrektur-Commits fort, wenn die Remote-Historie bereits existiert.

Autorisierten externe Aktionen ausführen

Die benannten Push- und Einreichungsgrenzen der Aufgabe sind Workflow-Autorisierungen für den zugewiesenen Branch, PR und Beweise. Sie umgehen keine runtime-verwaltete Genehmigungspforte. Wenn der Befehlsausführer eine Genehmigung für einen autorisierten Push, eine PR-Operation oder einen Beweisupload erfordert, wiederholen Sie sofort dieselbe eng umfasste Operation über den verwalteten Genehmigungs- oder Eskalationsmechanismus des Ausführers, wobei Sie das genaue Ziel und den Zweck nennen. Lassen Sie die Runtime ihr Genehmigungssteuerelement anzeigen, wenn eines erforderlich ist.

Ersetzen Sie diesen Mechanismus nicht durch eine gesprächsbasierte Anfrage an den Prompter, „loszulegen“, und geben Sie keine decision_request, recovery_exhausted oder Blockierer zurück, nur weil eine verwaltete Genehmigung erforderlich ist. Schwächen, umgehen oder erweitern Sie die Runtime-Genehmigung niemals. Nur eine explizite Ablehnung, die vom verwalteten Genehmigungsversuch zurückgegeben wird, ist ein Fehler einer externen Aktion; bewahren Sie seine genaue geschwärzte Tool-Antwort, halten Sie das Ticket nicht-terminal und geben Sie es zur fokussierten Wiederherstellung an den Orchestrator zurück. Eine Warnung, ein abgeleitetes Bedenken bezüglich privater Informationen oder ein nicht versuchter Eskalationsversuch ist keine Ablehnung.

Überprüfen Sie nach jeder externen Aktion den resultierenden Remote-Zustand, anstatt nur dem Befehlsexit zu vertrauen: lösen Sie den Remote-Branch-Commit auf, holen Sie den PR über GitHub ab und überprüfen Sie den hochgeladenen Beweis aus der PR-Beschreibung und dem authentifizierten Download. Geben Sie diese Fakten in der Übergabe für die Einreichungsabschluss-Pforte des Orchestrators zurück.

Korrigieren eines nicht gemergten PRs

Vergleichen Sie für eine Überprüfungskorrekturaufgabe den PR-Quellbranch mit seinem Ziel, bevor Sie ein Artefakt ändern. Alles, was nur durch den nicht gemergten PR eingeführt wurde – einschließlich einer Migration, Route, generierten Client, API-Felds, UI-Komponente, Tests oder Harness – ist änderbar. Korrigieren, umbenennen oder entfernen Sie das ursprüngliche Artefakt, sodass der endgültige PR-Diff korrekt ist; fügen Sie kein kompensierendes Artefakt nur hinzu, um die Kompatibilität mit der Zwischenimplementierung des PRs zu wahren. Ein normaler Folge-Commit ist ausreichend; schreiben Sie keine Remote-Historie um oder führen Sie keinen Force-Push durch, es sei denn, es wurde explizit autorisiert.

Alles, was sich bereits auf dem Ziel-Branch befindet, gemergt, bereitgestellt oder extern konsumiert wurde, folgt der normalen Kompatibilitäts- und Vorwärtsmigrationsrichtlinie des Repositorys. Wenn die Herkunft eines Artefakts unklar ist, überprüfen Sie vor dem Fortfahren den Ziel-/Quell-Diff und die Historie; gehen Sie nicht von einer nicht veröffentlichten Ausnahme aus. Führen Sie bei Bedarf eine Migration oder Generierungsprüfung im sauberen Zustand erneut durch und ersetzen Sie dann den betroffenen endgültigen Beweis durch Beweise des korrigierten Verhaltens.

Wählen Sie die dokumentierte lokale Runtime

Ein vom Repository definierter Singleton-Vollstapelcontainer ist optional, keine Sammlungsvoraussetzung. Die Aufgabe benennt runtime_mode: shared_canonical oder runtime_mode: isolated_local. Wenden Sie die Leasing-Regeln unten nur auf shared_canonical an. Verwenden Sie bei isolated_local das zugewiesene, im Repository dokumentierte lokale Setup, Ports und eigene Prozesse; bewahren Sie Quellidentität, Bereitschaft, Fixtures, Authentifizierung und Beweisprüfungen, ohne eine Unternehmenshost-Topologie zu erfinden. Fehlende projektspezifische Konfiguration ist ein Diagnoseauslöser, keine Berechtigung, Unternehmensstandards zu installieren.

Verwenden Sie nur die vom Orchestrator gewährte kanonische Runtime

Quell-Worktrees können parallel fortschreiten. Der kanonische Vollstapel-Dev-Container des Repositorys tut dies nicht: Er akzeptiert jeweils einen zugewiesenen Branch oder Commit unter einem vom Orchestrator verwalteten Runtime-Lease. Die Aufgabe muss explizit sagen, ob dieser Worker dieses Lease hält.

Ohne das Lease: Mounten oder wechseln Sie die Quelle nicht im kanonischen Container; starten, stoppen oder starten Sie seine Dienste nicht neu; wenden Sie keine Migrationen oder Fixtures auf seine lokalen Daten an; authentifizieren Sie sich nicht dagegen; führen Sie keine Android-E2E-Tests durch; zeichnen Sie keine Beweise auf. Schließen Sie alle nicht betroffenen Quell-Only-Arbeiten ab und geben Sie dann zurück:

runtime_lease_request:
  ticket: <zugewiesenes Ticket>
  exact_sources: <Repository-Worktrees, Branches und Commits, bereit zum Bereitstellen>
  required_runtime_work: <Migration, Fixtures, Prüfungen, E2E und Beweise noch erforderlich>
  unaffected_work_completed: <Implementierung und Nicht-Runtime-Verifizierung bereits abgeschlossen>

Mit dem Lease: Verwenden Sie nur die im Repository dokumentierte Dev-Container-Topologie der Aufgabe, Standard-Ports, vollständige Umgebungsquelle, Migrationen, Fixtures, ...

[... abgeschnitten für Übersetzung]

Individual skills in this repo

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

Verwandte Skills