Communitygithub.com

grill-me-visuellement

Transformation du grill-me original en un artefact interactif : une page web où l'utilisateur répond directement aux questions par des boutons et des commentaires, avec des sections « À confirmer » et « Confirmé », des choix A/B avec maquettes, et une logique tabulaire.

Qu'est-ce que grill-me-visuellement ?

Cette compétence transforme le processus de questionnement itératif « grill-me » en un artefact web interactif. L'utilisateur voit les questions sur une page dédiée, avec des sections « À confirmer » et « Confirmé », et répond directement via des boutons (A/B/Autre, Oui/Non) et des commentaires. Le système prend en charge quatre types de questions : choix visuels avec maquettes (ui), logique tabulaire (logic), propositions simples (ok), et décisions déjà prises (plain). Le tout est structuré en rounds, chaque round posant toutes les questions dont les prérequis sont résolus. Le skill automatise la publication de l'artefact, la gestion des réponses et la mise à jour de l'arbre de décision. Il est particulièrement utile pour les discussions de design, de bot ou d'application où les choix d'écrans sont plus faciles à montrer qu'à décrire.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bulkozavr2000/grill-me-visually/tree/HEAD/skills/grill-me-visually

Demander à votre IA préférée

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

Documentation

Grill me visuellement

La première partie est le grill-me original, mot pour mot. Ensuite, comment mener le même interrogatoire visuellement, sur une page artefact.

Grill-me

Interrogez l'utilisateur sans relâche jusqu'à parvenir à une compréhension partagée. Cartographiez-la sous forme d'arbre de décision : chaque décision se ramifie en décisions qui en dépendent.

Parcourez l'arbre par rounds. La frontière est constituée de toutes les décisions dont les prérequis sont déjà réglés : les questions que vous pouvez poser maintenant sans deviner des réponses que vous n'avez pas encore entendues. Posez toute la frontière en un seul round : numérotez chaque question et donnez votre réponse recommandée. Attendez ensuite les réponses de l'utilisateur avant le round suivant.

Formatez un round comme suit :

❓ **Q1** - **<titre de la question>** : <corps de la question, éventuellement plusieurs paragraphes, avec choix multiples>

➡️ <votre réponse recommandée>

---

❓ **Q2** - **<titre de la question>** : <corps de la question, éventuellement plusieurs paragraphes, avec choix multiples>

➡️ <votre réponse recommandée>

Formulez chaque question de sorte que « oui » accepte votre réponse recommandée.

Chaque round, les réponses de l'utilisateur remodèlent l'arbre : les décisions prises repoussent la frontière et débloquent les questions qui en dépendaient. Recalculez la frontière et posez le round suivant. Une question dont la réponse dépend d'une autre question encore ouverte dans ce round appartient à un round ultérieur, pas à celui-ci.

Trouver les faits est votre travail, jamais celui de l'utilisateur. Lorsqu'une question de la frontière nécessite un fait de l'environnement (système de fichiers, outils, etc.), envoyez un sous-agent avec une nouvelle fenêtre de contexte pour le trouver ; ne demandez pas à l'utilisateur quelque chose que vous pouvez chercher vous-même. Ne bloquez pas dessus : une exploration en cours est un prérequis non réglé, donc seules les questions en aval attendent que le sous-agent rende compte ; posez le reste de la frontière maintenant. Les décisions appartiennent à l'utilisateur : soumettez-les-lui et attendez.

La session est terminée lorsque la frontière est vide : chaque branche de l'arbre de décision a été visitée, rien n'a été supposé silencieusement. N'agissez pas tant que l'utilisateur n'a pas confirmé que vous êtes parvenu à une compréhension partagée.

Comment un round devient artefact

Tout ce qui précède reste valable. Seul change l'endroit où vit le round : au lieu du texte dans le chat, les enregistrements sur une page artefact (modèle assets/template.html), et l'utilisateur répond par des boutons et un commentaire.

Dans grill-meSur la page
❓ Q1 - titre : texte de la questionBloc question : numéro, titre, ligne de contexte
➡️ réponse recommandéeBannière verte « Je recommande : … »
« Options dans la question »Option A et option B, chacune avec son visuel, avantages et inconvénients
« oui » accepte la recommandationBouton de l'option recommandée ou « OK »
Réponse de l'utilisateur par texteBouton A / B / Autre ou OK / Non plus commentaire
RésoluUne ligne dans la section « Confirmé »

Quoi afficher visuellement

Chaque question d'un round correspond exactement à un bloc d'un des quatre types. Prenez le type le plus simple qui convient : une maquette coûte plus cher qu'une ligne de texte, et des images superflues gênent la lecture.

TypeQuandContenuBoutons
uiQuestion sur l'apparence ou le parcours d'un écran : disposition, boutons, navigation, ordre des étapes, affichageRecommandation ; A à gauche, B à droite (si besoin, C, D…) ; maquette pour chacun, avantages et inconvénients en dessousA · B (· C…) · Autre
logicQuestion sur les règles, pas sur l'écran : qui fait quoi, statuts, délais, prix, donnéesRecommandation ; tableau : aspect · A · B (· C…)A · B (· C…) · Autre
okPas d'options, une seule propositionTexte de la propositionOK · Non
plainDéjà décidé : dans le chat, un round précédent, les documents du projetUne ligne dans « Confirmé »—

Toutes les questions et toutes les options uniquement dans le questionnaire (règle de l'auteur). Ne créez pas d'artefact séparé pour comparer les options, même si elles sont nombreuses : ajoutez-les dans la même question en tant que C, D, E, F (champs c…f, voir references/items.md). En général, deux suffisent ; la troisième et les suivantes sont pour quand l'utilisateur demande une option supplémentaire ou qu'il y en a vraiment plus de deux.

Règles pour les maquettes ui :

  • Dessinez une maquette seulement lorsque la différence entre A et B est visible à l'œil. Si la différence est dans les mots, c'est logic ou ok.
  • Montrez ce qui différencie les options et un minimum d'environnement pour comprendre où cela se trouve sur l'écran. Pas besoin de l'écran entier avec tous les détails.
  • Dessinez A et B dans le même cadre, avec les mêmes données et à partir du même état initial : ainsi l'œil ne voit que la différence.
  • Utilisez les vraies données du projet : noms, prix, termes de l'utilisateur. Les éléments fictifs (noms, montants) sont signalés par {{NOTE}} dans l'en-tête.
  • Pour un scénario à plusieurs étapes, une maquette par option suffit : les étapes se succèdent de haut en bas, l'action de l'utilisateur est indiquée par une annotation grise (« a cliqué sur « Panier » »).
  • Avantages et inconvénients : 2 à 3 par option, une ligne chacun.
  • Type de maquette : chat Telegram (tg) pour les bots, téléphone ou navigateur (html avec cadre) pour les applications et sites. Champs et classes dans references/items.md.

À quoi ressemble l'artefact

La page est compacte et sobre : taille de texte normale (14 px), pas de grands titres, petits interlignes, rien de superflu – ni décoration, ni tableaux inutiles, ni paragraphes d'introduction. Thème clair et sombre. Tout cela est déjà intégré dans le modèle : ne modifiez pas le design, changez uniquement les enregistrements.

De haut en bas :

  1. En-tête : petite ligne grise – à quoi se rapporte le tableau ; titre « Questionnaire : » ; une ligne « Réponds ici même… » ; mention facultative ({{NOTE}}).
  2. « Autre » : un champ de texte et un bouton « Enregistrer » – message dans le chat sans quitter le questionnaire : question, remarque ou demande qui ne se rapporte à aucune question ci-dessous. Le champ est à usage unique : après le traitement du round, il est vidé.
  3. « À confirmer » et le nombre de questions ouvertes. Chaque question est un bloc :
    • numéro, titre, si nécessaire mention « D'abord ceci » ;
    • ligne de contexte en gris, si nécessaire ;
    • bannière verte « Je recommande : … » (pour ui et logic);
    • contenu selon le type : ui – colonnes, A à gauche, B à droite (avec une troisième option, trois colonnes ; avec quatre ou plus, deux par ligne), dans chacune une légende, une maquette, en dessous avantages (+) et inconvénients (−) ; sur téléphone, les colonnes se placent les unes sous les autres. logic – tableau « aspect · A · B (· C…) ». ok – texte de la proposition ;
    • champ de commentaire ;
    • boutons en bas : un bouton par option et « Autre » (pour ok – OK · Non). « Autre » nécessite un commentaire.
  4. « Confirmé » et le nombre de décisions : liste numérotée, chaque ligne contient la date et la décision en une phrase ; en dessous de la ligne, en gris, le commentaire de l'utilisateur s'il y en a un ; petit lien « remettre dans les questions ».

Une question répondue passe immédiatement de la première section à la seconde.

Étapes

  1. Préparation. Chargez les compétences artifact-capabilities et artifact-design : l'outil Artifact les requiert avant la publication. Chargez ArtifactData via ToolSearch.

  2. Page. Le code de la page est déjà prêt – assets/template.html ; n'écrivez pas de nouvelle page, copiez simplement le modèle dans le projet et remplissez-le avec les questions via la base de données. Si le dossier se trouve dans le stockage Obsidian, placez-le dans .code/grill/<sujet>.html, sinon dans le dossier du projet ou scratchpad. Remplacez les trois étiquettes :

    • {{TITLE}} (deux endroits) – nom du sujet, 2 à 4 mots, par exemple « bot Coffee Shop ». Dans le modèle, il est déjà précédé par « Questionnaire : » – ainsi la page est immédiatement reconnaissable parmi les autres artefacts (décision de l'auteur), le nom complet sera « Questionnaire : bot Coffee Shop » ;
    • {{SUBTITLE}} – à quoi se rapporte, par exemple « Client Coffee Shop · Bot Telegram » ;
    • {{NOTE}} – mention telle que « Noms et montants dans les maquettes sont fictifs » ou une chaîne vide.

    Ne modifiez rien d'autre dans le fichier. Si un tel tableau existe déjà pour le sujet, travaillez avec : Artifact read via son URL, puis publish avec url.

  3. Publication. Artifact publish, icon: "checklist", capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. La règle write: admin signifie que seuls le propriétaire et les éditeurs peuvent répondre ; celui qui a reçu un lien de visionnage ne fait que regarder. assets est nécessaire pour les vraies photos dans les maquettes : chargez-les dans l'artefact (asset: true) et placez le lien /_blob/<id> dans les enregistrements.

  4. Round. Un seul appel ArtifactData batch dans la collection items : un document par question de la frontière plus les lignes plain pour ce qui est déjà décidé. L'ordre est défini par le champ order, la question la plus urgente peut être marquée first: true.

  5. Transmission. Donnez le lien, en quelques lignes nommez les questions du round et demandez d'écrire « répondu » : la page ne vous notifie pas des réponses. Si une réponse est nécessaire immédiatement, posez la question également dans le chat (AskUserQuestion) et enregistrez la réponse vous-même dans la base de données, exactement comme la page l'aurait fait.

  6. Lecture des réponses. ArtifactData list de la collection items. Pour chaque enregistrement avec status: "done" et champ answer :

    • a, b, ok, no – décision prise, la page a déjà enregistré summary. Si le commentaire précise la décision, réécrivez summary en une ligne de manière à refléter la décision réelle.
    • other – lisez le commentaire. S'il s'agit d'une solution prête, réécrivez summary en une ligne. S'il s'agit d'une nouvelle option ou d'une question de retour, remettez l'enregistrement en open avec de nouvelles options ou créez une nouvelle question.
    • Transférez les décisions là où le projet les conserve (tableau de bord, cahier des charges, ADR), si un tel endroit existe.

    Lisez également « Autre » – ArtifactData get du document other dans la collection meta. Il s'agit d'un message de l'utilisateur dans le chat : traitez-le comme un message dans le chat – répondez dans le chat, exécutez la demande, enregistrez la décision là où le projet stocke les décisions, transformez une nouvelle idée en question dans le round suivant. Ensuite, videz le champ : update avec if_version, text: "", et supprimez reply, replyAt, at ({"__delete__": true}). Ne perdez rien de ce contenu : tout ce qui est nécessaire est déjà enregistré dans le chat, sur le tableau ou dans les questions.

    Recalculez ensuite la frontière et ajoutez le round suivant avec le même batch.

  7. Fin. La frontière est vide – résumez brièvement le résultat et demandez si la compréhension est partagée.

Règles d'enregistrement

  • Toute modification d'un document existant doit utiliser if_version issu de la dernière lecture : l'utilisateur a pu répondre pendant que vous travailliez.
  • Le champ answer est la réponse de l'utilisateur. Ne le modifiez pas, sauf si vous remettez vous-même la question dans les ouvertes.
  • Écrivez court : titre – jusqu'à 8 mots, recommandation – 1 à 2 phrases, ligne dans « Confirmé » – une phrase.
  • La langue de la page est celle de l'utilisateur. Les légendes du modèle sont en français ; pour une autre langue, traduisez-les dans une copie du modèle.

Vérification

Après la première publication, effectuez un ArtifactData list (tous les enregistrements en place) et un coup d'œil sur la page dans le navigateur : les maquettes s'affichent, A et B sont côte à côte. N'appuyez pas sur les boutons à la place de l'utilisateur : ce sont ses réponses.

Skills associés