Skip to content

cursorvers/auditscope

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏥 AuditScope - Medical AI Paper Digest

⚠️ 本ツールは情報提供のみを目的とし、診断・治療推奨を行うものではありません。臨床判断の代替にはなりません。

臨床医向けのPubMed論文自動要約システム。毎朝7時にAI関連医学論文の要約をメール配信します。

医療AIガバナンスの7軸(引用・幻覚防止・再現性・免責・撤回チェック・利益相反・監査ログ)を組み込んだ、信頼性の高い情報提供を実現します。

📋 デモ(メール構成例)

件名: Medical AI Digest - 2024/12/28 (9件)

🏥 Medical AI Daily Digest
2024年12月28日 | 9件の新着論文

📋 今日のTL;DR
• Deployment: Large Language Models in Clinical Decision Support...
• Use Cases: AI-Powered Triage Systems in Emergency Medicine...  
• Safety: Addressing Algorithmic Bias in Diagnostic AI...

🚀 Deployment
[論文カード1] タイトル + 要約 + ガバナンスバッジ + PubMedリンク

🔬 Use Cases  
[論文カード2-4] ...

🛡️ Safety & Ethics
[論文カード5-9] ...

免責事項: この要約は医療従事者への情報提供を目的とし...

用語ミニ解説 (非エンジニア向け)

  • fork: GitHub 上で自分用のコピーを作ること
  • Use this template: テンプレートから新しいリポジトリを作るボタン (リポジトリページ上部の緑ボタン)
  • Secrets: GitHub に暗号化保存できる環境変数。リポジトリの Settings → Secrets and variables → Actions で設定
  • Actions タブ: リポジトリページ上部にある、自動実行 (workflow) を管理する場所
  • workflow_dispatch: Actions タブから「Run workflow」ボタンで手動実行する仕組み
  • cron: 定期実行スケジュール (例: 0 22 * * * = 毎日 UTC 22:00 = JST 07:00)
  • config.yaml: 設定ファイル。GitHub の Web 上でファイル名をクリック → 鉛筆マークで編集可能
  • PMID: PubMed Unique Identifier。PubMed上の論文を一意に識別する番号
  • MeSH: Medical Subject Headings。医学論文の分類に使われる統制語彙体系
  • E-utilities: PubMedのAPIサービス。プログラムから論文情報を取得可能
  • retraction: 論文撤回。発表後に誤りや不正が判明して取り下げられた論文

⚡ Setup - 10分で動かす

1. このテンプレートを使用

GitHub で「Use this template」→ 新しいリポジトリを作成

2. Actions を有効化

Fork したリポジトリで Actions タブ → 「I understand my workflows, go ahead and enable them」をクリック

3. Google AI Studio API キー取得

  1. Google AI Studio にアクセス
  2. 「Get API key」→ 新しいプロジェクトでキー作成
  3. キーをコピー(後でSecretsに設定)

4. Gmail アプリパスワード生成

  1. Googleアカウント設定のセキュリティページ → 2段階認証 有効化
  2. App Password 生成ページ → 「その他」を選択
  3. 生成されたパスワードをコピー

5. GitHub Secrets 設定

リポジトリ設定 → Secrets and variables → Actions → New repository secret

GEMINI_API_KEY: (Step 3のAPIキー)
GMAIL_ADDRESS: your.email@gmail.com  
GMAIL_APP_PASSWORD: (Step 4のアプリパスワード)

6. config.yaml 編集

cp config.example.yaml config.yaml (または GitHub Web UI 上で config.example.yaml を開いて config.yaml という名前でコピー)

配信先メールアドレスを変更:

delivery:
  recipient: "your.email@example.com"  # ここを変更

7. テスト実行

Actions タブ → 「Daily Medical Paper Digest」→ 「Run workflow」

🎯 カスタマイズ

PubMed 検索クエリ変更

config.yamlquery_clusters を編集:

pubmed:
  query_clusters:
    deployment: '("clinical decision support"[MeSH] OR "AI implementation")'
    # 専門領域に応じてクエリを調整

ガバナンス軸の ON/OFF

不要な機能を無効化:

governance:
  per_sentence_citation: false  # 引用を無効化
  retraction_filter: false     # 撤回チェックを無効化

ガバナンス7軸 設定対応表

config.yaml key 日本語名 内容
per_sentence_citation 文単位引用 各文末に [PMID:xxx, §section]
hallucination_selfcheck ハルシネーション自己点検 不明点は "本文未記載" 明示
reproducibility_block 再現性ブロック dataset/n/primary endpoint 抽出
disclaimer 免責文 末尾固定文
retraction_filter 撤回論文フィルタ Retraction Watch 突合
coi_label COI ラベル funding/COI 原文転記
audit_hash 監査ハッシュ prompt_sha256, model_version, retrieved_at

配信時刻変更

.github/workflows/daily-digest.yml の cron を編集:

schedule:
  - cron: "0 22 * * *"  # UTC 22:00 = JST 07:00

📊 監査ログ

logs/audit/YYYY-MM-DD.json にSHA256ハッシュチェーンで処理履歴を記録:

{
  "date": "2024-12-28",
  "prev_hash": "a1b2c3...",
  "entries": [...],
  "current_hash": "d4e5f6..."
}

チェーン整合性により、処理内容の改ざん検知が可能です。

🔧 トラブルシューティング

Gmail が届かない

  • Gmail アプリパスワードが正しいか確認
  • スパムフォルダを確認
  • 2段階認証が有効になっているか確認
  • 差出人 (GMAIL_ADDRESS) と宛先 (config.yaml の recipient) が同一だと迷惑メール判定されることがある

API クォータエラー

  • Gemini API の利用制限を確認
  • config.yamlmax_per_cluster を削減

Retraction CSV 404エラー

governance:
  retraction_filter: false  # 一時的に無効化

ワークフローが失敗する

  • Actions タブのログを確認
  • 自動的に Issue が作成されます

⚖️ 免責・ライセンス

MIT ライセンス

Copyright 2026 cursorvers

医療免責

  • 本システムは医師法上の医療行為を構成しません
  • 診断・治療の推奨を行うものではありません
  • 臨床判断は必ず原著論文・ガイドラインを参照してください
  • システムの出力内容について一切の責任を負いません

🏗️ Governance 設計の背景

医療AI導入における信頼性・透明性・説明責任を担保するため、以下7軸のガバナンスフレームワークを採用:

  1. 文章単位引用: 情報の出典明確化
  2. 幻覚防止: AI の推測・補完を排除
  3. 再現性担保: 研究の検証可能性確保
  4. 免責の明文化: 責任範囲の明確化
  5. 撤回論文への対応: 科学的信頼性の維持
  6. 利益相反の開示: 透明性の確保
  7. 監査証跡: 処理履歴の検証可能性

詳細な設計思想: https://cursorvers.jp/tools/auditscope/


🚀 今すぐ始める: 「Use this template」→ Secrets 設定 → config.yaml 編集 → Run workflow

About

Daily medical AI paper digest (PubMed→Gemini→Gmail) with 7-axis governance overlay. Free OSS template for clinicians.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages