mcpField
S
snapshot-writer

snapshot-writer

github.com/willoscar生産性51743 回インストール4 週間前に更新
リポジトリ

snapshot-writer について

snapshot-writerは、少数のコア論文と箇条書きのアウトラインから、簡潔な文献ブリーフを作成する研究スキルです。完全なサーベイではなく、research-briefワークフローでの速読用資料を作ります。

主な機能

  1. 01簡潔な箇条書きブリーフの作成
  2. 02トピック範囲の明示
  3. 03論文への参照付きで主要テーマを提示
  4. 04抄録から方法と結果の文を限定して選択
  5. 05output/SNAPSHOT.mdへの書き込み

活用シーン

  1. 01research-briefワークフローで文献スナップショットを作成
  2. 02優先して読む論文を読者に提示
  3. 03追跡可能なコア論文参照でテーマを要約

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill snapshot-writer

インストール後、Claude Code で/snapshot-writerを入力して読み込まれたか確認します。

同梱ファイルscripts/run.py

詳細

Snapshot Writer

トリガーとルーティング

  • トリガー: snapshot、literature snapshot、速览、48h snapshot、one-page snapshot、SNAPSHOT.md。
  • 使用する場面: research-brief のワークフローで、完全なサーベイではなく、24～48 時間以内に「読みやすい研究の速覧」（箇条書きが中心で、重要な引用を含む）を納品する場合です。

少数のコアセットと箇条書きのみのアウトラインから、最終的な research-brief 成果物を作成します。

入力

必須：

  • outline/outline.yml
  • papers/core_set.csv

任意：

  • GOAL.md
  • DECISIONS.md
  • queries.md
  • papers/papers_dedup.jsonl

出力

  • output/SNAPSHOT.md

スクリプトの役割分担

scripts/run.py は、共有レビュー用ツール群に対する薄いアダプターにとどめます。

  • アウトラインとコアセットの入力を読み込みます
  • サーベイ用のひな形の箇条書きをコピーするのではなく、具体的な目標と利用可能なアブストラクトを使います
  • アブストラクトから範囲を限定した手法・結果の文を選び、複数のセクションにアブストラクト全体を重複して記載しないようにします
  • 参照先を多く含むコンパクトなブリーフィングを作成します
  • output/SNAPSHOT.md に書き込みます

トピック固有のランキング規則や複雑な解析ロジックを、このスクリプトに移さないでください。

要件

出力は次の条件を満たす必要があります。

  • サーベイの草稿ではなく、ブリーフィングとして読めること
  • 箇条書きを中心に、簡潔であること
  • トピックの範囲を定義すること
  • 重要なテーマを示すこと
  • 安定した形式で論文への明示的な参照を含めること

受け入れ条件

  • output/SNAPSHOT.md が存在する
  • ## Scope、## Key themes、## What to read first、## Open problems / risks が含まれている
  • papers/core_set.csv の項目に対応する論文への明示的な参照が少なくとも 3 件含まれている
  • Scope が少なくとも 1 件のコアセット論文に基づいており、Key themes の各箇条書きが根拠を示し、それらのセクション全体でコアセット内の異なる論文を少なくとも 2 件取り上げている
  • Workflow 評価ツールの簡潔さの基準である 100～1200 語に収まっている
  • 引用数のノルマ、章立て、「このサーベイを行う理由」の説明など、サーベイ専用のひな形要素を含まない

対象外

  • エビデンスの包括的な統合
  • プロトコル／スクリーニング／抽出
  • 長大で一体化したサーベイの執筆

コメント

Markdown 対応