Communitygithub.com

flux-de-revue-demo

Utilisez-la lorsqu'on vous demande d'ajouter, modifier ou reconcevoir tout élément qu'un utilisateur voit ou manipule dans une interface utilisateur — disposition, emplacement d'un contrôle, interaction, raccourci clavier, style, animation — y compris les petites retouches et les demandes urgentes ; lorsque la session reprend un travail d'UI lié à un tableau de révision ; ou lorsque les tests et la revue de code passent mais que l'utilisateur trouve encore l'interface erronée.

Qu'est-ce que flux-de-revue-demo ?

Cette compétence définit un processus rigoureux pour toute modification visible ou interactive dans une interface utilisateur (UI). Elle part du principe que les tests et la revue de code ne peuvent pas valider le placement, l'animation ou l'ergonomie perçue par l'utilisateur. Pour chaque fonctionnalité, le développeur doit donc d'abord créer une démo fonctionnelle que l'utilisateur approuve avant d'écrire le code final. Ce processus s'articule autour d'un tableau de révision (review board) — une page Artifact avec une base de données partagée — qui suit chaque fonctionnalité à travers six statuts : changements, en révision, approuvé, portage, livré et vérifié. La compétence couvre des outils comme Claude Code (via Artifacts et sessions), Cursor et des workflows de développement par sous-agent. Elle commence par une phase de référence (étude d'applications existantes), puis la mesure précise de l'UI réelle, la construction de la démo, son enregistrement, la validation par l'utilisateur (« approuvé »), le portage immédiat (intégration dans le code produit), la livraison avec preuve visuelle, et enfin la vérification par l'utilisateur. Le document inclut des règles de sécurité pour les environnements live (navigation en lecture seule, interdiction de cliquer sur Supprimer/Modifier/Enregistrer), ainsi qu'un tableau de rationalisation des excuses courantes (taille, délai, silence). Le code produit n'est jamais écrit avant que la démo ne soit approuvée.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whats2000/demo-review-skills/tree/HEAD/skills/demo-review-flow

Demander à votre IA préférée

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

Documentation

Flux de revue démo

Les tests et la revue de code prouvent le mécanisme. Ils ne peuvent pas vous dire que le menu est mal placé, que la fermeture clignote ou que l'icône est décalée de 2 px — seul l'utilisateur le peut. Ainsi, une modification portant sur l'apparence ou l'interaction est conçue comme une démo fonctionnelle que l'utilisateur approuve par fonctionnalité avant tout code produit, et elle est fermée uniquement lorsque l'utilisateur l'accepte dans l'application réelle. Un tableau de révision (une page Artifact avec une base de données partagée) suit chaque fonctionnalité à travers six statuts.

Configuration du projet : .claude/demo-board.md (URL du tableau, applications de référence par zone, largeurs à vérifier, application live + contient-elle des données réelles, ports de copie de l'espace de travail, commandes de porte, fichier de spécifications). S'il manque → créer d'abord le tableau : references/board-setup.md.

Quel chemin

  • Modifie l'apparence, l'emplacement ou la façon dont quelque chose est utilisé → ce flux. Aucune exception pour la taille ou le délai.
  • Rétablit un comportement déjà défini par la spécification ou une démo approuvée (crash, données erronées, débordement, régression) → corriger directement avec TDD, pas de démo. Indiquer à l'utilisateur quel chemin vous avez choisi.
  • Un bogue signalé sur un élément livré du tableau → retour au portage, correction, vérification en live, livré. Une correction qui change l'apparence → nouveau tour de démo.

Le flux

  1. Référence d'abord. Pour la zone, consulter les applications que les utilisateurs connaissent déjà (la config les liste). Relever où se trouve le contrôle, chaque touche, le mouvement incluant les sorties. Ne s'en écarter qu'avec une raison explicite. Un sondage auprès d'utilisateurs simulés choisit entre les options ; il ne remplace jamais la référence.
  2. Mesurer l'interface réelle. Prendre une capture d'écran des écrans livrés que la modification touche, aux largeurs de l'utilisateur, en lecture seule, et mesurer les gouttières, les tailles, l'alignement. Concevoir sur cette disposition.
  3. Construire la démo comme une entrée feat() qui fonctionne vraiment : clics, touches, mouvement incluant les sorties, mode clair + sombre, largeur étroite. → references/add-feature.md
  4. L'enregistrer : une ligne changes et features/<id> → review.
  5. Passer le relais et s'arrêter. Lien + ce qu'il faut regarder. Aucun code produit pour cet élément tant qu'il n'est pas approuvé. « Allez-y sauf si vous vous y opposez » n'est pas une approbation. Si l'approbation ne peut pas venir avant une échéance, proposer à l'utilisateur ce qui est déjà livré — ne jamais anticiper.
  6. Reprendre les décisions au début de chaque session UI et chaque fois que l'utilisateur dit avoir révisé : lire features. approuvé → 7. changes → la note est la demande → 3. L'utilisateur dit avoir approuvé mais la base de données ne le montre pas → le clic n'a pas été enregistré : le dire, le configurer pour lui.
  7. Porter immédiatement — l'utilisateur ne révise pas les plans ; son critère est l'étape 9. Mettre porting ; briefing selon references/port-brief.md. Un agent de portage par zone de fichiers. Les migrations s'exécutent sur une copie de l'espace de travail ; sur des données en live uniquement avec approbation explicite et sauvegarde.
  8. Livrer uniquement avec des preuves en live (mesures, mouvement par image, les deux thèmes, les largeurs de l'utilisateur) : shipped + une ligne changes + ce qu'il faut vérifier.
  9. Vérifié est la décision de l'utilisateur — son clic Accepter, ou bien il dit en chat que cet élément est accepté (alors vous le paramétrez). Un vague « ça a l'air bien » → demander quels éléments. Jamais sur votre propre jugement.

Statuts, qui les définit, le schéma de la base de données, écritures → references/lifecycle.md. Passations avec brainstorming, plans d'écriture, développement par sous-agent, vérification et finition de branche → references/superpowers-integration.md.

Sécurité de la vérification en live

Sur une application live contenant des données réelles : naviguer en lecture seule, cliquer uniquement sur les libellés exacts, ne jamais supprimer/supprimer définitivement/modifier sur place — toute vérification qui modifie des données s'exécute sur une copie de l'espace de travail.

Rationalisations

PenséeRéalité
« C'est petit / facile à annuler »La taille n'est pas le critère ; l'apparence ou l'interaction l'est. Les petites modifications d'interface sont là où le placement dérape.
« Deadline demain »Un tour de démo prend quelques minutes ; un mauvais placement livré en démo coûte plus cher. Garder l'ordre, indiquer le calendrier.
« Je vais montrer des captures d'écran et continuer sauf objection »Le silence n'est pas une approbation, et une capture d'écran d'une version finie n'est pas une démo que l'on peut manipuler.
« Le bon endroit est évident d'après les principes premiers »Nommer l'application de référence. « Où regardent les utilisateurs » est la raison pour laquelle le bouton introuvable a été livré.
« Les tests, la revue et la construction sont verts, donc c'est fait »Cela signifie portage terminé. livré nécessite une preuve en live ; vérifié nécessite l'utilisateur.
«  'Ça a l'air bien je suppose' signifie accepté »L'acceptation est par élément. Demander lequel.
« Ils approuveront de toute façon ; je vais anticiper pour la deadline »Le code non approuvé est celui qui est perdu. Le rediriger vers ce qui est livré aujourd'hui ; porter dès qu'il approuve.
« Je vais inventer un statut plus clair »Six statuts seulement ; la page et l'utilisateur lisent ceux-ci.
« Porter et démo ensemble pour gagner du temps »Seuls les éléments approuvés reçoivent du code produit.

Drapeaux rouges — s'arrêter

  • Ouvrir un composant produit avant que la démo ne montre le design.
  • Un design sans application de référence nommée, ou sans mesure de l'interface réelle.
  • livré sans preuve en live ; vérifié sans le mot de l'utilisateur sur cet élément.
  • Cliquer sur Supprimer/Supprimer définitivement/Enregistrer dans une application contenant des données réelles.
  • Deux agents de portage sur les mêmes fichiers ; exécuter une migration sur des données en live.

Skills associés