그릴링 (Grilling)

Was macht 그릴링 (Grilling)?

Holt den Vortrag aus dem Kopf der vortragenden Person durch Fragen hervor und erstellt daraus brief.md (Entscheidungen) und outline.md (Szenentabelle) im Vortragsordner. Der Build wird von einem neuen Subagenten durchgeführt, der nur diese beiden Dateien und sources/ liest. Entscheidungen, die nur im Gespräch existieren und nicht in Dateien festgehalten sind, erreichen den Build nicht.

Erste Aussage der vortragenden Person: $ARGUMENTS

Die Sitzung wird im Kit-Root-Verzeichnis ausgeführt. Der Befehl ./talk wird vom Kit-Root aus aufgerufen. Im Folgenden beziehen sich Namen wie brief.md, talk.json auf Dateien im Vortragsordner (talks/<Ordner>/).

0. Vortragsordner festlegen

1. Zeige das Profil der vortragenden Person mit ./talk profile an. Falls nicht vorhanden, frage in der ersten Frage nach dem englischen Namen und der Zugehörigkeit. Falls die vortragende Person die Folien auf Koreanisch erstellt, frage auch nach dem koreanischen Namen und der Zugehörigkeit. Speichere die Antworten mit ./talk profile --name "..." --affiliation "..." (falls nötig --name-ko, --affiliation-ko).
2. Sieh dir ./talk brand an. Falls „Nicht eingestellt“ angezeigt wird, lege vor der Erstellung eines neuen Vortrags in einer Frage Farbe und Logo fest. Die Methode steht im Kit-Root AGENTS.md unter „Schul-/Lab-Farben und -Logo“. Falls die vortragende Person darum bittet, ohne Nachfrage zu erstellen, verwende die Standardvoreinstellung.
3. Falls die vortragende Person einen bereits begonnenen Vortrag erwähnt, suche in ./talk list nach diesem Ordner.
4. Bei einem neuen Vortrag werden Typ, Datum und Veranstaltung benötigt. Frage nur nach dem, was in den Worten der vortragenden Person fehlt – eine Frage nach der anderen. Erstelle dann mit ./talk new <Typ> <YYYY-MM-DD> [Veranstaltung] [--title "..."] [--lang ko]. Gültige Typen sind lab, conf, seminar, class, jc. Bei Lab Meetings bleibt die Veranstaltung leer (das Deckblatt wird zu „Lab meeting, Datum“; das Thema des Tages wird in --topic oder talk.json unter topic geschrieben). Der im Output angezeigte Ordner ist der Ordner dieses Vortrags.
5. Falls ein Fehler wegen fehlender node-Tools auftritt, führe ./talk setup aus und versuche es erneut.

1. Vor den Fragen lesen

1. Lese talk.json, README.md, brief.md und outline.md aus dem Vortragsordner. Falls brief.md bereits Grilling-Aufzeichnungen enthält, fahre danach fort.
2. Lese alle Aussagen der vortragenden Person und alle Dateien in sources/. PDFs werden seitenweise gelesen. Kopiere externe Dateien oder Webdokumente, die die vortragende Person erwähnt, in sources/ (bei Webseiten speichere den Text als Textdatei) und trage in der Tabelle der Eingabematerialien in brief.md den Pfad und den Prüfstatus ein („Nur Abstract“, „Text geprüft“, „Nur Abbildung“). Beim Kopieren externer Dateien mit cp erscheint einmal eine Berechtigungsabfrage. Die vortragende Person erlaubt sie. Dateien werden mit Write- und Edit-Tools geschrieben; Überprüfungsskripte werden im Ordner audit/tmp/ des Vortragsordners abgelegt (Schreiben außerhalb des Kits wie /tmp wird abgelehnt).
3. Stelle keine Fragen, auf die die Materialien bereits antworten. Antworten, die aus Materialien gefunden wurden, werden in brief.md mit „(aus Material)“ gekennzeichnet und nur zur Bestätigung vorgelegt.
4. Befülle den Abschnitt „Aufgaben“ in brief.md mit talk.json. Die Grundvorlage für den Vortragstyp findest du in .claude/skills/talk-grill/references/talk-types.md (relativ zum Kit-Root).
5. Außerhalb des Kit-Ordners (z. B. Home-Verzeichnis) wird nur gelesen, wenn die vortragende Person den Pfad nennt. Beim Lesen außerhalb erscheint eine Berechtigungsabfrage, die die erste Frage verzögert. Nach Abschluss der vier Schritte stelle sofort die erste Frage.

2. Fragen stellen

• Stelle immer nur eine Frage auf einmal. Gib 2–4 Optionen vor. Setze die Empfehlung an die erste Stelle und füge eine einzeilige Begründung hinzu. Die vortragende Person kann auch direkt eine Antwort eintippen. In Claude Code frage mit AskUserQuestion. Bei Agenten ohne dieses Tool verwende das gleiche Format (eine Zeile Frage, nummerierte Optionen, erste ist Empfehlung) im Chat.
• Halte Fragen kurz. Wiederhole vorherige Antworten nicht ausführlich.
• Bearbeite nach Erhalt der Antwort sofort brief.md. Füge eine Zeile im Grilling-Log hinzu: Qn Frage → Antwort und aktualisiere die davon betroffenen Zeilen (Aufgaben, Ein-Satz, Struktur). Lasse alte und neue Entscheidungen nicht nebeneinander stehen.
• Falls die vortragende Person „Weiß nicht“ oder „Später“ sagt, notiere es in den offenen Punkten und stelle die Frage nicht erneut.
• Falls die vortragende Person um eine Meinung bittet, prüfe die Originalquelle, wähle eine Option aus und nenne einen einzeiligen Grund. Schreibe in brief.md „Empfehlung“. Die Entscheidung trifft die vortragende Person.
• Falls die Annahme der vortragenden Person von der Originalquelle abweicht, sage zuerst, wie weit sie richtig liegt, und weise dann auf die Korrektur hin.
• Falls die vortragende Person eine Entscheidung ändert, folge der neuen Aussage. Frage nicht nach dem Grund.
• Falls die vortragende Person darum bittet, ohne Fragen direkt zu erstellen, fülle brief und outline mit Material und der Grundvorlage des Vortragstyps und hole nur die Genehmigung (Abschnitt 5) ein. Nicht festgelegte Punkte werden in den offenen Punkten vermerkt.

3. Reihenfolge

Frage zuerst nach Dingen, die den Build am stärksten beeinflussen.

1. Rahmen: Veranstaltung, Vortragsdauer, Fragerunde, Publikum. Daraus ergibt sich das Folienbudget (talk-types.md). Falls die Foliensprache von talk.json abweicht, korrigiere lang.
2. Ein Satz: Ein Satz, den das Publikum mitnehmen soll.
3. Struktur: 2–4 Abschnitte und deren Reihenfolge. Schlage die Grundstruktur aus talk-types.md als Ausgangspunkt vor.
4. Pro Abschnitt: Behauptung, Beweis (Abbildung, Daten, Paper-Seite), Darstellungsweise (Paper-Abbildung, neu gezeichnetes Konzeptdiagramm, Schritt-für-Schritt-Animation pro Klick). Für einen Abschnitt können auch mehrere Fragen gestellt werden.
5. Anfang und Ende: Die Frage, die die erste Folie stellt; die letzte Folie (Fazit, Diskussionsfragen, bei Lab Meetings: nächste Schritte und Bitte an den Betreuer).
6. Offene Punkte klären.

Stelle 6–10 Fragen und beende den Vorgang. Falls die vortragende Person aufhören möchte, beende sofort.

4. Quellenprüfung

• Überprüfe Zahlen und Zitate, die auf Folien erscheinen sollen, in der Originalquelle (Text, Tabelle, Abbildungsbeschriftung) und trage in brief.md unter „Quellenprüfung“ den Wert, die Datei und die Seite ein. Verwende keine Zahlen, die nur aus einer Zusammenfassung von Abstract oder Notizen stammen.
• Gib bei Zahlen die Bedingungen an (aus welchen Daten, Einstellungen, Teil Mengen der Wert stammt).
• Falls die Originalquelle keine Ursache nennt, führe keinen Zusammenhang zwischen zwei Zahlen an.
• Falls geplant ist, eine Paper-Abbildung unverändert zu verwenden, prüfe die Lizenz. Falls eine Bearbeitung verboten ist (CC BY-ND etc.), entscheide, sie neu zu zeichnen.
• Nicht erhaltene Originalquellen (kostenpflichtige Paper etc.) trage in brief.md unter offenen Punkten als „Von der vortragenden Person zu beschaffendes Material“ ein. Abschnitte, die auf dieser Quelle basieren, markiere in der outline mit „Noch nicht geprüft“.

5. Gliederung (outline.md)

• Tabellenspalten: #, sceneId, Vorlage, Titel (einzeilig, max. 10 Wörter), Behauptung als ein Satz, Reihenfolge von Bildschirm und Klicks, Beweis (Datei·Seite).
• sceneId besteht aus englischen Kleinbuchstaben und Ziffern (z. B. motivation, setup, result2). Das Deckblatt hat title, die Gliederung outline, Abschnittseröffner ab sec01, das Ende thanks.
• Die Anzahl der Folien bleibt im Budget. Eine Folie = ein Gedanke. Wenig Text, die Abbildung erklärt. Details kommen in die Notizen.
• In der Spalte „Reihenfolge von Bildschirm und Klicks“ steht, was die Abbildung zeigt und was bei jedem Klick erscheint. Der Build-Agent erstellt nur, was in dieser Spalte steht.
• Feste Deckblattinformationen werden in talk.json eingetragen: title (bei Nicht-Lab-Meetings der Vortragstitel), topic (Lab-Meeting-Thema, unterstrichener Untertitel auf dem Deckblatt), event, authors (Co-Autoren: {"name": ..., "name_ko": ...}), length_min, lang.
• Schreibe oben in der outline die Vortragszeile (Veranstaltung, Datum, Zeit, Anzahl Folien). Die Genehmigungszeile bleibt leer.

6. Genehmigung und Übergabe

1. Zeige die outline.md-Tabelle und frage. Optionen: „So erstellen“ (empfohlen), „Es gibt Verbesserungspunkte“. .
2. Falls es Verbesserungspunkte gibt, korrigiere und frage erneut.
3. Nach Genehmigung schreibe das heutige Datum in die Genehmigungszeile der outline.md und füge im aktuellen Status von README.md die Grilling-Einträge (Festgelegtes, Offene Punkte) ein.
4. Übergib an den Build. In Claude Code rufe mit dem Skill-Tool talk-build auf und übergib als erstes Argument den Pfad zum Vortragsordner (z. B. talks/2026-11-16-lab-meeting). talk-build läuft in einem neuen Subagenten. Falls kein Skill-Tool vorhanden ist, lese .claude/skills/talk-build/SKILL.md und führe es direkt aus.
5. Der Build dauert je nach Anzahl der Folien zehn bis mehrere zehn Minuten. Gib der vortragenden Person nach Abschluss einen kurzen Bericht. Zeige dann das Kontaktblatt (talks/<Ordner>/audit/contact-sheet.png) und bitte um eine einmalige Rückmeldung zu Verbesserungspunkten.