Community寫作與編輯github.com

thebitanpaul/VERA

版本明確檢索與回答 - VERA 能回答試驗協調員關於臨床試驗方案當前要求的問題,僅使用當前適用的方案版本,並在方案未涵蓋問題時選擇不回答而非猜測。

VERA 是什麼?

VERA(版本明確檢索與回答)是一個專門用於回答臨床試驗方案問題的 AI 技能。其主要用途是讓試驗協調員能夠查詢某個試驗目前適用的方案版本所規定的具體內容,例如藥物是否允許使用、清洗期長度或劑量限制等。VERA 會讀取已匯入的方案文件,解析哪個版本目前管轄該試驗,然後只根據該版本的內容進行回答,並附上引用出處。此技能對於需要嚴格遵循最新方案版本的臨床試驗管理非常有用,能避免因使用過時資訊而導致的錯誤。 VERA 支援在 Claude Code、Cursor 或其他具備 Bash 工具和 Python 環境的 AI 編碼代理平台上執行。使用方式很簡單:代理收到協調員的問題後,呼叫本機的 `python -m vera` 命令,傳入問題和試驗編號。VERA 會輸出答案或表示無法回答(「證據不足」)。若是答案,代理必須原樣轉達引用和版本資訊;若是無法回答,代理必須先詢問使用者是否要升級為工作項目(例如 Azure DevOps 工單),而不能自行填補答案。這種設計確保了嚴格的答案真實性和流程控管,避免 AI 產生幻覺。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add thebitanpaul/VERA

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

方案問答(VERA)

此技能透過執行本機的 VERA 工具(python -m vera)來回答方案問題。您不得根據自身知識回答方案問題。 僅轉達 VERA 回傳的內容。VERA 會讀取已匯入的方案文件,解析目前哪個版本管轄該試驗,擷取相關章節,然後回答(附引用)或不回答。

何時使用

當協調員問到類似下列問題時使用此技能:

  • 「試驗 是否允許 / 排除使用 <藥物>?」
  • 「清洗期 / 劑量限制 / 訪視窗口是多少?」
  • 「方案版本之間有什麼變更?」
  • 任何關於方案目前要求的問題。

請不要自行撰寫方案答案,也不要使用一般的醫學知識——將每個此類問題都透過 VERA 處理。

如何執行

  1. 取得問題和試驗編號。 如果協調員沒有指定是哪個試驗,請詢問。(示範資料集包含試驗 412。)

  2. 從專案根目錄使用 Bash 工具執行 VERA,第一次執行時務必加上 --no-escalate(這會抑制工具自身的提示,讓您可以在對話中處理升級流程):

    python -m vera "<協調員的問題,原封不動>" --trial <N> --no-escalate
    

    將問題照原樣傳入,使用雙引號。不要重新措辭。

  3. 讀取 VERA 的輸出並轉達(見下方)。保留所有引用。

如何讀取和轉達結果

VERA 會輸出兩種結果之一。

A. 答案

輸出以管轄版本開頭,接著是 [backend: ...] 行,然後是答案、Provenance: 區塊,以及 Verifier: PASSED 行。例如:

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 — ...

用白話轉達給協調員,並且務必保留:

  • 答案本身(例如「允許,每天最多 2000 毫克」),
  • 引用出處——試驗、版本、章節和生效日期,
  • 任何變更揭露(「此項從版本 1.0 變更而來,該版本禁止使用」)。

絕不能遺漏引用或版本——知道答案來自哪個版本是此技能的核心價值。

B. 放棄回答

如果輸出包含:

INSUFFICIENT EVIDENCE — escalating

Reason: <原因>

則表示 VERA 無法安全地回答。這發生在目前方案版本未涵蓋該主題、檢索信心太低,或答案無法基於引用段落時。請勿用自己的知識填補空白。

用白話告訴協調員,無法根據目前方案回答問題,並說明原因。然後詢問他們:

「我無法根據目前方案回答這個問題。您是否希望我將它升級給方案團隊,以便他們後續處理?」

  • 如果回答是,用 --escalate 取代 --no-escalate 重新執行相同指令:

    python -m vera "<相同問題>" --trial <N> --escalate
    

    這會建立一個 Azure DevOps 工作項目(正式環境透過 ADO MCP server,示範環境則在 var/escalations/ 下建立 JSON 檔案),摘要說明問題、試驗和原因。向協調員確認已建立。

  • 如果回答否,不做進一步動作,並確認該問題未被回答。

在升級前務必先詢問——這可以避免產生大量低價值工單。

備註

  • 預設使用確定性模擬模型執行(無需設定)。若要使用真實模型,請在 .env 檔案中加入 GEMINI_API_KEY(或 ANTHROPIC_API_KEY);請參閱 .env.example。後端選擇不會改變您使用此技能的方式。
  • 如果輸出包含 [warning] 行關於後端的訊息,表示真實模型不可用,改用確定性備援模式回答。答案仍基於方案——請提及此降級情況,不要隱瞞。
  • 請參閱 README.md 了解範例問題和預期結果。

相關技能