CommunityEscrita e Ediçãogithub.com

Colaiz1p/grill-agent

Uma skill do Codex para entrevistas persistentes entre agente e subagente que exploram a intenção do usuário, revelam caminhos de solução inovadores e mantêm as decisões sob controle independente do agente principal.

O que é grill-agent?

O Grill Agent é uma skill especializada do Codex que implementa um protocolo completo de entrevista, revisão em tempo de execução e ciclo de vida para agentes de IA. Seu objetivo principal é permitir que um agente principal explore profundamente a intenção do usuário através de um subagente entrevistador, que descobre caminhos de solução materialmente novos sem usurpar a autoridade de decisão do agente principal. A skill é aplicada diretamente pelo agente principal e suporta plataformas como Codex, Claude Code e Cursor, funcionando em qualquer ambiente onde um agente possa invocar ferramentas de leitura limitada e spawn_agent. Ela opera através de um processo estruturado: reconhecimento limitado do projeto, mapeamento de cobertura como uma árvore de design, um passe de divergência para gerar hipóteses de intenção, e uma rodada de perguntas focadas na fronteira de decisão. O entrevistador nunca prefere uma opção, mas força o agente principal a tomar decisões independentes e bem fundamentadas, garantindo que cada escolha seja auditável e baseada em evidências verificadas do projeto.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add Colaiz1p/grill-agent

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Grill Agent

Esta skill é responsável pelo protocolo completo de entrevista, revisão em tempo de execução e ciclo de vida. Aplique-a diretamente; não invoque outra skill de entrevista.

Modelo de pares e contexto

Antes de instanciar, classifique o histórico de tarefas conhecido sem abrir armazenamentos não relacionados:

  • Para histórico relevante sem credencial conhecida, token, estado de conta ou conteúdo sensível não relacionado, crie o entrevistador com spawn_agent e fork_turns="all". Não passe uma substituição de model ou reasoning_effort. Registre isso como herança de pares de histórico completo, porque a bifurcação herda a configuração efetiva e o histórico da tarefa pai.
  • Quando o histórico atual ou anterior pode conter material sensível ou irrelevante, use a menor janela segura de turnos recentes, ou nenhum turno herdado, mais um pacote de evidências sementes sanitizado. Passe uma substituição de modelo ou raciocínio somente quando o usuário ou uma regra de prioridade mais alta exigir explicitamente e o valor for suportado pela configuração disponível. Registre paridade de modelo de pares não verificada a menos que a evidência visível pela ferramenta estabeleça paridade.

Antes de qualquer instanciação, registre a escolha de segurança de contexto e a melhor evidência disponível visível pela ferramenta ou de configuração para o modelo efetivo e esforço de raciocínio da tarefa pai. Escreva Sol xhigh herdado somente quando essa evidência estabelecer gpt-5.6-sol com xhigh; caso contrário, registre a configuração real ou desconhecida sem apresentar evidência de configuração como telemetria de tempo de execução.

Reconhecimento do projeto

Antes da fronteira inicial, o entrevistador realiza de forma independente um reconhecimento limitado de leitura: resolver o diretório de trabalho, raiz do repositório e cadeia ativa de AGENTS.md; inspecionar o estado do repositório e o diff; rastrear documentos relevantes para a tarefa, pontos de entrada, chamadores, configuração, testes, caminhos de validação e impactos entre módulos.

Não trate todo arquivo de projeto ou instrução aninhado abaixo do diretório de trabalho como contexto ativo. Pesquise por relevância da solicitação em vez de escanear todo o espaço de trabalho. Não leia armazenamentos de credenciais não relacionados, estado de conta ou arquivos contendo segredos; redija qualquer segredo encontrado incidentalmente.

Mantenha um resumo de reconhecimento compacto com verificado, não resolvido e deliberadamente fora do escopo. Termine o reconhecimento somente quando cada linha de cobertura aplicável tiver evidência ou uma lacuna nomeada, caminhos de execução e validação relevantes tiverem sido verificados, e dependências entre módulos descobertas tiverem sido incluídas ou excluídas com uma razão.

O entrevistador pode analisar a superfície de impacto total da tarefa: resultado, contratos, chamadores, compatibilidade, autoridade, falha e recuperação, validação, observabilidade e custo de manutenção. As descobertas não expandem a autoridade; o agente principal permanece o proprietário e executor das decisões.

Em tempo de execução, realize apenas reconhecimento delta. Inclua o gatilho, fatos alterados, linhas de cobertura afetadas e revisão de evidência revisada; desduplique a mesma decisão na mesma revisão de evidência.

Entrevista de cobertura

Mapeie o trabalho como uma árvore de design. Antes de fazer perguntas, construa um mapa de cobertura específico da tarefa com estas linhas:

  1. resultado e sucesso observável;
  2. estado atual, evidência e fatos desconhecidos;
  3. restrições, autoridade, compatibilidade e limites afetados;
  4. alternativas materiais e trade-offs;
  5. suposições ocultas, contraexemplos, modos de falha e efeitos de segunda ordem;
  6. condições de verificação, saída, recuperação ou reversão.

Marque cada linha exatamente como uma de:

  • coberto: resolvido a partir de evidência verificada ou uma decisão estabelecida;
  • evidência-necessária: investigação de leitura limitada de propriedade do agente permanece;
  • decisão-necessária: o agente principal deve decidir com base nos objetivos declarados do usuário, preferências conhecidas e suposições seguras explícitas;
  • não-aplicável: irrelevante, com uma razão concisa;
  • bloqueado-por-autoridade: uma regra de prioridade mais alta requer autorização do usuário que a entrevista não pode fornecer.

Defina uma profundidade baixa, média ou alta com base em irreversibilidade, ambiguidade, raio de explosão e novidade. Execute uma verificação de desafio em cada profundidade sem fabricar perguntas; profundidade média e alta devem resolver pelo menos uma suposição oculta material, contraexemplo, modo de falha ou efeito de segunda ordem.

Passe de divergência

Antes de calcular a fronteira, construa um inventário de caminhos interno:

  1. Infira o resultado visível ao usuário que o solicitante pode realmente querer. Represente cada palpite como uma hipótese de intenção, marcada como suportada ou incerta, com um suporte e um falsificador. Nunca apresente como fato verificado.
  2. Pesquise todas as quatro lentes em cada fronteira de decisão: resultado do usuário, hipótese causal, camada de intervenção e inversão/sem mudança/exclusão. Registre uma razão interna quando uma lente for inaplicável ou seus caminhos falharem nos portões; uma lente não precisa produzir um candidato.
  3. Um caminho materialmente novo altera pelo menos um de resultado do usuário, hipótese causal, camada de intervenção ou trade-off decisivo e pode mudar escopo, reparar costura, próxima ação ou verificação. Mescle variantes de redação, tecnologia e implementação local que deixem essas dimensões inalteradas.
  4. Baixa, média e alta profundidade inventariam pelo menos um, dois e três caminhos críveis respectivamente. Quando menos caminhos sobreviverem aos portões de evidência e novidade, registre a lente pesquisada e a rejeição internamente em vez de inventar um caminho. O número de caminhos é independente do número de perguntas.

Mantenha o inventário de caminhos interno. Mova apenas bifurcações que alteram a ação e que exigem uma decisão do agente principal para a fronteira, e comprima caminhos relacionados em candidatos sob a mesma pergunta. Um candidato visível baseado em intenção inferida começa com Hipótese de intenção — suportada: ou Hipótese de intenção — incerta:; sua evidência/trade-off declara o suporte e o falsificador.

A fronteira é toda decisão cujos pré-requisitos estão resolvidos. Pergunte toda a fronteira atual em uma rodada numerada; adie decisões que dependem de um pré-requisito em aberto. Cada resposta remodela a árvore, então recalcule o mapa e a fronteira após cada rodada. Encontrar fatos é trabalho do entrevistador: investigue linhas evidência-necessária através de suas próprias ferramentas de leitura limitada e nunca disfarce uma consulta como uma pergunta de decisão.

Para cada pergunta de decisão, apresente 2–4 candidatos materialmente distintos e mutuamente exclusivos. Decisões binárias mostram ambos os resultados; nunca fabrique opções sinônimas. Adicione evidência verificada concisa ou o trade-off decisivo quando ajudar a distinguir os candidatos. O entrevistador retém sua preferência até que o agente principal submeta sua revisão independente.

Use este formato de pergunta compacto:

RODADA_PERGUNTA

❓ **P1 — <título>**: <pergunta de decisão>

- **A.** <candidato>
- **B.** <candidato>
- **C.** <candidato materialmente distinto opcional>

**Evidência / trade-off:** <fato verificado conciso ou trade-off decisivo, quando disponível>

Contrato de resposta

Toda resposta do entrevistador começa com exatamente um token de estado em sua primeira linha não vazia. Esta tabela é a única fonte da verdade para estados de resposta:

EstadoPermitido quandoConteúdo obrigatórioAção do agente principal
RODADA_PERGUNTARevisão de decisão inicial, todo acompanhamento orientado por resposta, e toda revisão de decisão de tempo de execução despachadaToda decisão desbloqueada em um bloco de pergunta numerado; candidatos e evidência ou trade-offs úteis; nenhuma preferência do entrevistadorSubmeter uma revisão independente por pergunta
ANÁLISE_INSUFICIENTEUma revisão submetida é inadequadaRótulos Pn estáveis e uma pergunta de correção direcionada por elemento de revisão ausente ou contra-evidência material; nenhum candidato repetidoRevisar apenas as revisões nomeadas
AUTORIDADE_NECESSÁRIAUma ação específica requer autoridade do usuário que não está presenteA ação exata, alvo, impacto, reversibilidade e uma pergunta de autorização precisaPerguntar ao usuário; nunca responder em nome do usuário
FRONTEIRA_LIMPAPelo menos um estado de formato de pergunta foi resolvido; toda cobertura está resolvida; nenhum fato, decisão, autoridade ou ramo downstream aberto permaneceLimpeza e qualquer risco residual conciso; nenhuma conclusão baseada apenas em preferênciaPublicar qualquer registro de decisão, então executar ou retomar

Reconhecimento, cobertura, desafio e detalhes do ciclo de vida permanecem estado de trabalho interno. Eles informam a resposta, mas nunca substituem o conteúdo exigido por seu estado.

Para uma fronteira de decisão, profundidade baixa exige pelo menos uma pergunta genuína na RODADA_PERGUNTA inicial. Profundidade média e alta exigem pelo menos duas perguntas genuínas de dimensões de cobertura aplicáveis distintas, normalmente resultado ou escopo mais evidência, risco ou verificação. Pergunte toda decisão adicional desbloqueada na mesma rodada. Nunca preencha uma rodada com perguntas sinônimas ou irrelevantes para o resultado.

Apenas uma fronteira apenas com autoridade pode usar AUTORIDADE_NECESSÁRIA como seu primeiro estado. Sua pergunta de autorização satisfaz o portão de formato de pergunta inicial, mas não é uma revisão de decisão do agente principal. Se alguma evidência ou decisão de design também estiver aberta, use RODADA_PERGUNTA primeiro.

Um acompanhamento orientado por resposta contém pelo menos uma pergunta e pergunta toda decisão recém-desbloqueada ou reaberta sem repetir perguntas resolvidas. Uma entrevista de decisão de tempo de execução despachada contém pelo menos uma pergunta e cobre toda decisão delta reaberta sem repetir perguntas resolvidas.

Os rótulos das perguntas são únicos e monotonicamente crescentes no ciclo de vida de nível superior. Continue a numeração entre rodadas iniciais, orientadas por resposta e de tempo de execução. Reabra uma decisão existente como Pn.rK, onde K é a contagem de revisões daquela decisão, em vez de atribuir uma nova identidade.

FRONTEIRA_LIMPA nunca é uma primeira resposta aceita válida em um ciclo de vida.

Portão de protocolo do lado receptor

Antes de consumir uma resposta do entrevistador, o agente principal valida todas estas condições:

  1. a primeira linha não vazia e o payload satisfazem uma linha da tabela de resposta;
  2. toda pergunta RODADA_PERGUNTA tem um rótulo válido para o ciclo de vida, 2–4 candidatos materialmente diferentes mutuamente exclusivos, evidência ou trade-offs úteis quando disponíveis, e nenhuma preferência do entrevistador;
  3. toda rodada de pergunta atende seu mínimo específico de profundidade e cobre toda a fronteira atual.

Quando um candidato visível contém intenção de usuário inferida, valide seu rótulo de intenção qualitativo, suporte e falsificador. Rejeite alternativas decorativas que não atendam aos portões de novidade material e relevância de ação.

Um relatório, conclusão, auditoria, resposta baseada apenas em preferência, FRONTEIRA_LIMPA prematuro ou payload de estado malformado é inválido. O agente principal pausa o trabalho substantivo e envia uma RETENTATIVA_FORMATO para o mesmo entrevistador canônico na mesma revisão de evidência, nomeando apenas os requisitos estruturais ausentes. Se essa retentativa ainda for inválida, emita ENTREVISTA_INDISPONÍVEL e pare; nunca aceite o payload como limpo, crie um entrevistador de substituição ou simule as perguntas ausentes.

Portão de decisão independente

O entrevistador expõe e desafia decisões; o agente principal decide. Para cada pergunta em uma RODADA_PERGUNTA, o agente principal submete uma revisão de decisão separadamente rotulada (P1, P2 e assim por diante). Cada revisão contém:

  • sua própria escolha entre os candidatos exibidos, ou uma alternativa justificada;
  • evidência verificada de arquivos relevantes, chamadores, configuração, testes ou outros fatos da tarefa;
  • um contra-argumento crível, modo de falha ou alternativa rejeitada;
  • uma justificativa concisa que o agente principal deriva independentemente usando evidência do projeto;
  • incerteza residual e a evidência concreta que mudaria sua conclusão.

Uma resposta consistindo apenas em um rótulo de candidato, concordo, redação copiada do entrevistador ou uma preferência sem fundamento é insuficiente mesmo quando seleciona um candidato defensável.

O entrevistador deve julgar a qualidade da revisão, não a concordância, e aceita uma escolha bem suportada que difere de sua preferência. Ele declara discordância apenas quando a evidência expõe um elemento de revisão ausente ou reabre uma decisão. Para uma revisão ausente, incompatível, incompleta, copiada ou cega a contra-evidência material, retorne ANÁLISE_INSUFICIENTE, nomeie a pergunta e a lacuna, e mantenha seus ramos downstream abertos. Nunca anexe prosa de preferência apenas a FRONTEIRA_LIMPA.

Uma revisão válida resolve apenas sua pergunta rotulada; ela não resolve decisões downstream não perguntadas.

Após cada conjunto completo de revisões de decisão válidas, o mesmo entrevistador executa um passe de convergência orientado por resposta antes de poder retornar FRONTEIRA_LIMPA:

  1. Recalcule a árvore de design e a fronteira a partir das revisões, então desafie cada resposta por suposições ocultas, contraexemplos críveis, limites, modos de falha, efeitos de segunda ordem e linhas de cobertura alteradas.
  2. Execute o passe de divergência novamente quando uma resposta altera a intenção do usuário, uma premissa causal, uma classe de caminho ou uma restrição material, ou quando a evidência contradiz o panorama atual.
  3. Resolva qualquer ramo de evidência necessária através de reconhecimento limitado de leitura; não apresente uma consulta de fato como uma pergunta de decisão.
  4. Se algum ramo downstream ou reaberto permanecer, retorne RODADA_PERGUNTA com toda decisão recém-desbloqueada ou reaberta. O agente principal responde a essa rodada independentemente, e o mesmo passe de convergência é executado novamente.
  5. Retorne FRONTEIRA_LIMPA somente quando este passe não deixar nenhum ramo aberto. Revisões válidas sozinhas nunca permitem liberação.

O usuário observa entrevistas comuns, mas não as responde: o agente principal submete toda revisão independente. Limites de autorização explícitos ainda se aplicam; marque-os como bloqueado-por-autoridade em vez de adivinhar permissão.

Registro de decisão visível ao usuário

Quando uma fronteira de decisão atinge FRONTEIRA_LIMPA e antes de retomar a execução substantiva, o agente principal publica um registro incremental contendo toda pergunta de decisão resolvida desde a última fronteira limpa:

DECISÕES_ENTREVISTA

P1. <pergunta>
- Escolha principal: <rótulo> — <texto da opção selecionada>
- Evidência: <um fato verificável conciso que suporta a escolha do agente principal>

Use os rótulos globais do ciclo de vida, incluindo rótulos de revisão para decisões reabertas. Isso é uma auditoria compacta, não uma cadeia de pensamento oculta: omita traços de raciocínio privados e preferências do entrevistador.

...

Habilidades Relacionadas