elbitanpaul/VERA

Preguntas y Respuestas sobre Protocolos (VERA)

Este skill responde preguntas sobre protocolos ejecutando la herramienta local VERA (python -m vera). No debes responder preguntas sobre protocolos basándote en tu propio conocimiento. Solo transmite lo que VERA devuelve. VERA lee los documentos del protocolo ingeridos, resuelve qué versión rige actualmente el ensayo, recupera las secciones relevantes y responde con citas o se abstiene.

Cuándo usarlo

Usa este skill cuando un coordinador pregunte algo como:

• "¿Está <fármaco> permitido / autorizado / excluido para el ensayo ?"
• "¿Cuál es el período de lavado / límite de dosis / ventana de visita?"
• "¿Qué cambió entre versiones del protocolo?"
• Cualquier pregunta sobre lo que el protocolo requiere actualmente.

No redactes una respuesta sobre el protocolo por tu cuenta ni uses conocimiento médico general: canaliza cada pregunta de este tipo a través de VERA.

Cómo ejecutarlo

1. Obtén la pregunta y el número del ensayo. Si el coordinador no indicó qué ensayo, pregúntalo. (El conjunto de datos de demostración contiene el Ensayo 412.)

2. Ejecuta VERA desde la raíz del proyecto con la herramienta Bash, siempre con --no-escalate en el primer intento (esto suprime la solicitud propia de la herramienta para que puedas gestionar la escalada en la conversación):

   python -m vera "<la pregunta del coordinador, textual>" --trial <N> --no-escalate
   

   Pasa la pregunta exactamente como fue formulada, entre comillas dobles. No la reformules.

3. Lee la salida de VERA y transmítela (ver más abajo). Conserva cada cita.

Cómo leer y transmitir el resultado

VERA imprime una de dos cosas.

A. Una respuesta

La salida comienza con la versión vigente, luego una línea [backend: ...], luego la respuesta, un bloque Provenance: y una línea Verifier: PASSED. Por ejemplo:

Ensayo 412: versión vigente v3.0 (efectiva 2025-03-01) al 2026-07-24
[backend: mock]
Según el Ensayo 412 v3.0 §5.2 (Elegibilidad - Metformina concomitante), efectiva 2025-03-01:
  Se permite metformina concomitante ... no exceder 2000 mg/día ...
Divulgación de cambio: esto difiere de la versión anterior Ensayo 412 v1.0 §5.2 ...
Provenance:
  [actual]    Ensayo 412 v3.0 §5.2 ...
Verifier: PASSED — ...

Transmítelo al coordinador en lenguaje sencillo, y conserva siempre:

• la respuesta en sí (ej. "permitido, hasta 2000 mg/día"),
• la cita — ensayo, versión, sección y fecha de vigencia,
• cualquier divulgación de cambio ("esto cambió desde la versión 1.0, que lo excluía").

Nunca omitas la cita ni la versión — saber qué versión proviene la respuesta es el objetivo principal.

B. Una abstención

Si la salida contiene:

EVIDENCIA INSUFICIENTE — escalando

Motivo: <razón>

entonces VERA no pudo responder de manera segura. Esto ocurre cuando el tema no está en la versión actual del protocolo, la confianza de recuperación es demasiado baja, o la respuesta no pudo basarse en un pasaje citado. No llenes el vacío con tu propio conocimiento.

Dile al coordinador, en lenguaje sencillo, que la pregunta no puede responderse desde el protocolo actual y da la razón. Luego pregúntale:

"No puedo responder esto desde el protocolo actual. ¿Te gustaría que lo escale al equipo del protocolo para que lo resuelvan?"

• Si sí, vuelve a ejecutar el mismo comando con --escalate en lugar de --no-escalate:

  python -m vera "<la misma pregunta>" --trial <N> --escalate
  

  Esto archiva un elemento de trabajo en Azure DevOps (a través del servidor MCP de ADO en producción, o un archivo JSON en var/escalations/ en esta demostración) que resume la pregunta, el ensayo y la razón. Confirma al coordinador que se elevó.

• Si no, no hagas nada más y confirma que la pregunta quedó sin responder.

Pregunta siempre antes de escalar — esto evita una avalancha de tickets de poco valor.

Notas

• Se ejecuta en un modelo mock determinista por defecto (sin configuración necesaria). Para usar un modelo real, agrega una GEMINI_API_KEY (o ANTHROPIC_API_KEY) en un archivo .env; consulta .env.example. La selección del backend no cambia cómo usas este skill.
• Si la salida contiene una línea [warning] sobre el backend, el modelo real no estuvo disponible y el fallback determinista respondió en su lugar. La respuesta sigue estando fundamentada en el protocolo — menciona la degradación, no la ocultes.
• Consulta README.md para preguntas de ejemplo y resultados esperados.