paper-to-code について
paper-to-codeは、研究論文を完全に実行可能なコードリポジトリに変換する研究スキルです。計画、論文分析、依存順の実装、デバッグを段階的に進め、設定値は論文に明記された内容に限定します。
主な機能
- 01手法と実験の詳細を抽出
- 02構成とファイル依存関係を設計
- 03依存順にコードを生成
- 04設定をconfig.yamlに記録
- 05最小限の修正でデバッグ
活用シーン
- 01論文の手法をコードで再現
- 02論文の情報からリポジトリを設計
- 03学習・評価モジュールを実装
- 04再現中に発生したエラーを解決
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lingzhi227/ agent-research-skills --skill paper-to-codeインストール後、Claude Code で/paper-to-codeを入力して読み込まれたか確認します。
同梱ファイルreferences/paper-to-code-prompts.md
詳細
論文からコードへ
研究論文を、実行可能な完全なコードリポジトリに変換します。
入力
$0— 論文のPDFパス、論文本文、または論文のURL
参考資料
- Paper2Code のプロンプト(計画、分析、コーディングの各段階):
~/.claude/skills/paper-to-code/references/paper-to-code-prompts.md
ワークフロー(Paper2Code に基づく)
Stage 1:計画
包括的な計画を作成するための4ターンの会話です。
- 全体計画:手法、実験、データセット、ハイパーパラメーター、評価指標を抽出します
- アーキテクチャ設計:ファイル一覧、Mermaid の classDiagram、sequenceDiagram を生成します
- タスクの分解:ファイルごとのロジック分析、依存関係順のタスクリスト、必要なパッケージを作成します
- 設定:トレーニングの詳細を抽出して
config.yamlにまとめます
Stage 2:分析
タスクリストにある各ファイルについて、依存関係順に次の手順を実行します。
- 詳細なロジック分析を行います
- 論文の手法をコード構造に対応付けます
- すべての設定で config.yaml を参照します
- UML クラス図のインターフェースに厳密に従います
Stage 3:コーディング
各ファイルについて、依存関係順に次の手順を実行します。
- これまでに生成したすべてのファイルを参照できる状態でコードを生成します
- 設計で定められたデータ構造とインターフェースに厳密に従います
- config.yaml を参照し、設定値を決して捏造しません
- TODO やプレースホルダーを残さず、完全なコードを記述します
Stage 4:デバッグ(必要な場合)
実行に失敗した場合:
- エラーメッセージを収集します
- SEARCH/REPLACE diff 形式を使って根本原因を特定します
- 元の意図を保ちながら、最小限の修正を適用します
- 成功するまで再実行します
出力構成
reproduced_code/
├── config.yaml # Training configuration
├── main.py # Entry point
├── model.py # Model architecture
├── dataset_loader.py # Data loading
├── trainer.py # Training loop
├── evaluation.py # Metrics and evaluation
├── reproduce.sh # Run script
└── requirements.txt # Dependencies
主な制約
- 依存関係順:各ファイルは、これまでに生成したすべてのファイルを参照できる状態で生成します
- インターフェースの契約:Mermaid 図は、すべての段階で厳守するインターフェース定義として機能します
- 捏造禁止:論文に明記された設定のみを使用します
- 完全なコード:すべての関数を完全に実装します
ルール
- 論文の手法に厳密に従い、独自の改善を加えないでください
- 依存関係順(データ読み込み → モデル → トレーニング → 評価 → メイン)にコードを生成します
- すべてのハイパーパラメーターと設定に config.yaml を使用します
- UML 図にあるすべてのクラス/メソッドをコードに含めます
- 1つのコマンドで実行できる reproduce.sh スクリプトを生成します
- 論文の詳細が曖昧な場合は、その旨を明記します
関連スキル
- 上流:literature-search
- 下流:experiment-code
- 関連:code-debugging、[algorithm-design](../algorithm-design/]
コメント
Markdown 対応