cec-sheet

name

cec-sheet

description

Build a Claim–Evidence–Citation (CEC) sheet — an HTML table that maps each claim in a paper/abstract/review to the supporting articles' key findings and citations. Use when the user asks for a "CECシート", "Claim-Evidence-Citation", "主張と文献の対応表", "根拠表", wants to organize/verify the literature behind a manuscript's Introduction/Discussion, or when codex-refs is unavailable/unstable and a hallucination-safe way to assemble references is needed. Bibliographic data (authors, journal, volume/issue/pages, year, DOI, abstract) is fetched live from the PubMed E-utilities API so it is never fabricated; the human supplies only the claim grouping, evidence summaries, and support level.

CEC Sheet Builder

これは何か

論文・抄録・総説の各 主張(Claim) に対し、それを支える各論文の 核心的所見(Evidence) と 出典(Citation) を対応づけた HTML 表（CEC シート）を生成するスキル。

ハルシネーション防止が核心：書誌情報（著者・誌名・巻号頁・年・DOI・abstract）は PubMed E-utilities (efetch) から実取得してそのまま埋め込む。人が用意するのは「テーマ分類・Claim 文・Evidence 要約・支持度」だけ。各行に abstract 原文の折りたたみが付き、要約の根拠をその場で検証できる。

いつ使うか：

• Introduction / Discussion の論拠を整理・検証したいとき
• codex-refs がレート制限等で止まり、別手段で出典付きの文献整理が必要なとき
• 査読対応や共著者共有用に「主張↔文献」の一覧が欲しいとき

成果物

• make_cec_sheet.py … 生成スクリプト（このスキルの同梱版をプロジェクトにコピーして使う）
• CEC_<topic>.html … 生成される対応表（ブラウザで閲覧。PMID/DOI リンク・abstract 折りたたみ・支持度バッジ付き）

手順

1. スクリプトをプロジェクトにコピー このスキルの make_cec_sheet.py を論文フォルダ（例 Manuscript/）にコピーする。

2. 文献を集めて PMID と abstract を確認する（捏造しないため必ず実取得）

   • 第一選択：PubMed MCP ツール（search_articles で探し、get_article_metadata で内容確認）。
   • 代替：Python から E-utilities を直接叩く（esearch で検索 →efetch で abstract）。MCP が無い headless 環境でも動く。
   • abstract を必ず読んでから Evidence 要約を書く。記憶だけで書かない。

3. スクリプト冒頭の設定と THEMES を編集する

   • TITLE / TOPIC / OUTPUT_FILENAME を論文に合わせる。
   • THEMES は「論文の論理の流れ」に沿ってテーマを並べる（mediation 研究なら 曝露→アウトカム / 曝露→媒介(path a) / 媒介→アウトカム(path b) / 媒介の定義・独立性・予後 / サブグループ根拠 / 最近接研究 / 測定尺度 … のように）。
   • 各文献は {"pmid": "...", "support": "direct|partial|concept", "evidence": "abstractに基づく1–3文の要約"}。
   • support：direct（主要結果が主張を直接裏づける）/ partial（関連するが一部・別集団など）/ concept（定義・背景・概念）。

4. 実行（書誌は API が自動で埋める）

   python make_cec_sheet.py
   

   ログで全 PMID が [OK] になることを確認。[MISS] があれば PMID を見直す（取得できなかったものは捏造せず警告表示される）。

5. HTML を確認：! start "" "<出力HTMLのフルパス>" で開く。

設計上の約束（重要）

• 書誌は絶対に手入力しない。必ず efetch 由来。PMID が取れない文献（プレプリント・書籍等）は CEC に無理に載せず、別途手動管理する。
• Evidence は要約、判定は補助。HTML フッターと各行 abstract でその旨を明示してある（査読者・共著者が原文照合できる状態を保つ）。
• E-utilities はネットワークが要る。オフライン/headless で MCP も無い場合は PMID と abstract を事前に用意しておく。
• 出力 HTML・スクリプトに機密は含まれないが、生成物をリポジトリに置く場合は CLAUDE.md の方針に従う。

流用メモ

このスキルは JASTIS/JACSIS 系の縦断・mediation 論文で実証済み（神経発達症×NRS×労働機能、文献16本）。THEMES を入れ替えるだけで任意の論文に転用できる。fetch_pubmed() / citation() / build_html() は触らずに、設定と THEMES だけ編集するのが基本運用。