literature について
literatureは、文献検索、読解と統合、引用挿入、BibTeX生成を扱う研究ワークフロー向けスキルです。Zoteroを使った検索に加え、複数ソースの書誌情報の統合と重複排除にも対応します。
主な機能
- 01キーワード拡張と文献検索
- 02PDF論文の読解と比較
- 03文献レビュー段落の作成
- 04LaTeX引用の挿入
- 05BibTeXの生成と重複排除
活用シーン
- 01複数データベースの書誌情報を統合して重複排除
- 02関連研究向けに論文を要約
- 03LaTeXの文章に引用を追加
- 04参考文献リストをBibTeXに変換
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mercatorproj/ vibe-thesis-skills --skill literatureインストール後、Claude Code で/literatureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEREADME.mdreferences/abbreviation-rules.mdbibtex-types.mdcitation-examples.mdcitation-formats.mdconversion-examples.mdlanguage-polishing.mdmulti-source-retrieval.mdnon-zotero-bibliography.mdoutput-template.mdrewriting-workflow.mdscripts/dedupe_bibtex.pyzotero_export_bibtex.pyzotero_searcher.py詳細
文献スキル(検索+読解/レビュー+引用+BibTeX)
モードの選択
| モード | 適用シーン | 出力/アクション |
|---|---|---|
| 複数ソースの検索と書誌情報の統合(事前実施を推奨) | 複数のデータベースから RIS/Bib をエクスポートする場合、再現可能な検索方法の記録、統合と重複排除 | references/multi-source-retrieval.md を参照してください。必要に応じて scripts/dedupe_bibtex.py を使用できます |
| 検索 | 「文献を探す」「キーワードを拡張する」「Zotero で検索する」 | キーワードの拡張、検索結果リスト、必要に応じてスクリプト zotero_searcher/zotero_export_bibtex |
| 読解とレビュー | 「この PDF を読む」「文献を要約する」「レビューを書き直す」「関連研究の素材」 | 読解メモ、横断的な比較、レビューの段落、BibTeX(書き換えモード) |
| 引用の挿入 | 「この段落に引用を加える」「\cite{} を挿入する」「引用文を推敲する」 | 推敲後の LaTeX 段落。\cite{key} または \cite{key1,key2} を含みます |
| BibTeX の生成 | 「参考文献リストを BibTeX に変換する」「.bib を生成する」 | BibTeX エントリー。略称のルールは references を参照してください |
ユーザーの依頼内容に応じてモードを選択してください。複数のモードを連続して使用することもできます(例:複数ソースの統合と重複排除 → 検索/読解 → 引用の挿入 → BibTeX の生成)。PDF を読む際は pdf スキルと連携します。
システマティックレビュー(採用/除外基準、PRISMA プロセスの記録)には、systematic-review-lite スキルを使用してください。本書の執筆関連モードを補完するものです。
Zotero を使わない場合/Word のみのワークフローについては、references/non-zotero-bibliography.md を参照してください。
ディレクトリのプレースホルダーと環境変数については、リポジトリのルートにある README.md を参照してください(既定値は {{THESIS_DIR}}/references/zotero.bib です)。
複数ソースの検索と書誌情報の統合(「検索」モードと併用)
複数のデータベースから再現可能な方法で書誌情報のプールを構築する場合:
- 各データベースで、記録した検索式を使用して RIS または BibTeX をエクスポートします。
- 単一の
.bibに統合します(または、先に Zotero にインポートしてからエクスポートします)。 - DOI、または「正規化したタイトル+出版年」に基づいて重複を排除します(multi-source-retrieval.md を参照してください)。
- その後、以下の「検索/読解とレビュー」などのモードに進みます。
複数の .bib ファイルを統合し、コマンドラインで重複排除する必要がある場合は、scripts/dedupe_bibtex.py を使用できます。
一、検索モード
- キーワードの拡張:同義語、中国語と英語の対応、分野の専門用語、組み合わせ検索。
- 検索方法:言語能力を使った検索、またはスクリプト(Zotero のローカル API)。スクリプトは本スキルの
scripts/zotero_searcher.py、scripts/zotero_export_bibtex.pyを参照してください。API の既定値はhttp://localhost:23119/api/です。認証には環境変数ZOTERO_LOCAL_API_KEYを使用できます。 - 出力:構造化された検索結果(関連度:高/中/低)、拡張キーワードの一覧。BibTeX をエクスポートする場合は
{{THESIS_DIR}}/references/zotero.bibに書き込みます(既定値は論文章節/references/zotero.bibで、citekey に基づいて重複を排除します)。
検索の手順、キーワードの拡張、関連度による並べ替えなどの詳細については、元の literature-search の設計を参照してください。スクリプトの使い方は、下記の「スクリプト」節を参照してください。
二、読解とレビューモード
- 読解モード:単一または複数の PDF からメタデータ、主旨、方法、結論、本論文との関連性、示唆となる情報を抽出します。複数の場合は横断的に比較し、総合的な結論をまとめます。出力の構成は references/output-template.md を参考にしてください。
- 書き換えモード:レビューの草稿を標準的な学術レビューに仕上げます。引用を維持し、文献を補足し、構成を最適化して、BibTeX を出力します。技術的な要点については references/rewriting-workflow.md を参照してください。
- エンドツーエンドモード:読解の結果から、論文に挿入できるレビューの段落を作成し、挿入可能な位置と \cite{} の手掛かりを示します。
PDF 本文の抽出には pdf スキルを使用します。DOI、ジャーナル名、著者、結果を捏造しないでください。現在の論文との関連性は明示的に判断してください。
三、引用の挿入モード
- 引用の種類:直接引用、間接引用、複数文献の引用。ページ番号付きの \cite[p. 10]{key}、章番号付きの \cite[Chapter 3]{key}。
- 形式:
\cite{key}、\cite{key1, key2}。文頭や文末を推敲して自然につなぎ、学術的な規範に沿うようにします。 - Zotero による引用の自動補足:ユーザーが Zotero API を提供し、「段落に文献の根拠を加える」よう求めた場合は、スクリプトで検索→BibTeX をエクスポート→文末に \cite{} を挿入し、文章を推敲します。
詳しくは references/citation-formats.md、references/language-polishing.md、references/citation-examples.md を参照してください。
四、BibTeX の生成モード
- 入力:参考文献リスト(中国語/英語/混在)。PDF の読解に基づく場合、またはユーザーが全文や要約を提供した場合は、それらも要約の情報源として使用します。
- 略称のルール:英語の文献は、著者名の頭文字+出版年+中国語のキーワード。中国語の文献は、著者の姓の頭文字+出版年+中国語の略称。references/abbreviation-rules.md、references/bibtex-types.md を参照してください。
- 出力:
noteフィールド(中国語の略称/英語の原題)を含む完全な .bib エントリー。可能な限り要約を添えてください。各 BibTeX を生成する際は、(1) 文献に要約が付属している場合、またはユーザー/読解メモに要約が記載されている場合は、noteに「摘要: …」を追加します。(2) 既存の要約がなくても原文を読める場合(PDF 本文や抽出済みテキストなど)は、原文から 1~2 文の要約を作成し、noteに記載します。(3) 要約がなく、原文も読めない場合に限り、要約を記載しません。内容を捏造しないでください。種類:article、inproceedings、phdthesis、book、techreport など。
note と要約に関する取り決めについては、references/conversion-examples.md、references/bibtex-types.md を参照してください。
参考文档汇总
- references/multi-source-retrieval.md:多库导出、合并与去重
- references/non-zotero-bibliography.md:EndNote/Mendeley/Word 等与 LaTeX 混用
- references/output-template.md:阅读模式输出模板
- references/rewriting-workflow.md:综述改写流程与引用处理
- references/citation-formats.md:引用格式
- references/language-polishing.md:引用句润色
- references/citation-examples.md:插入示例
- references/bibtex-types.md:BibTeX 类型
- references/abbreviation-rules.md:简称规则
- references/conversion-examples.md:Bib 转换示例
脚本
scripts/zotero_searcher.py:Zotero 本地库检索(--query、--expand、--limit、--base-url、--api-key)。scripts/zotero_export_bibtex.py:按 item-key 导出 BibTeX 到指定 .bib(--bib-path、--item-key 可多次)。scripts/dedupe_bibtex.py:合并多个.bib并按 DOI / 标题+年份去重(无网络依赖,见脚本--help)。