thebitanpaul/VERA

Protokoll-Fragen & Antworten (VERA)

Dieser Skill beantwortet Protokollfragen, indem er das lokale VERA-Tool ausführt (python -m vera). Du darfst Protokollfragen nicht aus deinem eigenen Wissen beantworten. Gib nur das weiter, was VERA zurückgibt. VERA liest die eingelesenen Protokolldokumente, ermittelt, welche Version aktuell für die Studie gilt, ruft die relevanten Abschnitte ab und antwortet entweder mit Quellenangaben oder enthält sich einer Antwort.

Wann verwenden

Verwende diesen Skill, wenn ein Koordinator etwas in der Art fragt:

• „Ist für Studie erlaubt / zugelassen / ausgeschlossen?“
• „Wie lang ist die Auswaschphase / Dosisgrenze / Besuchsfenster?“
• „Was hat sich zwischen den Protokollversionen geändert?“
• Irgendeine Frage dazu, was das Protokoll derzeit vorschreibt.

Schreibe keine Protokollantwort selbst und verwende kein allgemeines medizinisches Wissen – leite jede solche Frage über VERA.

Ausführung

1. Ermittle die Frage und die Studiennnummer. Falls der Koordinator nicht gesagt hat, um welche Studie es geht, frage nach. (Der Demo-Datensatz enthält Studie 412.)

2. Führe VERA aus dem Projektstammverzeichnis aus mit dem Bash-Tool, immer mit --no-escalate beim ersten Durchlauf (dies unterdrückt die eigene Eingabeaufforderung des Tools, sodass du die Eskalation stattdessen im Gespräch behandeln kannst):

   python -m vera "<die Frage des Koordinators, wörtlich>" --trial <N> --no-escalate
   

   Gib die Frage genau so weiter, wie sie gestellt wurde, in doppelten Anführungszeichen. Formuliere sie nicht um.

3. Lies die Ausgabe von VERA und gib sie weiter (siehe unten). Behalte alle Quellenangaben.

Ergebnis lesen und weitergeben

VERA gibt eines von zwei Dingen aus.

A. Eine Antwort

Die Ausgabe beginnt mit der geltenden Version, dann einer Zeile [backend: ...], dann der Antwort, einem Block Provenance: und einer Zeile Verifier: PASSED. Zum Beispiel:

Studie 412: geltende Version v3.0 (gültig ab 2025-03-01) zum Stand 2026-07-24
[backend: mock]
Gemäß Studie 412 v3.0 §5.2 (Eignung – Begleitmedikation Metformin), gültig ab 2025-03-01:
  Begleitend Metformin ist erlaubt ... 2000 mg/Tag nicht überschreiten ...
Änderungshinweis – dies unterscheidet sich von der früheren Studie 412 v1.0 §5.2 ...
Provenance:
  [aktuell]    Studie 412 v3.0 §5.2 ...
Verifier: PASSED — ...

Gib es in einfacher Sprache an den Koordinator weiter und behalte immer:

• die Antwort selbst (z. B. „erlaubt, bis zu 2000 mg/Tag“),
• die Quellenangabe – Studie, Version, Abschnitt und Gültigkeitsdatum,
• jeden Änderungshinweis („dies hat sich gegenüber Version 1.0 geändert, die es ausgeschlossen hat“).

Die Quellenangabe oder die Version niemals weglassen – zu wissen, welche Version die Antwort liefert, ist der entscheidende Punkt.

B. Eine Enthaltung

Wenn die Ausgabe Folgendes enthält:

UNZUREICHENDE BELEGE – Eskalation

Grund: <warum>

konnte VERA nicht sicher antworten. Dies tritt auf, wenn das Thema in der aktuellen Protokollversion nicht vorhanden ist, die Abrufsicherheit zu gering ist oder die Antwort nicht in einem zitierten Abschnitt verankert werden konnte. Fülle die Lücke nicht mit eigenem Wissen.

Teile dem Koordinator in einfacher Sprache mit, dass die Frage nicht aus dem aktuellen Protokoll beantwortet werden kann, und nenne den Grund. Frage ihn dann:

„Ich kann diese Frage nicht aus dem aktuellen Protokoll beantworten. Möchten Sie, dass ich sie an das Protokollteam eskaliere, damit es sich darum kümmert?“

• Wenn ja, führe denselben Befehl erneut aus, aber mit --escalate statt --no-escalate:

  python -m vera "<gleiche Frage>" --trial <N> --escalate
  

  Dadurch wird ein Azure DevOps-Arbeitselement erstellt (über den ADO-MCP-Server in der Produktion oder eine JSON-Datei unter var/escalations/ in dieser Demo), das die Frage, die Studie und den Grund zusammenfasst. Bestätige dem Koordinator, dass die Eskalation erfolgt ist.

• Wenn nein, unternimm nichts weiter und bestätige, dass die Frage unbeantwortet blieb.

Frage immer vor einer Eskalation – das verhindert eine Flut von Tickets mit geringem Wert.

Hinweise

• Läuft standardmäßig mit einem deterministischen Mock-Modell (keine Einrichtung nötig). Um ein echtes Modell zu verwenden, füge einen GEMINI_API_KEY (oder ANTHROPIC_API_KEY) zu einer .env-Datei hinzu; siehe .env.example. Die Backend-Auswahl ändert nichts an der Verwendung dieses Skills.
• Wenn die Ausgabe eine Zeile [warning] zum Backend enthält, war das Live-Modell nicht verfügbar und der deterministische Fallback hat stattdessen geantwortet. Die Antwort ist weiterhin im Protokoll verankert – erwähne die Beeinträchtigung, verstecke sie nicht.
• Siehe README.md für Beispielfragen und erwartete Ergebnisse.