Lógica de salto e ramificação

Configura a lógica da pesquisa para que nenhum respondente caia num beco sem saída

Skill grátis para Claude Code, Codex, Cursor e Gemini CLI. Funciona pelo servidor MCP do SurveyNinja, com as suas permissões.

Categoria
Criar e divulgar
Tags
lógica e ramificação, redação
Funciona com
Claude Code, Codex, Cursor, Gemini CLI
Ferramentas MCP
3, 2 alteram dados
Versão
1.0.1, 20 de outubro de 2026
Feita por
SurveyNinja
Preço
Grátis
Arquivo da skill
SKILL.md

O que ela faz

  • Cada um vê só as suas perguntas. Ramificações, perguntas exibidas ou ocultas, blocos pulados, desqualificações e cotas poupam o respondente do que não se aplica a ele.
  • Nenhuma ramificação sem saída. Toda ramificação tem saída, para o próximo bloco ou para o fim da pesquisa.
  • Toda rota é conferida. Depois da edição, a skill percorre cada ramificação da primeira pergunta até o fim.

Exemplo

Você escreve

Se alguém der nota abaixo de quatro, pergunte o motivo

O que o assistente traz

4
Ramificações
0
Sem saídacada rota percorrida
0
Inalcançáveis
0
Loopssem saltos para trás
  1. Nota abaixo de 4 → "O que deu errado?" ramificação por resposta · pergunta 2
  2. Nota 4 ou mais → pular a pergunta 3 bloco pulado
  3. "Nunca usei o serviço" → desqualificação screenout · pergunta 4
  4. 200 respostas no grupo → fechar a cota cota
"Outro" dispara pela opção, não pelo texto

Um erro comum é esperar que o salto reaja ao que foi digitado no campo "Outro". A condição reage à escolha da opção; o texto não entra na conta.

As regras acima são um exemplo. A lógica é montada a partir das suas perguntas e dos identificadores delas.

Como funciona

  1. Lê a estrutura primeiroA skill lê primeiro os identificadores das perguntas, então cada condição aponta para uma pergunta real.
  2. Monta o tipo certo de regraRamificação por resposta, pergunta exibida ou oculta, bloco pulado, desqualificação de quem não tem o perfil ou cota por grupo, conforme a necessidade.
  3. Conhece as armadilhas comuns"Outro" dispara pela opção, não pelo texto digitado. "Maior que" não funciona com texto. As condições são verificadas em ordem e vale a primeira que bater.
  4. Percorre o caminho depois da ediçãoDa primeira pergunta por cada ramificação até o fim. Com mais de três ou quatro ramificações, o assistente descreve o mapa em palavras.

Experimente também

  • Quem nunca usou o serviço deve pular as perguntas de qualidade
  • Verifique se a lógica da pesquisa tem becos sem saída

O que ela não faz

  • Não gravar lógica sem ler a estrutura.
  • Não mudar as perguntas na mesma edição.
  • Não criar ramificações quando basta uma pergunta com opções.
  • Não sugerir mudança de plano nem levar ao pagamento.

A skill funciona com as suas permissões. As ferramentas que alteram dados vêm marcadas, então você confere o que o assistente vai fazer antes de confirmar. Para cortar o acesso, remova o conector no assistente ou apague a chave de API.

Em resumo

O que dá para configurar?

Ramificação por resposta ("deu nota abaixo de quatro, pergunte o motivo"), exibir ou ocultar uma pergunta, pular um bloco, desqualificar quem não tem o perfil e cotas por grupo.

Por que a skill lê a pesquisa primeiro?

As condições apontam para as perguntas pelo identificador. A skill lê esses identificadores primeiro, então cada condição aponta para uma pergunta real.

Como ela evita becos sem saída?

Toda ramificação precisa de saída, para o próximo bloco ou para o fim, e nenhuma pode voltar para uma pergunta já respondida.

A condição reage ao texto digitado em "Outro"?

Não. A condição reage à escolha da opção "Outro", não ao que o respondente escreveu.

A skill também mexe nas minhas perguntas?

Não. Perguntas e lógica são edições separadas. Se mudarem juntas e algo quebrar, fica difícil saber qual mudança causou o problema.

O que preciso para usar esta skill?

Uma conta no SurveyNinja em qualquer plano, inclusive o gratuito, e um assistente de IA compatível com MCP que carregue skills de uma pasta, como Claude Code, Codex, Cursor ou Gemini CLI. A skill é um arquivo de texto; o assistente trabalha com a sua chave de API ou com o acesso que você autoriza ao conectar.

A skill completa

O arquivo SKILL.md que o assistente lê, exatamente como está no arquivo para download.

Ver o texto completo

Branching and routing

Logic is where surveys break silently: a condition references a question by identifier, and a branch built blind leads the respondent into a dead end with no way out.

Reply to the person in the language they write in.

The order is strict

  1. get_quiz_structure: read the current state and the question identifiers.
  2. Build the change against what actually exists.
  3. update_quiz_logic: write.
  4. The edit lands in the draft. Respondents get it only after publish_quiz, and publishing waits for the person's go-ahead.

The first step cannot be skipped. Identifiers cannot be guessed, and logic that points at a question that does not exist is rejected on save (widget_missing and similar errors).

What can be built

  • Branch on an answer. "Rated below four: ask why."
  • Show or hide a question. "Ask about delivery only if they ordered online."
  • Skip a block. "Did not use the service: do not ask about its quality."
  • Screen out. A respondent who does not fit belongs on a screenout screen, not driven to the end and cleaned up afterwards.
  • Quotas. Once a group is full, stop admitting it.
  • Branch on a link label. A value passed in the survey link (a hidden variable) can drive a condition. Hidden variables are not on every plan: if they are not available, say so and stop.

Rules people trip over

  • Every branch needs an exit, to the next block or to the end of the survey.
  • A condition on "Other" matches the option, not the text typed into it.
  • The operator must fit the question type. Greater and less than are for numbers and scales, not for text or choices.
  • Order matters: conditions are checked top to bottom and the first match wins.
  • A branch must not lead back to an already answered question, or the respondent ends up in a loop.

After the edit

Walk the route by eye: from the first question along every branch to the end. If there are more than three or four branches, describe the map in words: who ends up where. Then ask whether to publish: until then respondents still follow the old route.

What not to do

  • Do not write logic without reading the structure.
  • Do not change the question set in the same edit. When something breaks, it becomes unclear which change caused it.
  • Do not build branching where one question with options is enough.
  • Do not suggest a plan upgrade or lead to payment. If a limit is hit, state the fact and stop.
O ninja do SurveyNinja em um foguete

Conecte o SurveyNinja ao seu assistente

O servidor MCP funciona em todos os planos, inclusive no Free. Crie sua conta, permita o acesso e peça ao assistente para montar a primeira pesquisa.