Communitygithub.com

MarkTripoli/skills

Centraliser les décisions de livraison liées aux tickets et déléguer l'exécution via des branches de tickets isolées et reprises, en utilisant le développement itératif vidéo.

Qu'est-ce que skills ?

Cette compétence, Video-Iterative Orchestration, transforme un epic Jira, une file d'attente GitHub ou une liste de tickets en une file de livraison durable. Chaque ticket reçoit un agent d'implémentation dédié avec un espace de travail exclusif. L'orchestrateur conserve l'autorité décisionnelle sur la portée, les dépendances et la validation, tandis que les agents exécutent le contrat via le développement itératif vidéo. Elle gère les interruptions, la reprise du travail, la validation des preuves et l'intégration avec Slack pour la coordination. Prend en charge les modes de livraison et de correction, et s'intègre avec Figma pour l'inspiration visuelle.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Lisez le guide d'écriture et les conventions de la collection avant de rédiger, réviser ou répondre ; une extraction de la collection contient les deux sous shared/.

Orchestration Itérative Vidéo

Type de Compétence : Rigide — préservez la portée du ticket, le travail interrompu, la filiation des dépendances et les portes de preuve. Les échecs ordinaires entrent en récupération ; ils ne mettent pas fin à une tentative d'implémentation.

Objectif et propriété

Transformez un epic Jira, une file d'attente de tickets GitHub, ou une liste de prérequis explicite, éventuellement réduite à des tickets nommés, en une file de livraison durable. Chaque ticket ou correction sélectionné reçoit un agent d'implémentation exclusif et un espace de travail (worktree). Avant l'envoi, l'orchestrateur sélectionne la portée (backend uniquement, frontend uniquement, ou cross-layer) et fournit un contrat d'exécution complet. Chaque agent d'implémentation utilise le video-iterative-development pour exécuter ce contrat et produire sa soumission vérifiée.

L'orchestrateur délègue l'exécution, pas l'autorité décisionnelle. Il possède exclusivement l'interprétation de la source, la portée du ticket, le comportement du produit, la sélection du dépôt et de la couche, l'ordre des dépendances, la topologie des branches et des PRs, les déviations, la gestion des blocages, l'état du cycle de vie, l'acceptation finale, et le rapport sur les tickets. Il invoque plutôt que de réécrire ses compagnons :

  • resume-and-reconcile.md possède la découverte du travail interrompu et la détection des modifications de source mappée.
  • extract-figma-visuals possède la sélection de la hiérarchie Figma, l'exportation et la validation du bundle.
  • feature-conformance possède l'autorité de la source, les registres de décisions, la traçabilité, et la validation de la revendication de livraison.
  • video-iterative-development possède l'implémentation assignée, les mécanismes de récupération, les preuves, et la soumission. Il renvoie des observations et des demandes de décision structurées ; il ne modifie pas le contrat d'exécution ni n'assigne d'états de livraison.
  • agent-implementation-reviewer possède un rapport indépendant en lecture seule du plan à la différence (diff). L'orchestrateur applique l'adaptateur de contrat de fonctionnalité sans modifier ce réviseur partagé.
  • La revue de guidage technique examine la différence finale par rapport aux conventions applicables du dépôt. Il enregistre les conséquences concrètes et les exceptions justifiées sans transformer les préférences en nouvelles exigences de ticket.

Autorité décisionnelle

Une décision consécutive est tout choix qui modifie l'interprétation de la source, la portée, le comportement du produit ou de la conception, les dépôts ou couches participants, l'ordre des dépendances, la topologie des branches ou des PRs, les preuves requises, une déviation approuvée, la gestion des blocages, ou l'état final du ticket. L'orchestrateur prend et enregistre chaque décision consécutive avant l'envoi ou en réponse à une requête du travailleur. Les résolutions de source automatiques autorisées par cette compétence sont également des décisions de l'orchestrateur.

Les agents d'implémentation peuvent choisir uniquement des mécanismes réversibles et conventionnels pour le dépôt qui laissent le contrat d'exécution inchangé, tels que l'organisation locale du code, l'ordre des commandes, les détails déterministes des sélecteurs, ou la manière de diagnostiquer et de réessayer un échec dans le périmètre. Lorsque les instructions sont incomplètes, contradictoires ou nécessitent un choix consécutif, le travailleur ne doit pas deviner, étendre le périmètre, contacter le demandeur, ou s'assigner un état terminal. Il renvoie une decision_request structurée à l'orchestrateur et continue tout le travail assigné non affecté.

Entrées

  • Une clé/lien d'epic Jira, une file d'attente de tickets GitHub, ou une liste de prérequis prioritaire explicite. Résolvez la file sélectionnée à partir de la demande ; n'exigez pas Jira pour une exécution GitHub ou indépendante du tracker.
  • Pour le mode correction, un document Markdown de constatations en lecture seule.
  • Les racines des dépôts lorsqu'elles ne peuvent pas être découvertes à partir de l'espace de travail.
  • Un document de conception ou un lien en lecture seule optionnel. L'architecture est un sous-type de document, pas une catégorie d'entrée séparée.
  • Des liens optionnels en lecture seule vers des frames racines Figma contenant node-id pour les tickets UI applicables.
  • Une demande optionnelle de coordonner l'exécution via Slack, incluant un canal nommé explicitement ou une demande explicite d'exécution par message direct. Sans l'une ou l'autre destination, slack-coordinator utilise le dépôt par défaut.
  • Toute autorité externe ou date limite explicite.

Ne demandez pas d'ID de fonctionnalité, de fichier de contrat, de drapeau d'approbation, de révision Figma, ou de classification de couche. L'absence de contexte optionnel Figma ou de document de conception n'est pas un blocage.

Lorsque la coordination Slack est demandée, invoquez slack-coordinator directement dans le cadre de l'orchestration ; ne créez pas d'agent ou de volet Slack séparé. Utilisez une seule exécution et un seul fil Slack pour l'orchestration. L'orchestrateur est le seul interlocuteur Slack et le seul consommateur de son run_id ; les agents d'implémentation rapportent à l'orchestrateur et n'appellent jamais le coordinateur ni ne consomment eux-mêmes les entrées du propriétaire.

Après la prise en charge en lecture seule qui résout l'epic et les tickets sélectionnés, inspectez un registre existant pour trouver un run_id actif du coordinateur. Reprenez cette exécution si elle est présente. Sinon, confirmez que l'exécutable est disponible et appelez run start avant la première action modifiant l'état, en utilisant l'epic comme travail, le résultat demandé comme objectif, et les tickets sélectionnés comme périmètre. Passez --channel uniquement pour le canal explicitement nommé dans l'instruction actuelle, passez --dm uniquement lorsque le demandeur demande explicitement une exécution par message direct, et autrement laissez le coordinateur utiliser le dépôt par défaut. Enregistrez le run_id, le canal, l'horodatage du fil, et le permalien retournés dans le registre à sa première écriture autorisée. Ne démarrez jamais une deuxième exécution du coordinateur simplement parce qu'un ticket démarre, reprend, réessaie, ou change de propriétaire.

Exécutez run check immédiatement avant chaque action de l'orchestrateur modifiant l'état et immédiatement avant chaque envoi ou suivi qui autorise le travail d'implémentation. Un code de sortie 0 permet l'action. En cas de sortie 10, appliquez, répondez ou rejetez l'entrée du propriétaire avec run resolve, puis vérifiez à nouveau. En cas de sortie 11, faites une pause, réessayez après une courte attente, et rapportez la raison ; ne mutez jamais l'état, n'envoyez pas de travail, et ne retombez pas sur un autre chemin Slack lorsque la coordination est indisponible. La sortie 12 est la décision explicite de l'opérateur de contournement (break-glass) et permet à l'exécution de continuer sans autres appels Slack.

Utilisez run event pour les changements de phase d'orchestration, les changements de cycle de vie du ticket, et les débuts ou fins de blocage ; le daemon possède les republications de statut des intervalles calmes. Appelez run finish une fois lorsque l'orchestration atteint son résultat terminal (terminé, échoué, ou annulé). Suivez les contrats de commande, de sélection de canal, de message et d'échec de la compétence autonome plutôt que de les réécrire ou de les affaiblir ici. Lorsque la coordination Slack n'a pas été demandée, ne démarrez pas d'exécution et n'ajoutez pas de portes Slack.

Sélectionnez le mode d'exécution

Utilisez le mode livraison sans constatations : lisez le workflow de livraison Jira pour Jira, ou le mode livraison pour les files GitHub et indépendantes du tracker. Utilisez le mode correction lorsque la file sélectionnée inclut un document de constatations. Lisez le workflow de correction.

Dans les deux modes, exécutez la reprise et la réconciliation des sources avant de créer un espace de travail. Pour Jira, le statut est décisif : En cours et Revue de code sont resume_required et doivent adopter le travail existant plutôt que de partir de la base.

Périmètre du ticket et autorité de conception

Les exigences et critères d'acceptation du ticket sélectionné définissent la limite du travail. L'epic fournit le contexte d'appartenance, d'ordre et de dépendances ; on ne suppose jamais qu'il contient tous les comportements représentés dans Figma ou un document de conception. Mappez uniquement les nœuds Figma et les sections de document qui clarifient un ticket sélectionné. Le contenu de conception non mappé est du contexte, pas un travail manquant, différé ou hors périmètre.

Dans la limite du ticket :

  1. Figma mappé est l'autorité par défaut pour le comportement visuel et interactif, y compris les détails ambigus ou contradictoires du ticket ;
  2. Figma mappé remplace automatiquement un document de conception en conflit ;
  3. sans Figma applicable, un document de conception mappé résout les détails ambigus du ticket ;
  4. les conventions du dépôt et de l'API résolvent les détails d'implémentation restants.

Enregistrez chaque résolution automatique dans .agent-evidence/orchestration/<run-id>/decision-log.md. Ne mettez en pause que le ticket affecté pour les rares choix non résolus dont les alternatives modifient matériellement le périmètre du produit ou le comportement de l'utilisateur. Un départ explicitement approuvé des sources faisant autorité est une approved_deviation ; les décisions d'implémentation ordinaires et les résolutions Figma ne sont pas des déviations.

Créez un manifeste de document de conception au niveau de l'exécution à .agent-evidence/orchestration/<run-id>/design-documents/manifest.json. Il enregistre l'identité de la source, le SHA-256 du document entier, et les ID stables, titres et valeurs SHA-256 uniquement pour les sections mappées aux tickets sélectionnés. feature-conformance référence ce manifeste ; il n'en crée pas un autre.

Pour chaque racine UI fournie, invoquez extract-figma-visuals avant l'envoi et passez son bundle validé aux travailleurs applicables. Une source Jira, Figma, ou de document de conception fournie qui reste illisible après des vérifications d'accès et des tentatives matériellement différentes bloque uniquement le ticket affecté. Ne substituez jamais un contenu obsolète, une maquette recréée, ou des exigences supposées.

Établir l'état de l'exécution

Avant l'envoi :

  1. Créez ou continuez un objectif pour le travail de l'epic sélectionné. Gardez-le actif tant qu'un ticket a un travail récupérable ou indépendant.
  2. Inspectez les directives du dépôt, le statut actuel, les espaces de travail, les branches de tickets, les PRs ouvertes, les règles de code généré, et les commandes de vérification documentées. Pour une PR existante, identifiez son espace de travail source et la raison si cet espace de travail est inutilisable. Pour un travail cross-layer, résolvez la configuration de lancement composée documentée des dépôts participants en sa topologie de processus complète : chaque commande, argument, répertoire de travail, source d'environnement, ordre de dépendance, port, sonde de santé/fonctionnalité, étape de migration/fixture, étape de génération de client, définition d'exécution, et commande Android Patrol. Passez l'espace de travail sélectionné, les commandes de vérification et la topologie résolue à l'agent d'implémentation. Un composé IDE documenté dans le dépôt est une définition de topologie, pas une instruction pour invoquer l'IDE.
  3. Résolvez les tickets et les dépendances via l'interface authentifiée du tracker sélectionné, puis exécutez la reprise/la réconciliation des sources. Jira utilise Jira MCP ; une exécution GitHub ou basée sur une liste explicite préserve sa propre autorité de périmètre et de statut.
  4. Extrayez et validez les bundles Figma applicables. Créez le manifeste de document de conception unique lorsqu'il est fourni.
  5. Invoquez feature-conformance en mode pré-vol. Réparez les erreurs de schéma ou de mappage générées par l'agent et relancez-le ; ne les présentez pas comme des blocages de ticket.
  6. Résolvez le répertoire de tâches explicite ou la racine de tâches configurée. Utilisez des reçus indexés immuables comme décrit ci-dessous. Créez un registre ignoré, decision-log.md, et les caches reconstruisibles resume-state.json et source-index.json. Jira, Git, les PRs, les manifestes actuels et les lectures de source actuelles restent autoritaires lorsque les caches sont absents ou obsolètes.
  7. Construisez la table des dépendances et enregistrez le propriétaire, la portée sélectionnée et les couches inchangées, la surface d'écriture adoptée ou nouvelle, la cible de la PR, les mappages de source, les lignes du contrat, les décisions de l'orchestrateur, la porte de preuve, l'état du bail d'exécution canonique, l'état de récupération, et l'état final. Lorsque la coordination Slack est activée, enregistrez également son run_id, canal, horodatage du fil, permalien, et état de coordination actuel au niveau de l'exécution.

Utilisez les états machine canoniques snake_case : 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, et blocked.

Préserver les enregistrements et les preuves indexés

index.json est autoritaire pour les artefacts de la tâche. Enregistrez les reçus de contrat en tant que feature-contract (design.contract), la conformité en tant que feature-conformance (review.conformance), les blocages proposés en tant que delivery-disposition (delivery.disposition), et les reçus de soumission vérifiée en tant que submission-closure (delivery.closure). Allouez une nouvelle itération immuable pour chaque révision durable, en liant son chemin/hash exact du snapshot JSON, son ticket, son en-tête de source et son enregistrement de contrat/revision pertinent. Sélectionnez et validez par digest les enregistrements actuels avant de les utiliser ; les index invalides ne tombent jamais dans des analyses. Utilisez l'assistant optionnel d'artefact de tâche adjacent ou les conventions manuelles exactes. Seules les tâches héritées véritablement non indexées utilisent des enregistrements numérotés.

Le registre d'exécution, l'inventaire de reprise et l'index source sont des caches opérationnels reconstruisibles, pas des remplacements pour les reçus d'acceptation ou de revision immuables. Les bundles visuels bruts et les captures restent des preuves locales exclues. Le corps de la PR GitHub, un commentaire de preuve distinct, une capture hébergée directe et une relecture de l'en-tête actuel restent l'autorité de publication ; n'affaiblissez jamais les hooks de publication installés ou les exigences de preuve de base/actuelle.

Isoler et empiler le travail du ticket

Donnez à chaque agent d'implémentation actif un espace de travail et une branche exclusifs dans chaque dépôt qu'il modifie. Ne partagez jamais une extraction mutable et ne jetez pas les modifications interrompues.

  • Adoptez la source sélectionnée pour les tickets En cours et Revue de code, y compris un espace de travail sale dont les modifications appartiennent à ce ticket.
  • Créez un nouveau travail uniquement pour les tickets éligibles sans travail adopté.
  • Créez une branche dépendante à partir de l'en-tête distant vérifié soumis de son prérequis.
  • Ciblez une PR dépendante vers cette branche prérequise afin que la PR ne contienne que le delta de son ticket. Enregistrez la filiation empilée.
  • Réutilisez une branche source et une PR de correction existantes. Recréez uniquement une extraction de cette branche exacte lorsque son ancien espace de travail est inutilisable.
  • Ne réinitialisez, nettoyez, stash, forcez l'envoi, ou ne réécrivez jamais le travail interrompu simplement pour simplifier la configuration.
  • Séquencez les surfaces d'écriture qui se chevauchent ou créez une branche de ticket d'intégration dédiée.

Une branche prérequise soumise est suffisante pour l'implémentation en aval, la vérification locale et la soumission.

…

[tronqué pour la traduction]

Individual skills in this repo

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

Skills associés