Asta Literature Reports について
Asta Literature Reportsは、引用付きの文献レビューをMarkdown文書として作成・更新するスキルです。論文検索、レポートの保存先、BibTeX項目の追加、引用検証の手順を案内します。
主な機能
- 01Markdownレポートの作成・更新
- 02既存の検索結果を先に確認
- 03BibTeXキーに結び付いた引用
- 04文献データベースへの論文情報追加
- 05Previewによる引用検証
活用シーン
- 01プロジェクト内の見える場所にレビューを作成
- 02既存の構成を保ってレポートを更新
- 03文献検索で見つけた論文を引用
- 04レポートの引用が解決されるか確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ allenai/ asta-plugins --skill asta-literature-reportsインストール後、Claude Code で/asta-literature-reportsを入力して読み込まれたか確認します。
詳細
文献レポート
引用を含む文献レビュー/レポートを Markdown ドキュメントとして作成または更新します。
論文を探す
- 新しい検索を実行する前に、
.asta/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 対応