literature-report について
literature-report は、引用付きの文献レビューやレポートを Markdown で作成・更新するスキルです。論文の検索、BibTeX の管理、引用の記述、正しく表示されるかの確認を案内します。
主な機能
- 01Markdown レポートの作成と更新
- 02既存の検索結果の確認と活用
- 03BibTeX エントリの一貫した追加
- 04指定形式での引用挿入
- 05引用のプレビューと検証
活用シーン
- 01引用付き文献レビューの執筆
- 02既存レポートへの論文の追加
- 03引用キーと参考文献の照合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ allenai/ asta-plugins --skill literature-reportインストール後、Claude Code で/literature-reportを入力して読み込まれたか確認します。
詳細
文献レポート
引用を含む文献レビュー/レポートを、Markdown ドキュメントとして作成または更新します。
論文を探す
- 新たに検索する前に、
.asta/documents/literature/find/に既存の検索結果がないか確認します。 - 包括的な検索と、結果のスキーマおよび jq のアクセスパターンについては、Find Literature スキルを使用します。
- 特定の論文、引用、著者を対象に検索する場合は、Semantic Scholar Lookup スキルを使用します。
ワークフローのガイダンス
- 最初にレポートファイルを特定するか、作成します。更新できる既存のレポートがないか確認します。新しいレポートは、
.asta/内ではなく、ユーザーから見える場所(例:docs/)に保存します。 - 既存のレポートを更新する場合は、まず現在の構成と内容を把握するために読みます。
- Find Literature の結果を使用する場合は、関連性の高い論文をすべて確認し、それぞれから関連性の基準、抜粋、引用の文脈を抽出します。
引用の規約
YAML フロントマター — 引用の解決に必須です:
---
bibliography: ../references.bib
---
引用:[@key] 形式を使用します。すべてのキーが .bib ファイルに存在する必要があります。解決できないキーは表示されません。
.bib への論文の追加:論文を引用する際、そのメタデータを取得し、BibTeX エントリを追加します:
asta papers get CorpusId:<id> --fields title,authors,year,venue,externalIds,journal,publicationDate
結果から BibTeX エントリを生成します。規約:
- キー:
{firstAuthorSurname}{year}。小文字の ASCII のみを使用します(例:wei2022)。キーが重複する場合は、末尾に文字を追加します(例:wei2022a)。 corpus_id:安定した識別のためにcorpus_id = {<id>}を含めます(キー名を変更しても保持されます)。.bibに追記します。既存のエントリを書き換えてはいけません。
確認:すべての引用が解決されることをレンダリングして確認するため、Preview スキルを使用します。
コメント
Markdown 対応