Communitygithub.com

grill-me-visualmente

Grill-me como artefato: entrevista visual baseada em plano ou ideia com perguntas por rodadas, recomendações, e respostas na própria página.

O que é grill-me-visualmente?

Esta skill transforma o processo de entrevista do grill-me original em uma experiência visual interativa em uma página de artefato. Em vez de diálogo textual no chat, cada rodada de perguntas é apresentada em uma página web dedicada, onde o usuário responde clicando em botões e deixando comentários. A skill organiza as perguntas em uma 'árvore de design' e as exibe em dois blocos: 'Precisa confirmar' (perguntas abertas) e 'Confirmado' (decisões tomadas). Cada pergunta pode ser de quatro tipos visuais: `ui` (para comparação de layouts de tela com miniaturas), `logic` (para decisões baseadas em regras com tabelas A/B), `ok` (para propostas simples) e `plain` (para decisões já tomadas). É particularmente útil em discussões de design de bots, sites ou aplicativos, onde comparar variações visuais lado a lado é mais eficiente do que descrevê-las. A skill suporta os artefatos e o banco de dados integrado do assistente (ArtifactData), permitindo que o usuário responda diretamente na página e que a skill leia as respostas para continuar o processo de refinamento.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Grill me visualmente

A primeira parte é o grill-me original, palavra por palavra. Depois, como conduzir a mesma entrevista visualmente, em uma página de artefato.

Grill-me

Entreviste o usuário incansavelmente até alcançar um entendimento compartilhado. Mapeie isso como uma árvore de decisão: cada decisão se ramifica nas decisões que dependem dela.

Trabalhe a árvore em rodadas. A fronteira é toda decisão cujos pré-requisitos já estão resolvidos: as perguntas que você pode fazer agora sem adivinhar respostas que ainda não ouviu. Pergunte toda a fronteira em uma rodada: numere cada pergunta e dê sua resposta recomendada. Então aguarde as respostas do usuário antes da próxima rodada.

Formate uma rodada assim:

❓ **P1** - **<título da pergunta>**: <corpo da pergunta, pode ter vários parágrafos, incluindo múltiplas opções>

➡️ <sua resposta recomendada>

---

❓ **P2** - **<título da pergunta>**: <corpo da pergunta, pode ter vários parágrafos, incluindo múltiplas opções>

➡️ <sua resposta recomendada>

Formule cada pergunta de modo que "sim" aceite sua resposta recomendada.

Cada rodada em que o usuário responde remodela a árvore: decisões resolvidas expandem a fronteira e desbloqueiam perguntas que dependiam delas. Recalcule a fronteira e pergunte a próxima rodada. Uma pergunta cuja resposta depende de outra pergunta ainda aberta nesta rodada pertence a uma rodada posterior, não a esta.

Encontrar fatos é seu trabalho, nunca do usuário. Quando uma pergunta de fronteira precisar de um fato do ambiente (sistema de arquivos, ferramentas etc.), despache um subagente com uma janela de contexto nova para encontrá-lo; não pergunte ao usuário nada que você mesmo possa descobrir. Não bloqueie por causa disso: uma exploração em andamento é um pré-requisito não resolvido, então apenas as perguntas a jusante dela aguardam o relatório do subagente; faça o resto da fronteira agora. As decisões são do usuário: apresente cada uma a ele e aguarde.

A sessão termina quando a fronteira está vazia: todos os ramos da árvore de decisão visitados, nada deixado como suposição silenciosa. Não aja até que o usuário confirme que vocês alcançaram um entendimento compartilhado.

Como uma rodada se torna um artefato

Tudo acima continua valendo. A única mudança é o local onde a rodada vive: em vez de texto no chat, são registros em uma página de artefato (template assets/template.html), e o usuário responde com botões e comentários.

No grill-meNa página
❓ P1 - título: texto da perguntaBloco de pergunta: número, título, linha de contexto
➡️ resposta recomendadaEtiqueta verde "Recomendo: …"
"Opções dentro da pergunta"Opção A e opção B, cada uma com seu visual, prós e contras
"sim" aceita a recomendaçãoBotão da opção recomendada ou "Ok"
Resposta do usuário em textoBotão A / B / Outro ou Ok / Não mais comentário
ResolvidoUma linha na seção "Confirmado"

O que mostrar visualmente

Cada pergunta da rodada é exatamente um bloco de um dos quatro tipos. Escolha o tipo mais simples que se aplica: um layout custa mais caro que uma linha de texto, e imagens extras atrapalham a leitura.

TipoQuandoO que contémBotões
uiPergunta sobre a aparência da tela ou como navegar: layout, botões, navegação, ordem das etapas, o que é mostrado ondeRecomendação; A à esquerda, B à direita (se necessário, também C, D…); layout de cada um, abaixo prós e contrasA · B (· C…) · Outro
logicPergunta sobre regras, não sobre a tela: quem faz o quê, status, prazos, preços, dadosRecomendação; tabela: aspecto · A · B (· C…)A · B (· C…) · Outro
okNão há opções, há uma única proposta suaTexto da propostaOk · Não
plainJá resolvido: no chat, em rodada anterior, em documentos do projetoUma linha em "Confirmado"—

Todas as perguntas e todas as opções — apenas no questionário (regra do autor). Não crie um artefato separado para comparar opções, mesmo que sejam muitas: adicione-as à mesma pergunta como C, D, E, F (campos c…f, veja references/items.md). Normalmente duas bastam; a terceira e seguintes — quando o usuário pedir mais uma opção ou elas realmente forem mais de duas.

Regras para layouts ui:

  • Desenhe um layout apenas quando a diferença entre A e B for visível a olho nu. Se a diferença for de palavras, é logic ou ok.
  • Mostre apenas o que difere entre as opções e o mínimo de contexto para entender onde fica na tela. Não precisa da tela inteira com todos os detalhes.
  • Desenhe A e B na mesma moldura, com os mesmos dados e a partir do mesmo estado inicial: assim o olho vê apenas a diferença.
  • Use dados reais do projeto: nomes, preços, termos do usuário. Dados fictícios (nomes, valores) marque com {{NOTE}} no cabeçalho.
  • Para um cenário de várias etapas, basta um layout por opção: as etapas vão de cima para baixo, a ação do usuário com uma anotação em cinza ("clicou em 'Carrinho'").
  • Prós e contras: 2–3 por opção, uma linha cada.
  • Tipo de layout: chat Telegram (tg) para bots, telefone ou navegador (html com moldura) para aplicativos e sites. Campos e classes em references/items.md.

Como é o artefato

A página é compacta e sóbria: tamanho de texto normal (14 px), sem títulos grandes, margens pequenas, nada supérfluo — sem decoração, sem tabelas extras, sem parágrafos introdutórios. Tema claro e escuro. Tudo isso já está no template: não mude o design, altere apenas os registros.

De cima para baixo:

  1. Cabeçalho: linha cinza pequena — a que se refere o quadro; título "Questionário: "; uma linha "Responda aqui…"; observação opcional ({{NOTE}}).
  2. "Outros": um campo de texto e botão "Salvar" — mensagem para o chat sem sair do questionário: pergunta, observação ou pedido que não se relaciona a nenhuma pergunta abaixo. O campo é descartável: após processar a rodada, é limpo.
  3. "Precisa confirmar" e número de perguntas abertas. Cada pergunta é um bloco:
    • número, título, se necessário marcador "Primeiro isto";
    • linha de contexto em cinza, se necessário;
    • etiqueta verde "Recomendo: …" (para ui e logic);
    • conteúdo conforme o tipo: ui — colunas, A à esquerda, B à direita (com terceira opção, três colunas; com quatro ou mais, duas por linha), cada uma com legenda, layout, abaixo prós (+) e contras (−); no celular, colunas empilham-se verticalmente. logic — tabela "aspecto · A · B (· C…)". ok — texto da proposta;
    • campo de comentário;
    • botões abaixo: um botão por opção e "Outro" (para ok — Ok · Não). "Outro" exige comentário.
  4. "Confirmado" e número de decisões: lista numerada, cada linha com data e decisão em uma frase; abaixo, em cinza, o comentário do usuário, se houver; link pequeno "voltar às perguntas".

Uma pergunta respondida move-se imediatamente da primeira seção para a segunda.

Passos

  1. Preparação. Carregue as skills artifact-capabilities e artifact-design: a ferramenta Artifact as exige antes da publicação. Carregue ArtifactData via ToolSearch.

  2. Página. O código da página já está pronto — assets/template.html; não escreva uma nova página, apenas copie o template para o projeto e preencha com perguntas via banco de dados. Se a pasta estiver no repositório Obsidian, coloque em .code/grill/<tema>.html, caso contrário, na pasta do projeto ou scratchpad. Substitua três marcadores:

    • {{TITLE}} (dois lugares) — nome do tema, 2–4 palavras, por exemplo "bot Coffee Shop". No template, já está precedido por "Questionário: " — assim a página se destaca entre outros artefatos (decisão do autor), o título completo será "Questionário: bot Coffee Shop";
    • {{SUBTITLE}} — a que se refere, por exemplo "Cliente Coffee Shop · Bot Telegram";
    • {{NOTE}} — observação como "Nomes e valores nos layouts são fictícios" ou linha vazia.

    Não altere o resto do arquivo. Se já existir um quadro para o tema, trabalhe com ele: Artifact read pela URL, depois publish com url.

  3. Publicação. Artifact publish, icon: "checklist", capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. A regra write: admin significa: apenas o proprietário e editores podem responder; quem receber o link de visualização apenas vê. assets é necessário para fotos reais nos layouts: carregue-as no artefato (asset: true) e coloque no registro o link /_blob/<id>.

  4. Rodada. Uma chamada ArtifactData batch na coleção items: um documento por pergunta da fronteira mais linhas plain para o que já foi resolvido. A ordem é definida pelo campo order; a pergunta mais urgente pode ser marcada com first: true.

  5. Entrega. Dê o link, em algumas linhas nomeie as perguntas da rodada e peça para escrever "respondi": a página não te notifica sobre respostas. Se precisar de resposta imediata, faça a pergunta também no chat (AskUserQuestion) e registre a resposta você mesmo no banco — da mesma forma que a página a registraria.

  6. Leitura das respostas. ArtifactData list da coleção items. Para cada registro com status: "done" e campo answer:

    • a, b, ok, no — decisão tomada, a página já registrou summary. Se o comentário esclarecer a decisão, reescreva summary em uma linha para refletir o que foi realmente decidido.
    • other — leia o comentário. Se for uma decisão pronta, reescreva summary em uma linha. Se for uma nova opção ou contra-pergunta, retorne o registro para open com novas opções ou crie uma nova pergunta.
    • Transfira as decisões para onde o projeto as armazena (quadro do projeto, especificação, ADR), se houver tal lugar.

    Leia também "Outros" — ArtifactData get do documento other na coleção meta. É uma mensagem do usuário para o chat: trate-a como uma mensagem no chat — responda no chat, atenda ao pedido, registre a decisão onde o projeto armazena decisões, transforme uma nova ideia em pergunta na próxima rodada. Depois, limpe o campo: update com if_version, text: "", e remova reply, replyAt, at ({"__delete__": true}). Não perca nada dele: tudo o que for necessário já está registrado no chat, no quadro ou nas perguntas.

    Em seguida, recalcule a fronteira e adicione a próxima rodada com o mesmo batch.

  7. Fim. Fronteira vazia — faça um breve resumo do resultado e pergunte se o entendimento é compartilhado.

Regras de registro

  • Qualquer alteração em um documento existente deve usar if_version da última leitura: o usuário pode ter respondido enquanto você trabalhava.
  • O campo answer é a resposta do usuário. Não o altere, exceto quando você mesmo retornar a pergunta para aberta.
  • Escreva de forma concisa: título com até 8 palavras, recomendação de 1–2 frases, linha em "Confirmado" com uma frase.
  • O idioma da página é o idioma do usuário. Os rótulos do template estão em português; para outro idioma, traduza-os em uma cópia do template.

Verificação

Após a primeira publicação, faça um ArtifactData list (todos os registros no lugar) e uma olhada na página no navegador: layouts são desenhados, A e B estão lado a lado. Não clique nos botões pelo usuário: são respostas dele.

Habilidades Relacionadas