Communitygithub.com

Développement Vidéo-itératif

Exécute une mission E2E authentifiée spécifiée par l'orchestrateur via des boucles de contrat API local, client généré, revue vidéo/Patrol et pull request sans prendre de décisions de livraison.

Qu'est-ce que Développement Vidéo-itératif ?

Cette compétence permet à un agent d'implémentation d'exécuter une mission complète (backend uniquement, frontend uniquement, ou cross-layer) assignée par un orchestrateur de développement vidéo-itératif. L'agent suit strictement le périmètre défini sans le réinterpréter, prouve le contrat local réel—de la réponse backend, au client généré, jusqu'à l'interaction Android—et capture des preuves visuelles pour révision. La compétence impose des limites claires : l'agent ne prend aucune décision de livraison conséquente (comme le choix de l'interprétation de la source, la portée du ticket, ou le comportement du produit) et doit demander une décision via un bloc `decision_request` lorsque des informations manquent ou qu'un conflit survient. Elle prend en charge les plateformes de développement vidéo-itératif telles que Claude Code, Cursor, ou Codex, et utilise des bundles Figma, des rails d'interface utilisateur de dépôt, des lignes de conformité de fonctionnalité, et un runtime canonique partagé pour garantir une preuve E2E fiable. L'accent est mis sur la discipline de commit et push, l'exécution d'actions externes autorisées, et la correction de PR non fusionnées sans réécriture d'historique.

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

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 ; un checkout de la collection contient les deux sous shared/.

Que fait Développement Vidéo-itératif ?

Utilisez cette compétence en tant qu'ouvrier d'implémentation pour une mission complète provenant de video-iterative-orchestration. Exécutez le périmètre assigné (backend uniquement, frontend uniquement, ou cross-layer) sans le réinterpréter. Lorsqu'un flux visible par l'utilisateur existe, prouvez le contrat local réel—de la réponse backend, à travers le client généré, jusqu'à l'interaction Android—puis capturez des preuves visuelles pour révision.

Limite d'autorité et demandes de décision

L'agent d'implémentation exécute ; il ne prend pas de décisions de livraison conséquentes. Il ne doit pas choisir ou modifier l'interprétation de la source, la portée du ticket, le comportement du produit ou du design, les dépôts ou couches participants, l'ordre des dépendances, la topologie de la branche ou de la PR, les preuves requises, les déviations, la disposition des bloqueurs, ou l'état final du ticket. Il ne doit pas demander au demandeur ou à un autre propriétaire externe de décider.

L'agent peut choisir des mécanismes d'implémentation réversibles et conventionnels du dépôt qui ne modifient pas la mission, y compris l'organisation locale du code, l'ordre des commandes, les détails des sélecteurs déterministes, et le diagnostic ou les tentatives pour les échecs dans le périmètre. Si la mission manque d'informations requises, entre en conflit avec une source autoritaire ou un fait du dépôt, ou nécessiterait un choix conséquent, retournez cette demande structurée à l'orchestrateur et continuez le travail non affecté :

decision_request:
  observed_condition: <fait>
  assignment_clause: <clause manquante ou conflictuelle>
  evidence: <chemins, commandes, ou sortie expurgée>
  decision_needed: <une question exacte pour l'orchestrateur>
  affected_work: <travail mis en pause à cause de cette décision>
  unaffected_work_continued: <travail toujours en cours>

Ne recommandez pas ou ne sélectionnez pas silencieusement une alternative dans la demande. Si la mission manque de son périmètre sélectionné, de sa surface d'écriture, de sa branche et cible de PR, de son comportement d'acceptation, ou de sa porte de preuve, retournez une decision_request avant l'implémentation.

Utilisez le bundle visuel Figma fourni

Lorsque la mission inclut un bundle extract-figma-visuals, inspectez ses metadata.json, screen.png, et les images descendantes nommées avant de modifier le code UI. Utilisez les identifiants de nœud canoniques et les URLs du manifeste pour récupérer les détails d'implémentation fins via Figma MCP ; lors de l'implémentation à partir de ce contexte, suivez d'abord les directives obligatoires figma-design-to-code de Figma et appelez get_design_context pour le nœud racine ou pertinent. Ne réexportez pas le cadre, ne jetez pas le bundle, et n'inférez pas le design à partir du texte seul. Enregistrez quelles images racine et descendantes ont informé l'implémentation et la revue visuelle. Appliquez la résolution Figma enregistrée par l'orchestrateur. Si le contexte récupéré entre en conflit avec cette résolution ou expose un choix de produit non résolu, retournez une decision_request ; ne réinterprétez pas les sources.

Le bundle est une référence d'implémentation, pas une preuve finale. Il ne remplace pas l'enregistrement Android réel, la preuve de flux utilisateur, ou la revue visuelle requise ci-dessous.

Suivez les rails UI du dépôt

Lisez AGENTS.md, les directives d'ingénierie, l'inventaire des composants UI, les règles de localisation, et les commandes de validation documentées du dépôt participant avant d'éditer. Réutilisez les contrôles et tokens du système de design public ; n'importez pas de composants internes ou n'introduisez pas de remplacement local de fonctionnalité sans un besoin concret. Inspectez l'inventaire des composants en lecture seule du dépôt lorsqu'il est disponible, y compris les contrats de remplacement et les paramètres publics. Un composant manquant qui modifie le périmètre de la mission retourne une decision_request.

Donnez aux actions interactives touchées et aux éléments de rapport d'état des identifiants sémantiques stables, pas un seul identifiant pour un conteneur contenant plusieurs actions. Gardez l'accès aux services dans sa couche propriétaire, utilisez la localisation du dépôt, et suivez ses conventions documentées de clé E2E. Les nouveaux composants publics reçoivent des annotations de contrat requises, des stories de composants, et une couverture dorée révisée uniquement lorsque le dépôt l'exige. Exécutez la validation complète documentée des lignes modifiées et des composants ; un analyseur seul ne remplace pas un plugin de lint configuré. Rapportez les sélections d'inventaire, les résultats de commandes, les stories applicables, les images révisées, et les exceptions justifiées dans le transfert.

Utilisez les lignes de conformité de fonctionnalité assignées

Lorsque la mission inclut un chemin de contrat de fonctionnalité et des lignes pertinentes, traitez ces lignes comme la cible d'acceptation pour ce ticket. Attachez la preuve du client généré ou de la frontière de service, et la preuve de parcours ou visuelle aux lignes correspondantes dans le transfert. Seul l'orchestrateur peut créer ou modifier les enregistrements agent_decided, decision_needed, ou de déviation. Si une ligne ne peut pas être implémentée comme assignée, retournez une decision_request et continuez les lignes non affectées. Ne revendiquez pas une ligne livrée sans sa preuve requise ou une approved_deviation enregistrée par l'orchestrateur.

Exécutez le périmètre de changement assigné

Avant l'implémentation, inspectez les deux dépôts, leur contrat API actuel, la dépendance du client généré, et le flux UI pertinent pour valider le périmètre assigné et identifier ses mécanismes. Ne le reclassifiez pas :

  • Backend uniquement : modifiez et vérifiez directement le contrat serveur ; n'inventez pas de changement frontend. Utilisez un flux UI existant uniquement lorsque la mission l'exige comme preuve.
  • Frontend uniquement : consommez le client généré et le contrat existants ; ne regénérez pas le client ou ne modifiez pas le backend. Retournez une decision_request si l'implémentation expose un écart de contrat.
  • Cross-layer : faites le plus petit changement de contrat backend, regénérez le client, puis implémentez le comportement frontend dépendant.

La preuve E2E doit couvrir la couche modifiée assignée et sa véritable frontière de dépendance. Pour un changement uniquement API assigné sans flux utilisateur visible significatif, une preuve de requête/réponse valide et invalide orientée contrat est suffisante ; ne fabriquez pas de changement UI uniquement vidéo. Si l'inspection du dépôt montre que le périmètre assigné ne peut pas produire le comportement requis, retournez une decision_request au lieu d'ajouter une autre couche.

Gardez les descriptions de PR axées sur le réviseur et suivez le modèle de PR du dépôt. Pour le travail d'epic Jira, liez la Sous-tâche d'implémentation lorsqu'elle est présente et son Histoire parente ; l'acceptation QA reste sur l'Histoire. Indiquez le ticket, le comportement final implémenté, et les liens de preuve applicables. Pour les changements UI avec Figma mappée, nommez chaque zone modifiée et si son résultat révisé correspond au cadre mappé. N'ajoutez pas de texte standard de périmètre négatif tel que « pas de changement OpenAPI/client » ou « pas de preuve UI/vidéo inventée » ; historique d'itération tel que « Correction appliquée » ; nombres de tests locaux, lint, format, ou résultats de hooks que le pipeline rapporte déjà ; ou administration interne de branche source, dépendance, et impact de release. Incluez une exception uniquement lorsqu'elle crée une action concrète pour le réviseur, une préoccupation de compatibilité, ou une exigence de coordination de release.

Discipline de commit et push

Suivez le plan de commit et les limites de push nommées de la mission. Exigez push_policy: final_verified_batch, final_push_authorized: true, checkpoint_pushes: prohibited, additional_boundary_authority: orchestrator, et missing_boundary_state: decision_request_not_blocked. Si l'un est absent ou différent sans politique de remplacement explicite, retournez une decision_request et continuez le travail local non affecté. N'appelez pas le ticket bloqué.

La limite finale de lot vérifié est une autorité permanente et une instruction de pousser une fois après que les portes de vérification locale et de preuve de la mission sont passées. Ne demandez pas au demandeur ou à l'orchestrateur de l'approuver à nouveau. Jusqu'à ce que ces portes soient passées, continuez à travailler localement en état active ou de récupération ; le fait de ne pas encore avoir poussé est attendu et n'est jamais un bloqueur.

Préservez l'historique adopté et effectuez uniquement la réconciliation de lignée assignée ; préserver l'historique ne nécessite pas de commiter ou pousser chaque tentative de récupération. Les commits distants existants restent inchangés, mais une branche déjà publiée n'exige pas que des expériences ultérieures deviennent des commits ou des pushes.

Gardez les expériences de sélecteur, les attentes temporaires, le débogage de log, les sondes de harnais, et autres modifications de diagnostic dans l'arbre de travail jusqu'à ce que leur résultat soit connu. Supprimez les tentatives remplacées avant de commiter. Ne commitez pas une tentative de récupération simplement parce que la branche a déjà un distant ; commitez uniquement les modifications qui restent dans le diff final prévu : un changement de produit ou de contrat cohérent avec sa couverture de régression durable, un artefact généré requis, ou un changement final de harnais de test nécessaire pour prouver la fonctionnalité. Lorsqu'un point de contrôle sûr contre les interruptions est utile, enregistrez un patch expurgé ou des notes sous le répertoire de preuve ignoré au lieu de créer un commit de branche. N'incluez jamais de secrets ou de valeurs d'exécution transitoires.

Plusieurs commits significatifs peuvent rester locaux et être poussés ensemble. Poussez le lot vérifié final une fois sans autre demande de permission. Poussez plus tôt ou à nouveau uniquement à une limite nommée par la mission : un transfert de dépendance distant ou une correction de révision cohérente. Le leasing d'exécution, la préservation de preuve, ou une étape de diagnostic réussie ne justifient pas un push. Avant de pousser, inspectez les commits sortants et le diff final ; ne publiez pas de commits uniquement de diagnostic ou remplacés. Si une autre limite de push est nécessaire, retournez une decision_request avant de pousser et continuez le travail non affecté ; la limite manquante n'est pas un bloqueur.

Ne modifiez pas, ne rebasez pas, ne forcez pas le push, ou ne réécrivez pas l'historique distant existant pour nettoyer une séquence de commits antérieure sans autorisation explicite. Continuez avec des commits de correction ordinaires lorsque l'historique distant existe déjà.

Exécutez les actions externes autorisées

Les limites de push et de soumission nommées de la mission sont une autorisation de workflow pour la branche, la PR, et la preuve assignées. Elles ne contournent pas une porte d'approbation gérée par l'exécution. Lorsque l'exécuteur de commande nécessite une approbation pour un push autorisé, une opération PR, ou un téléchargement de preuve, réessayez immédiatement cette même opération étroitement limitée via le mécanisme d'approbation ou d'escalade géré de l'exécuteur, en nommant la destination exacte et le but. Laissez l'exécution afficher son contrôle d'approbation lorsqu'il est requis.

Ne remplacez pas ce mécanisme par une demande conversationnelle au demandeur de dire « allez-y », et ne retournez pas une decision_request, recovery_exhausted, ou un bloqueur simplement parce qu'une approbation gérée est requise. N'affaiblissez jamais, ne contournez jamais, ou n'élargissez jamais l'approbation d'exécution. Seul un refus explicite retourné par la tentative d'approbation gérée est un échec d'action externe ; préservez sa réponse d'outil exacte expurgée, gardez le ticket non terminal, et retournez-le à l'orchestrateur pour une récupération ciblée. Un avertissement, une préoccupation d'information privée inférée, ou une escalade non tentée n'est pas un refus.

Après chaque action externe, vérifiez l'état distant résultant plutôt que de faire confiance à la sortie de commande seule : résolvez le commit de branche distant, récupérez la PR via GitHub, et vérifiez la preuve téléchargée à partir de la description de PR et du téléchargement authentifié. Retournez ces faits dans le transfert pour la porte de fermeture de soumission de l'orchestrateur.

Correction d'une PR non fusionnée

Pour une tâche de correction de révision, comparez la branche source de la PR avec sa cible avant de modifier un artefact. Tout ce qui est introduit uniquement par la PR non fusionnée—y compris une migration, route, client généré, champ API, composant UI, test, ou harnais—est mutable. Corrigez, renommez, ou supprimez l'artefact original pour que le diff final de la PR soit correct ; n'ajoutez pas un artefact compensateur uniquement pour préserver la compatibilité avec l'implémentation intermédiaire de la PR. Un commit de suivi normal est suffisant ; ne réécrivez pas l'historique distant ou ne forcez pas le push sauf autorisation explicite.

Tout ce qui est déjà sur la branche cible, fusionné, déployé, ou consommé extérieurement suit la politique normale de compatibilité et de migration directe du dépôt. Si l'origine d'un artefact n'est pas claire, inspectez le diff cible/source et l'historique avant de procéder ; ne supposez pas une exception non publiée. Réexécutez les vérifications de migration ou de génération en état propre si applicable, puis remplacez la preuve finale affectée par une preuve du comportement corrigé.

Sélectionnez le runtime local documenté

Un conteneur full-stack singleton défini par le dépôt est optionnel, pas un prérequis de la collection. La mission nomme runtime_mode: shared_canonical ou runtime_mode: isolated_local. Appliquez les règles de leasing ci-dessous uniquement à shared_canonical. Avec isolated_local, utilisez la configuration locale documentée du dépôt assigné, les ports et les processus propriétaires ; préservez l'identité source, l'état de préparation, les fixtures, l'authentification, et les vérifications de preuve sans inventer une topologie d'hôte d'entreprise. Une configuration manquante spécifique au projet est un déclencheur de diagnostic, pas une permission d'installer les valeurs par défaut de l'entreprise.

Utilisez uniquement le runtime canonique accordé par l'orchestrateur

Les arbres de travail source peuvent progresser en parallèle. Le conteneur de développement full-stack canonique du dépôt ne le fait pas : il accepte une branche ou un commit assigné à la fois, sous un bail d'exécution appartenant à l'orchestrateur. La mission doit dire explicitement si cet ouvrier détient ce bail.

Sans le bail, ne montez pas ou ne changez pas de source dans le conteneur canonique ; ne démarrez pas, n'arrêtez pas, ou ne redémarrez pas ses services ; n'appliquez pas de migrations ou de fixtures à ses données locales ; ne vous authentifiez pas contre lui ; n'exécutez pas d'E2E Android ; ou n'enregistrez pas de preuve. Complétez tout le travail source non affecté, puis retournez :

runtime_lease_request:
  ticket: <ticket assigné>
  exact_sources: <arbres de travail du dépôt, branches, et commits prêts à déployer>
  required_runtime_work: <migration, fixtures, sondes, E2E, et preuve encore nécessaires>
  unaffected_work_completed: <implémentation et vérification non runtime déjà terminées>

Avec le bail, utilisez uniquement la topologie de conteneur de développement documentée du dépôt de la mission, les ports standard, la source d'environnement complète, les migrations, les fixtures...

Individual skills in this repo

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

Skills associés