Communitygithub.com

Grill me visually

Befragung zu einem Plan oder einer Idee in Frage-Runden auf einer Artefaktseite: Der Nutzer antwortet direkt auf der Seite, mit visuellen Vergleichen und strukturierten Entscheidungen.

Was ist Grill me visually?

Grill me visually ist eine Erweiterung des klassischen Grill-me-Ansatzes für KI-Assistenten (wie Claude Code, Cursor oder Codex). Statt Entscheidungen nur im Chat zu treffen, werden die Fragen auf einer Artefaktseite dargestellt. Der Nutzer kann direkt auf der Seite antworten, ohne den Chat zu verlassen. Das Skill unterstützt vier Fragetypen: UI-Fragen mit Bildschirm-Mockups, Logik-Fragen mit Tabellen, einfache Ja/Nein-Fragen und bereits bestätigte Entscheidungen. Die Seite zeigt die Fragen in zwei Bereichen: „Noch zu bestätigen“ und „Bestätigt“. Der Assistent bereitet jede Frage-Runde vor, veröffentlicht die Seite als Artefakt und liest die Nutzerantworten aus der Datenbank aus. Besonders nützlich, wenn viele Bildschirmvarianten diskutiert werden, die man besser sehen als beschreiben kann.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Grill me visually?

Der erste Teil ist der originale Grill-me, wortwörtlich. Danach wird gezeigt, wie dieselbe Befragung visuell auf einer Artefaktseite geführt wird.

Grill-me

Befrage den Nutzer unermüdlich, bis ein gemeinsames Verständnis erreicht ist. Bilde dies als Entwurfsbaum ab: Jede Entscheidung verzweigt sich in die davon abhängigen Entscheidungen.

Arbeite den Baum in Runden ab. Der Frontier sind alle Entscheidungen, deren Voraussetzungen bereits geklärt sind: die Fragen, die du jetzt stellen kannst, ohne über noch nicht gehörte Antworten zu raten. Stelle den gesamten Frontier in einer Runde: Nummeriere jede Frage und gib deine empfohlene Antwort. Warte dann auf die Antworten des Nutzers, bevor du die nächste Runde stellst.

Formatiere eine Runde wie folgt:

❓ **F1** - **<Fragentitel>**: <Fragetext, eventuell mehrere Absätze, einschließlich mehrerer Optionen>

➡️ <deine empfohlene Antwort>

---

❓ **F2** - **<Fragentitel>**: <Fragetext, eventuell mehrere Absätze, einschließlich mehrerer Optionen>

➡️ <deine empfohlene Antwort>

Formuliere jede Frage so, dass „Ja“ deine empfohlene Antwort akzeptiert.

Jede Runde verändert die Antworten des Nutzers den Baum: Geklärte Entscheidungen verschieben den Frontier nach außen und geben Fragen frei, die von ihnen abhingen. Berechne den Frontier neu und stelle die nächste Runde. Eine Frage, deren Antwort von einer anderen noch in dieser Runde offenen Frage abhängt, gehört zu einer späteren Runde, nicht zu dieser.

Fakten zu ermitteln ist deine Aufgabe, niemals die des Nutzers. Wenn eine Frontier-Frage eine Tatsache aus der Umgebung benötigt (Dateisystem, Tools usw.), starte einen Sub-Agenten mit einem neuen Kontextfenster, um sie zu finden; frage den Nutzer nicht nach etwas, das du selbst nachschlagen kannst. Blockiere nicht darauf: Eine laufende Erkundung ist eine ungeklärte Voraussetzung, also warten nur die nachgelagerten Fragen auf den Bericht des Sub-Agenten; stelle den Rest des Frontiers jetzt. Die Entscheidungen liegen beim Nutzer: Lege sie ihm vor und warte.

Die Sitzung ist beendet, wenn der Frontier leer ist: Jeder Zweig des Entwurfsbaums besucht, nichts bleibt stillschweigend angenommen. Handle erst, wenn der Nutzer bestätigt, dass ein gemeinsames Verständnis erreicht ist.

Wie eine Runde zum Artefakt wird

Alles oben Genannte bleibt gültig. Es ändert sich nur der Ort, an dem die Runde lebt: Statt Text im Chat – Einträge auf einer Artefaktseite (Vorlage assets/template.html), und der Nutzer antwortet mit Schaltflächen und Kommentar.

In Grill-meAuf der Seite
❓ F1 - Titel: FragetextFrageblock: Nummer, Titel, Kontextzeile
➡️ empfohlene AntwortGrünes Label „Ich empfehle: …“
„Optionen in der Frage“Option A und Option B, jede mit eigenem Aussehen, Vor- und Nachteilen
„yes“ akzeptiert die EmpfehlungSchaltfläche der empfohlenen Option oder „Ok“
Antwort des Nutzers als TextSchaltfläche A / B / Sonstiges oder Ok / Nein plus Kommentar
ErledigtEine Zeile im Bereich „Bestätigt“

Was visuell gezeigt wird

Jede Frage einer Runde ist genau ein Block eines der vier Typen. Nimm den einfachsten Typ, der passt: Ein Mockup kostet mehr als eine Textzeile, und überflüssige Bilder stören beim Lesen.

TypWannWas drinSchaltflächen
uiFrage danach, wie ein Bildschirm aussieht oder wie man darauf navigiert: Layout, Schaltflächen, Navigation, Schrittfolge, was wo gezeigt wirdEmpfehlung; links A, rechts B (ggf. auch C, D…); bei jedem Mockup, darunter Vor- und NachteileA · B (· C…) · Sonstiges
logicFrage nach Regeln, nicht nach dem Bildschirm: Wer macht was, Status, Fristen, Preise, DatenEmpfehlung; Tabelle: Aspekt · A · B (· C…)A · B (· C…) · Sonstiges
okEs gibt keine Optionen, nur einen Vorschlag von dirText des VorschlagsOk · Nein
plainBereits entschieden: im Chat, in einer früheren Runde, in ProjektdokumentenEine Zeile in „Bestätigt“—

Alle Fragen und alle Optionen nur im Fragebogen (Autorenregel). Erstelle kein separates Artefakt, um Optionen zu vergleichen, selbst wenn es viele sind: Füge sie derselben Frage als C, D, E, F hinzu (Felder c…f, siehe references/items.md). Normalerweise reichen zwei; ein dritter und weitere nur, wenn der Nutzer eine weitere Option wünscht oder es tatsächlich mehr als zwei gibt.

Regeln für UI-Mockups:

  • Zeichne ein Mockup nur, wenn der Unterschied zwischen A und B sichtbar ist. Wenn der Unterschied in Worten liegt, handelt es sich um logic oder ok.
  • Zeige, worin sich die Optionen unterscheiden, und so wenig Umgebung wie nötig, um zu verstehen, wo dies auf dem Bildschirm ist. Ein ganzer Bildschirm mit allen Details ist nicht nötig.
  • Zeichne A und B im gleichen Rahmen, mit denselben Daten und aus demselben Ausgangszustand: Dann sieht das Auge nur den Unterschied.
  • Verwende echte Projektdaten: Namen, Preise, Begriffe des Nutzers. Erfundenes (Namen, Beträge) kennzeichne in {{NOTE}} der Kopfzeile.
  • Für ein Szenario mit mehreren Schritten reicht ein Mockup pro Option: Die Schritte gehen von oben nach unten, die Aktion des Nutzers als grauer Hinweis („hat ‚Warenkorb‘ gedrückt“).
  • Vor- und Nachteile: jeweils 2–3 pro Option, einzeilig.
  • Mockup-Typ: Telegram-Chat (tg) für Bots, Telefon oder Browser (html mit Rahmen) für Apps und Websites. Felder und Klassen siehe references/items.md.

Wie das Artefakt aussieht

Die Seite ist kompakt und ruhig: normale Textgröße (14 px), keine großen Überschriften, kleine Abstände, nichts Überflüssiges – keine Dekoration, keine überflüssigen Tabellen, keine einleitenden Absätze. Helles und dunkles Design. All dies ist bereits in der Vorlage hinterlegt: Ändere das Design nicht, sondern ersetze nur die Einträge.

Von oben nach unten:

  1. Kopfzeile: Kleine graue Zeile – worauf sich die Tafel bezieht; Titel „Fragebogen: “; eine Zeile „Antworte direkt hier…“; optionaler Hinweis ({{NOTE}}).
  2. „Sonstiges“: Ein Textfeld und eine Schaltfläche „Speichern“ – Nachricht an den Chat, ohne den Fragebogen zu verlassen: Frage, Anmerkung oder Bitte, die sich auf keine der folgenden Fragen bezieht. Das Feld ist einmalig: Nach der Bearbeitung der Runde wird es geleert.
  3. „Noch zu bestätigen“ und die Anzahl offener Fragen. Jede Frage ist ein Block:
    • Nummer, Titel, ggf. Markierung „Zuerst dies“;
    • Kontextzeile in Grau, falls nötig;
    • Grünes Label „Ich empfehle: …“ (bei ui und logic);
    • Inhalt je nach Typ: ui – Spalten, links A, rechts B (bei einer dritten Option drei Spalten, bei vier oder mehr zwei pro Reihe), in jeder Spalte Beschriftung, Mockup, darunter Vorteile (+) und Nachteile (−); auf dem Handy werden die Spalten untereinander angeordnet. logic – Tabelle „Aspekt · A · B (· C…)“. ok – Text des Vorschlags;
    • Kommentarfeld;
    • Schaltflächen unten: eine Schaltfläche pro Option und „Sonstiges“ (bei ok – Ok · Nein). „Sonstiges“ erfordert einen Kommentar.
  4. „Bestätigt“ und Anzahl der Entscheidungen: nummerierte Liste, in jeder Zeile Datum und Entscheidung in einem Satz; unter der Zeile in Grau der Kommentar des Nutzers, falls vorhanden; kleiner Link „zurück zu den Fragen“.

Eine beantwortete Frage wandert sofort aus dem ersten in den zweiten Bereich.

Schritte

  1. Vorbereitung. Lade die Skills artifact-capabilities und artifact-design: Das Artifact-Tool benötigt sie vor der Veröffentlichung. Lade ArtifactData über ToolSearch.

  2. Seite. Der Seiten-Code ist bereits fertig – assets/template.html; erstelle keine neue Seite, kopiere nur die Vorlage in das Projekt und befüll sie über die Datenbank. Wenn der Ordner im Obsidian-Speicher liegt, lege sie in .code/grill/<thema>.html ab, andernfalls im Projektordner oder Scratchpad. Ersetze drei Markierungen:

    • {{TITLE}} (an zwei Stellen) – Name des Themas, 2–4 Wörter, z. B. „Bot Coffee Shop“. In der Vorlage steht bereits „Fragebogen: “ davor – so ist die Seite sofort unter anderen Artefakten erkennbar (Autorenregel), vollständiger Titel „Fragebogen: Bot Coffee Shop“;
    • {{SUBTITLE}} – worauf es sich bezieht, z. B. „Kunde Coffee Shop · Telegram-Bot“;
    • {{NOTE}} – Hinweis wie „Namen und Beträge in Mockups sind erfunden“ oder eine leere Zeile.

    Ändere nichts anderes in der Datei. Wenn es zu diesem Thema bereits eine solche Tafel gibt, arbeite damit: Artifact read über die URL, dann publish mit url.

  3. Veröffentlichung. Artifact publish, icon: „checklist“, capabilities: {“db“:{“rules“:[{“path“:“„,“read“:“view“,“write“:“admin“}]},“user“:{},“assets“:{}}. Die Regel write: admin bedeutet: Antworten können der Eigentümer und Redakteure, während jemand, der nur einen Lese-Link hat, nur zuschaut. assets wird für echte Fotos in Mockups benötigt: Lade sie in das Artefakt hoch (asset: true) und setze in den Einträgen den Link /_blob/<id>.

  4. Runde. Ein Aufruf von ArtifactData batch in die Sammlung items: ein Dokument pro Frage des Frontiers plus plain-Zeilen für bereits entschiedene. Die Reihenfolge bestimmt das Feld order, die dringendste Frage kann mit first: true markiert werden.

  5. Übergabe. Gib den Link, nenne in ein paar Zeilen die Fragen der Runde und bitte, „geantwortet“ zu schreiben: Die Seite meldet dir die Antworten nicht. Wenn eine Antwort sofort benötigt wird, stelle die Frage zusätzlich im Chat (AskUserQuestion) und trage die Antwort selbst in die Datenbank ein – genauso, wie die Seite sie eingetragen hätte.

  6. Antworten lesen. ArtifactData list der Sammlung items. Für jeden Eintrag mit status: „done“ und Feld answer:

    • a, b, ok, no – Entscheidung getroffen, die Seite hat bereits summary geschrieben. Wenn der Kommentar die Entscheidung präzisiert, überschreibe summary in einem Satz, sodass darin das tatsächlich Entscheidene steht.
    • other – lies den Kommentar. Handelt es sich um eine fertige Entscheidung, überschreibe summary in einem Satz. Ist es eine neue Option oder eine Gegenfrage, setze den Eintrag auf open zurück mit neuen Optionen oder erstelle eine neue Frage.
    • Übertrage die Entscheidungen an den Ort, an dem das Projekt sie speichert (Projektboard, Lastenheft, ADR), falls ein solcher Ort existiert.

    Lies außerdem „Sonstiges“ – ArtifactData get des Dokuments other in der Sammlung meta. Dies ist eine Nachricht des Nutzers an den Chat: Behandle sie wie eine Chat-Nachricht – antworte im Chat, erfülle die Bitte, schreibe die Entscheidung an den Ort, an dem das Projekt Entscheidungen speichert, erstelle aus der neuen Idee eine Frage in der nächsten Runde. Leere danach das Feld: update mit if_version, text: „„, und entferne reply, replyAt, at ({“__delete__“: true}). Verliere nichts daraus: Alles Notwendige ist bereits im Chat, auf der Tafel oder in den Fragen gespeichert.

    Berechne dann den Frontier neu und füge die nächste Runde mit demselben batch hinzu.

  7. Ende. Der Frontier ist leer – fasse das Ergebnis kurz zusammen und frage, ob das Verständnis gemeinsam ist.

Regeln zum Schreiben

  • Jeden Eintrag in ein vorhandenes Dokument schreibst du mit if_version aus dem letzten Lesevorgang: Der Nutzer könnte geantwortet haben, während du gearbeitet hast.
  • Das Feld answer ist die Antwort des Nutzers. Ändere es nicht, außer wenn du die Frage selbst wieder in die offenen zurückstellst.
  • Schreibe kurz: Titel bis zu 8 Wörter, Empfehlung 1–2 Sätze, Zeile in „Bestätigt“ ein Satz.
  • Sprache der Seite ist die Sprache des Nutzers. Die Beschriftungen der Vorlage sind auf Deutsch; für eine andere Sprache übersetze sie in einer Kopie der Vorlage.

Überprüfung

Nach der ersten Veröffentlichung – ein ArtifactData list (alle Einträge vorhanden) und ein Blick auf die Seite im Browser: Mockups werden gezeichnet, A und B stehen nebeneinander. Drücke keine Schaltflächen für den Nutzer: Das sind seine Antworten.

Verwandte Skills