thebitanpaul/VERA

Perguntas e Respostas sobre o Protocolo (VERA)

Este skill responde perguntas sobre o protocolo executando a ferramenta local VERA (python -m vera). Você não deve responder perguntas sobre o protocolo com base no seu próprio conhecimento. Apenas repasse o que a VERA retorna. A VERA lê os documentos do protocolo ingeridos, resolve qual versão atualmente rege o ensaio, recupera as seções relevantes, e ou responde com citações ou se abstém.

Quando usar

Use este skill quando um coordenador perguntar algo como:

• "<Fármaco> é permitido / autorizado / excluído para o ensaio ?"
• "Qual é o período de washout / limite de dose / janela de visita?"
• "O que mudou entre as versões do protocolo?"
• Qualquer pergunta sobre o que o protocolo exige atualmente.

Não escreva manualmente uma resposta sobre o protocolo, e não use conhecimento médico geral — encaminhe cada pergunta desse tipo através da VERA.

Como executar

1. Obtenha a pergunta e o número do ensaio. Se o coordenador não disser qual ensaio, pergunte. (O conjunto de dados de demonstração contém o Ensaio 412.)

2. Execute a VERA a partir da raiz do projeto com a ferramenta Bash, sempre com --no-escalate na primeira passagem (isso suprime o prompt da própria ferramenta para que você possa lidar com o escalonamento na conversa):

   python -m vera "<a pergunta do coordenador, exatamente igual>" --trial <N> --no-escalate
   

   Passe a pergunta exatamente como foi feita, entre aspas duplas. Não a reformule.

3. Leia a saída da VERA e repasse-a (veja abaixo). Mantenha cada citação.

Como ler e repassar o resultado

A VERA imprime uma de duas coisas.

A. Uma resposta

A saída começa com a versão vigente, depois uma linha [backend: ...], depois a resposta, um bloco Provenance: e uma linha Verifier: PASSED. Por exemplo:

Trial 412: governing version v3.0 (effective 2025-03-01) as of 2026-07-24
[backend: mock]
Per Trial 412 v3.0 §5.2 (Eligibility - Concomitant Metformin), effective 2025-03-01:
  Concomitant metformin is permitted ... does not exceed 2000 mg/day ...
Change disclosure — this differs from the earlier Trial 412 v1.0 §5.2 ...
Provenance:
  [current]    Trial 412 v3.0 §5.2 ...
Verifier: PASSED — ...

Repasse-a para o coordenador em linguagem simples, e sempre mantenha:

• a resposta em si (ex.: "permitido, até 2000 mg/dia"),
• a citação — ensaio, versão, seção e data de vigência,
• qualquer divulgação de alteração ("isso mudou em relação à versão 1.0, que o excluía").

Nunca remova a citação ou a versão — saber qual versão a resposta vem é o objetivo principal.

B. Uma abstenção

Se a saída contiver:

INSUFFICIENT EVIDENCE — escalating

Reason: <motivo>

então a VERA não conseguiu responder com segurança. Isso acontece quando o tópico não está na versão atual do protocolo, a confiança na recuperação é muito baixa ou a resposta não pôde ser fundamentada em uma passagem citada. Não preencha a lacuna com seu próprio conhecimento.

Diga ao coordenador, em linguagem simples, que a pergunta não pode ser respondida a partir do protocolo atual e dê o motivo. Em seguida, pergunte a ele/ela:

"Não posso responder a isso com base no protocolo atual. Gostaria que eu escalonasse para a equipe do protocolo para que eles possam acompanhar?"

• Se sim, execute novamente o mesmo comando com --escalate em vez de --no-escalate:

  python -m vera "<mesma pergunta>" --trial <N> --escalate
  

  Isso registra um item de trabalho no Azure DevOps (via servidor MCP ADO em produção, ou um arquivo JSON em var/escalations/ nesta demonstração) resumindo a pergunta, o ensaio, e o motivo. Confirme ao coordenador que foi registrado.

• Se não, não faça mais nada e confirme que a pergunta ficou sem resposta.

Sempre pergunte antes de escalonar — isso evita uma enxurrada de tickets de baixo valor.

Notas

• Executa em um modelo mock determinístico por padrão (nenhuma configuração necessária). Para usar um modelo real, adicione GEMINI_API_KEY (ou ANTHROPIC_API_KEY) a um arquivo .env; veja .env.example. A seleção do backend não altera como você usa este skill.
• Se a saída contiver uma linha [warning] sobre o backend, o modelo ativo estava indisponível e o fallback determinístico respondeu. A resposta ainda é fundamentada no protocolo — mencione a degradação, não a esconda.
• Veja README.md para exemplos de perguntas e resultados esperados.