namenguiin/talk-grill

Grilling

Transforme la présentation dans la tête du présentateur en questions, puis crée brief.md (décisions) et outline.md (plan par chapitre) dans le dossier de présentation. La construction est effectuée par un nouveau sous-agent qui ne lit que ces deux fichiers et sources/. Les décisions qui ne sont que dans la conversation et pas dans les fichiers n'atteignent pas la construction.

Premières paroles du présentateur : $ARGUMENTS

La session est ouverte à la racine du kit. La commande ./talk est appelée depuis la racine du kit. Ci-dessous, les noms comme brief.md, talk.json désignent des fichiers dans le dossier de présentation (talks/<dossier>/).

0. Déterminer le dossier de présentation

1. Consultez ./talk profile pour voir les informations du présentateur. Si absentes, demandez le nom et l'affiliation en anglais dès la première question. Si le présentateur réalise des slides en coréen, demandez aussi le nom et l'affiliation en coréen. Enregistrez la réponse avec ./talk profile --name "..." --affiliation "..." (ajoutez --name-ko, --affiliation-ko si nécessaire).
2. Consultez ./talk brand. S'il est "non configuré", avant de créer une nouvelle présentation, choisissez la couleur et le logo en une question. La méthode est décrite dans le fichier AGENTS.md à la racine du kit, sous "Couleurs et logo de l'école/laboratoire". Si le présentateur demande de créer sans poser de questions, utilisez le préréglage par défaut sans demander.
3. Si le présentateur a mentionné une présentation en cours, cherchez le dossier dans ./talk list.
4. Pour une nouvelle présentation, le type, la date et l'événement sont nécessaires. Ne demandez que ce qui manque en une seule question. Ensuite, créez-la avec ./talk new <type> <YYYY-MM-DD> [événement] [--title "..."] [--lang ko]. Les types sont lab, conf, seminar, class, jc. Pour une réunion de laboratoire, laissez l'événement vide (la couverture deviendra "Lab meeting, date", et le sujet du jour sera mis dans --topic ou topic du talk.json). Le dossier affiché en sortie est celui de cette présentation.
5. Si une erreur indique qu'un outil node est manquant, exécutez ./talk setup et réessayez.

1. Lecture avant les questions

1. Lisez talk.json, README.md, brief.md, outline.md du dossier de présentation. Si brief.md contient un historique de grilling, reprenez à partir de là.
2. Lisez toutes les paroles du présentateur et tous les fichiers de sources/. Les PDF sont lus page par page. Copiez dans sources/ les fichiers externes ou documents web mentionnés par le présentateur (pour le web, enregistrez le contenu en texte brut) et inscrivez dans le tableau des sources de brief.md le chemin et l'état de vérification ("résumé seulement", "texte vérifié", "images seulement"). Copier un fichier externe avec cp provoquera une demande d'autorisation une fois. Le présentateur l'accorde. Écrivez les fichiers avec les outils Write et Edit ; les scripts de vérification se placent dans audit/tmp/ du dossier de présentation (écrire en dehors du kit, comme dans /tmp, sera refusé).
3. Ne posez pas de questions sur ce que les sources répondent déjà. Les réponses trouvées dans les sources sont écrites dans brief.md avec la mention "(d'après les sources)" et seulement soumises à confirmation.
4. Remplissez la section des tâches de brief.md avec les informations de talk.json. Le modèle de base selon le type de présentation se trouve dans .claude/skills/talk-grill/references/talk-types.md (par rapport à la racine du kit).
5. Ne lisez l'extérieur du dossier du kit (comme le répertoire personnel) que si le présentateur en donne le chemin. Lire à l'extérieur provoque une demande d'autorisation et retarde la première question. Une fois ces quatre étapes terminées, posez immédiatement la première question.

2. Comment poser les questions

• Posez une seule question à la fois. Proposez 2 à 4 options. Mettez la recommandation en premier avec une justification d'une ligne. Le présentateur peut aussi écrire sa propre réponse. Dans Claude Code, utilisez l'outil AskUserQuestion. Pour les agents sans cet outil, posez la question dans le chat avec le même format (question en une ligne, options numérotées, la première recommandée).
• Rédigez des questions courtes. Ne répétez pas longuement les réponses précédentes.
• Dès réception de la réponse, mettez à jour immédiatement brief.md. Ajoutez une ligne dans l'historique du grilling : Qn question → réponse, puis mettez à jour les lignes modifiées par cette réponse (tâche, résumé, squelette). Ne conservez pas simultanément l'ancienne et la nouvelle décision.
• Si le présentateur dit "je ne sais pas" ou "plus tard", notez-le dans les éléments ouverts et ne reposez pas cette question.
• Si le présentateur demande votre avis, vérifiez d'abord la source, puis choisissez une option et donnez une justification d'une ligne. Inscrivez "Recommandation" dans brief.md. La décision finale revient au présentateur.
• Si la prémisse du présentateur diffère de la source, d'abord dites en quoi elle est correcte, puis indiquez ce qui doit être corrigé.
• Si le présentateur change d'avis, suivez ses nouvelles paroles. Ne lui demandez pas pourquoi.
• Si le présentateur demande de créer directement sans questions, remplissez le brief et l'outline à partir des sources et du modèle de base selon le type de présentation, et ne demandez que l'approbation (section 5). Les points non décidés sont notés dans les éléments ouverts.

3. Ordre

Commencez par ce qui a le plus d'impact sur la construction.

1. Contexte : événement, durée de la présentation, durée des questions-réponses, public. Cela détermine le budget de nombre de diapositives (talk-types.md). Si la langue des slides diffère de talk.json, corrigez lang.
2. Message central : une phrase que le public retiendra.
3. Squelette : 2 à 4 sections et leur ordre. Proposez le squelette par défaut de talk-types.md comme point de départ.
4. Pour chaque section : argument, preuves (figures, données, pages de document), mode d'affichage (figure de document, concept redessiné, processus pas à pas). Vous pouvez poser plusieurs questions pour une même section.
5. Début et fin : question posée par la première diapositive, dernière diapositive (conclusion, questions de discussion, pour une réunion de laboratoire : prochaines étapes et demande au directeur de thèse).
6. Révision des éléments ouverts.

Terminez après 6 à 10 questions. Arrêtez immédiatement si le présentateur demande d'arrêter.

4. Vérification des sources

• Vérifiez les chiffres et citations à mettre sur les slides dans la source originale (texte, tableaux, légendes de figures) et notez la valeur, le fichier et la page dans brief.md sous "Vérification source". N'utilisez pas de chiffres provenant uniquement d'un résumé ou de notes.
• Associez les chiffres à leurs conditions (de quelles données, paramètres, sous-ensembles ils proviennent).
• Si la source n'explique pas la cause, n'attribuez pas de cause à une différence entre deux chiffres.
• Si vous prévoyez d'utiliser directement une figure d'un document, vérifiez sa licence. Si elle interdit les modifications (CC BY-ND, etc.), décidez de la redessiner.
• Pour les sources non obtenues (documents payants, etc.), notez-les dans les éléments ouverts de brief.md comme "documents que le présentateur doit obtenir", et marquez les sections qui en dépendent dans l'outline comme "en attente de vérification".

5. Table des matières (outline.md)

• Colonnes du tableau : #, sceneId, cadre, titre (une ligne, ≤ 10 mots), argument en une phrase, ordre d'affichage et clics, preuves (fichier·page).
• sceneId s'écrit en minuscules anglaises et chiffres (ex. : motivation, setup, result2). La couverture est title, la table des matières est outline, les ouvertures de section sont sec01 et suivantes, la fin est thanks.
• Le nombre de diapositives respecte le budget. Une diapositive = une idée. Peu de texte, les images expliquent. Les détails vont dans les notes.
• Dans la colonne "Ordre d'affichage et clics", décrivez ce que montre l'image et ce qui apparaît à chaque clic. L'agent de construction ne crée que ce qui est écrit dans cette colonne.
• Les informations de couverture définies sont écrites dans talk.json : title (titre de la présentation si ce n'est pas une réunion de laboratoire), topic (sujet de la réunion de laboratoire, sous-titre en couleur de la couverture), event, authors (co-auteurs : {"name": ..., "name_ko": ...}), length_min, lang.
• En haut de l'outline, écrivez la ligne de présentation (événement, date, durée, nombre de diapositives). Laissez la ligne d'approbation vide.

6. Approbation et lancement

1. Montrez le tableau d'outline.md et demandez. Options : "Créer comme ça" (recommandé), "Il y a des points à corriger".
2. S'il y a des points à corriger, corrigez et redemandez.
3. Une fois approuvé, écrivez la date du jour dans la ligne d'approbation d'outline.md, et écrivez dans README.md l'état actuel de la présentation (décisions prises, éléments ouverts).
4. Lancez la construction. Dans Claude Code, utilisez l'outil Skill pour appeler talk-build avec en premier argument le chemin du dossier de présentation (ex. : talks/2026-11-16-lab-meeting). talk-build s'exécute dans un nouveau sous-agent. Pour les agents sans outil Skill, lisez .claude/skills/talk-build/SKILL.md et exécutez directement selon ses instructions.
5. La construction prend de dix à plusieurs dizaines de minutes selon le nombre de diapositives. Une fois terminée, faites un court rapport au présentateur. Demandez-lui de consulter la feuille de contact (talks/<dossier>/audit/contact-sheet.png) et de signaler les points à corriger en une fois.