Communitygithub.com

grill-me-visualmente

Grill-me como artefacto: interrogatorio visual por rondas de preguntas con recomendaciones, donde las preguntas viven en una página-artefacto y el usuario responde directamente en ella.

¿Qué es grill-me-visualmente?

Este skill transforma el clásico «grill-me» (interrogatorio iterativo para alcanzar un entendimiento compartido) en una experiencia visual interactiva. En lugar de que las preguntas y respuestas ocurran solo en el chat, se genera una página web auto-contenida (artefacto) donde cada ronda de preguntas se presenta con bloques visuales: para decisiones de interfaz (ui) muestra mini-maquetas A/B con pros y contras; para decisiones lógicas (logic) usa tablas comparativas; para propuestas simples (ok) ofrece botones de Ok/No; y para decisiones ya tomadas (plain) las lista como confirmadas. El usuario responde directamente en la página mediante botones y comentarios, y las respuestas se reflejan automáticamente en las secciones «Necesita confirmación» y «Confirmado». El skill está diseñado para plataformas como Claude Code, Cursor, Codex, y cualquier agente que pueda publicar artefactos HTML con base de datos. Su utilidad principal es agilizar la toma de decisiones en diseño de bots, aplicaciones o sitios web cuando hay múltiples opciones visuales o lógicas que evaluar, evitando largos hilos de chat y permitiendo una comparación visual clara. El flujo de trabajo incluye preparar el artefacto con una plantilla, publicarlo, realizar rondas de preguntas, leer las respuestas desde la base de datos, y continuar hasta que el frente de decisiones esté vacío.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Grill me visualmente

La primera parte es el grill-me original, palabra por palabra. Luego, cómo llevar el mismo interrogatorio de forma visual, en una página-artefacto.

Grill-me

Entrevista al usuario sin descanso hasta alcanzar un entendimiento compartido. Mapea esto como un árbol de diseño: cada decisión se ramifica en las decisiones que dependen de ella.

Trabaja el árbol en rondas. El frente son todas las decisiones cuyos prerrequisitos ya están resueltos: las preguntas que puedes hacer ahora sin adivinar respuestas que aún no has escuchado. Pregunta todo el frente en una ronda: numera cada pregunta y da tu respuesta recomendada. Luego espera las respuestas del usuario antes de la siguiente ronda.

Formatea una ronda así:

❓ **P1** - **<título de la pregunta>**: <cuerpo de la pregunta, puede tener varios párrafos, incluyendo opciones múltiples>

➡️ <tu respuesta recomendada>

---

❓ **P2** - **<título de la pregunta>**: <cuerpo de la pregunta, puede tener varios párrafos, incluyendo opciones múltiples>

➡️ <tu respuesta recomendada>

Redacta cada pregunta de modo que "sí" acepte tu respuesta recomendada.

Cada ronda, las respuestas del usuario reconfiguran el árbol: las decisiones resueltas empujan el frente hacia afuera y desbloquean preguntas que dependían de ellas. Recalcula el frente y pregunta la siguiente ronda. Una pregunta cuya respuesta depende de otra pregunta aún abierta en esta ronda pertenece a una ronda posterior, no a esta.

Encontrar hechos es tu trabajo, nunca del usuario. Cuando una pregunta del frente necesite un hecho del entorno (sistema de archivos, herramientas, etc.), envía un sub-agente con una ventana de contexto nueva para encontrarlo; no le pidas al usuario nada que puedas buscar tú mismo. No te detengas por eso: una exploración en curso es un prerrequisito no resuelto, así que solo las preguntas que dependen de ella esperan el informe del sub-agente; pregunta el resto del frente ahora. Las decisiones son del usuario: preséntaselas y espera.

La sesión termina cuando el frente está vacío: cada rama del árbol de diseño visitada, sin nada asumido en silencio. No actúes hasta que el usuario confirme que se ha alcanzado un entendimiento compartido.

Cómo una ronda se convierte en artefacto

Todo lo anterior sigue vigente. Solo cambia el lugar donde vive la ronda: en lugar de texto en el chat, registros en una página-artefacto (plantilla assets/template.html), y el usuario responde con botones y comentarios.

En grill-meEn la página
❓ P1 - título: texto de la preguntaBloque de pregunta: número, título, línea de contexto
➡️ respuesta recomendadaPlaca verde «Recomiendo: …»
«Opciones dentro de la pregunta»Opción A y Opción B, cada una con su propia vista, pros y contras
«sí» acepta la recomendaciónBotón de la opción recomendada o «Ok»
Respuesta del usuario en textoBotón A / B / Otro o Ok / No más comentario
ResueltoUna línea en la sección «Confirmado»

Qué mostrar visualmente

Cada pregunta de la ronda es exactamente un bloque de uno de los cuatro tipos. Elige el tipo más simple que corresponda: un maqueta cuesta más que una línea de texto, y las imágenes adicionales estorban la lectura.

TipoCuándoQué contieneBotones
uiPregunta sobre cómo se ve una pantalla o cómo se navega en ella: disposición, botones, navegación, orden de pasos, qué se muestra dóndeRecomendación; a la izquierda A, a la derecha B (si es necesario, también C, D…); cada uno con maqueta, debajo pros y contrasA · B (· C…) · Otro
logicPregunta sobre reglas, no sobre pantallas: quién hace qué, estados, plazos, precios, datosRecomendación; tabla: aspecto · A · B (· C…)A · B (· C…) · Otro
okNo hay opciones, hay una sola propuesta tuyaTexto de la propuestaOk · No
plainYa resuelto: en el chat, en una ronda anterior, en documentos del proyectoUna línea en «Confirmado»—

Todas las preguntas y todas las opciones solo en el cuestionario (regla del autor). No hagas un artefacto aparte para comparar opciones, incluso si son muchas: agrégalas a la misma pregunta como C, D, E, F (campos c…f, ver references/items.md). Normalmente bastan dos; la tercera y siguientes solo cuando el usuario pida otra opción o realmente haya más de dos.

Reglas para maquetas ui:

  • Dibuja una maqueta solo cuando la diferencia entre A y B sea visible a simple vista. Si la diferencia es en palabras, es logic o ok.
  • Muestra solo en qué se diferencian las opciones y el mínimo contexto necesario para entender dónde está eso en la pantalla. No se necesita una pantalla completa con todos los detalles.
  • Dibuja A y B en el mismo marco, con los mismos datos y desde el mismo estado inicial: así el ojo solo ve la diferencia.
  • Usa datos reales del proyecto: nombres, precios, términos del usuario. Lo inventado (nombres, cantidades) márcalo con {{NOTE}} en el encabezado.
  • Para un escenario de varios pasos, basta una maqueta por opción: los pasos van de arriba abajo, la acción del usuario con una nota gris («hizo clic en «Carrito»»).
  • Pros y contras: de 2 a 3 por opción, una línea cada uno.
  • Tipo de maqueta: chat de Telegram (tg) para bots, teléfono o navegador (html con marco) para aplicaciones y sitios web. Campos y clases en references/items.md.

Cómo se ve el artefacto

La página es compacta y sobria: tamaño de texto normal (14 px), sin títulos grandes, márgenes pequeños, nada superfluo — sin decoración, sin tablas innecesarias, sin párrafos introductorios. Tema claro y oscuro. Todo esto ya está en la plantilla: no rediseñes, solo cambia los registros.

De arriba abajo:

  1. Encabezado: línea gris pequeña — a qué pertenece el panel; título «Cuestionario: »; una línea «Responde aquí directamente…»; nota opcional ({{NOTE}}).
  2. «Otros»: un campo de texto y un botón «Guardar» — mensaje al chat sin salir del cuestionario: pregunta, observación o solicitud que no pertenece a ninguna pregunta de abajo. El campo es de un solo uso: después de procesar la ronda, se limpia.
  3. «Necesita confirmación» y número de preguntas abiertas. Cada pregunta es un bloque:
    • número, título, si es necesario la marca «Primero esto»;
    • línea de contexto en gris, si es necesaria;
    • placa verde «Recomiendo: …» (para ui y logic);
    • contenido según el tipo: ui — columnas, izquierda A, derecha B (con tercera opción, tres columnas; con cuatro o más, dos por fila), cada una con etiqueta, maqueta, debajo pros (+) y contras (−); en teléfono las columnas se apilan. logic — tabla «aspecto · A · B (· C…)». ok — texto de la propuesta;
    • campo de comentario;
    • botones abajo: un botón por opción y «Otro» (para ok — Ok · No). «Otro» requiere comentario.
  4. «Confirmado» y número de decisiones: lista numerada, cada línea con fecha y decisión en una oración; debajo de la línea en gris, el comentario del usuario si lo hubo; pequeño enlace «volver a preguntas».

Una pregunta respondida se mueve inmediatamente de la primera sección a la segunda.

Pasos

  1. Preparación. Carga los skills artifact-capabilities y artifact-design: la herramienta Artifact los necesita antes de publicar. Carga ArtifactData mediante ToolSearch.

  2. Página. El código de la página ya está listo — assets/template.html; no escribas una página nueva, solo copia la plantilla al proyecto y llénala con preguntas a través de la base de datos. Si la carpeta está en el almacenamiento Obsidian, ponla en .code/grill/<tema>.html, de lo contrario en la carpeta del proyecto o scratchpad. Reemplaza tres marcadores:

    • {{TITLE}} (dos lugares) — nombre del tema, 2–4 palabras, ej. «bot Coffee Shop». En la plantilla ya está precedido por «Cuestionario: » — así la página se reconoce entre otros artefactos (decisión del autor), el nombre completo será «Cuestionario: bot Coffee Shop»;
    • {{SUBTITLE}} — a qué pertenece, ej. «Cliente Coffee Shop · Bot de Telegram»;
    • {{NOTE}} — nota como «Nombres y cantidades en las maquetas son inventados» o una línea vacía.

    No cambies nada más en el archivo. Si ya existe un panel para ese tema, trabaja con él: Artifact read por su URL, luego publish con url.

  3. Publicación. Artifact publish, icon: "checklist", capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. La regla write: admin significa que solo el propietario y los editores pueden responder; quien tenga el enlace de solo vista solo puede mirar. assets es necesario para fotos reales en las maquetas: súbelas al artefacto (asset: true) y pon la referencia /_blob/<id> en los registros.

  4. Ronda. Una llamada a ArtifactData batch en la colección items: un documento por cada pregunta del frente más las líneas plain para lo ya resuelto. El orden lo define el campo order, la pregunta más urgente se puede marcar con first: true.

  5. Transferencia. Da el enlace, en un par de líneas nombra las preguntas de la ronda y pide que escriba «respondí»: la página no te notifica las respuestas. Si necesitas la respuesta de inmediato, haz la pregunta también en el chat (AskUserQuestion) y escribe la respuesta tú mismo en la base de datos — igual que lo habría hecho la página.

  6. Lectura de respuestas. ArtifactData list de la colección items. Para cada registro con status: "done" y campo answer:

    • a, b, ok, no — decisión tomada, la página ya escribió summary. Si el comentario aclara la decisión, reescribe summary en una línea de modo que contenga lo que realmente se decidió.
    • other — lee el comentario. Si es una solución ya lista, reescribe summary en una línea. Si es una nueva opción o una pregunta de vuelta, devuelve el registro a open con nuevas opciones o crea una nueva pregunta.
    • Traslada las decisiones a donde el proyecto las guarde (tablero del proyecto, especificaciones, ADR), si existe ese lugar.

    También lee «Otros» — ArtifactData get del documento other en la colección meta. Es el mensaje del usuario al chat: trátalo como un mensaje en el chat — responde en el chat, cumple la solicitud, escribe la decisión donde el proyecto guarda las decisiones, convierte la nueva idea en una pregunta en la siguiente ronda. Después, limpia el campo: update con if_version, text: "", y elimina reply, replyAt, at ({"__delete__": true}). No pierdas nada de eso: todo lo necesario ya está registrado en el chat, en el tablero o en las preguntas.

    Luego recalcula el frente y añade la siguiente ronda con el mismo batch.

  7. Fin. El frente está vacío — resume brevemente el resultado y pregunta si hay entendimiento compartido.

Reglas de escritura

  • Cualquier escritura en un documento existente debe usar if_version de la última lectura: el usuario podría haber respondido mientras trabajabas.
  • El campo answer es la respuesta del usuario. No lo cambies, excepto cuando tú mismo devuelvas la pregunta a las abiertas.
  • Escribe corto: título hasta 8 palabras, recomendación 1–2 oraciones, línea en «Confirmado» una oración.
  • El idioma de la página es el idioma del usuario. Las etiquetas de la plantilla están en ruso; para otro idioma, tradúcelas en una copia de la plantilla.

Verificación

Después de la primera publicación — una llamada a ArtifactData list (todos los registros en su lugar) y un vistazo a la página en el navegador: las maquetas se dibujan, A y B están una al lado de la otra. No presiones los botones por el usuario: esas son sus respuestas.

Skills relacionados