論文の実装

研究論文をインタラクティブな marimo ノートブックに変換します。一般的な marimo ノートブックの規則（セル構造、PEP 723 メタデータ、出力レンダリング、marimo check、変数命名など）については、marimo-notebook スキルを参照してください。

ステップ 1: ユーザーが何を望んでいるかを理解する

何か取得したり読んだりする前に、短い会話で作業範囲を決めます。ユーザーに以下を尋ねます：

• 論文のどの部分に最も興味がありますか？ 論文には複数の貢献がある場合があります。ユーザーは通常 1 つか 2 つに関心があるでしょう。全体を実装する必要はありません。
• 目標は何ですか？ 手法を理解しようとしているのか、結果を再現しようとしているのか、自分自身のデータに適応させようとしているのか、他の人に教えようとしているのか？ これはノートブックのトーンと深さを左右します。
• 特定のデータセットを使いたいですか？ 関連性がある場合は尋ねます。そうでなければデータをシミュレートすることをお勧めします。
• これは PyTorch が必要ですか？ 必要な論文もあれば、そうでない論文も多くあります。不明な場合は尋ねてください。重い依存関係です。
• 背景は何ですか？ 論文は知識の隙間を埋めることを目的としています。ユーザーが既に知っていることを測定し、ノートブックが彼らのレベルで提供できるようにします。知られていることは省略し、知られていない前提条件を説明します。

何を構築するかについて明確な見通しが得られるまで、先に進まないでください。

ステップ 2: 論文を取得する

ユーザーが Arxiv/AlphaXiv リンクを提供する場合、論文を読むための効率的な方法があります。

alphaxiv.org を経由して論文コンテンツを取得する方法については、references/fetching-papers.md を参照してください。これにより、生の PDF を読まずに構造化された markdown が得られます。

ステップ 3: ノートブックを計画する

論文を読んだ後、コードを書く前に、ユーザーのためにノートブック構造をアウトラインします。

ノートブックをできるだけ小さく保ちます。 アイデアが 1 つのインタラクティブなウィジェットで最もよく伝わることもあります。カスタムウィジェットが必要な場合は、anywidget スキルの使用を検討してください。他の場合は、完全なトレーニングループが必要になります。その場合は、重い計算のために marimo-batch スキルの使用を検討してください。目標は、アイデアを伝えるのに必要な最小限のコード量です。

典型的な流れ：

セクション	目的	典型的な要素
タイトルとコンテキスト	読者を案内する	mo.md() 論文のタイトル、著者、リンク
背景	前提条件をセットアップする	Markdown + 方程式
手法	コアアルゴリズムをステップバイステップで	コードと markdown をインターリーブ
実験	主要な結果を再現する	インタラクティブウィジェット + プロット
結論	学んだことをまとめる	mo.md()

すべてのノートブックがすべてのセクションを必要とするわけではありません。ユーザーとアウトラインを共有し、コードを書く前に調整します。

ステップ 4: ノートブックを構築する

marimo-notebook スキールールに従って marimo ノートブックを作成します。

主なガイドライン：

• データセットを前提としないでください。 ステップ 1 でユーザーが指定したものを使用してください。指定していない場合は、データをシミュレートします。
• 自己完結型にします。 読者は完全な論文を読まずにノートブックを理解できるべきです。
• 方程式には KaTeX を使用します。 mo.md(r"""$...$""") で重要な方程式をレンダリングし、ノートブックが論文の記法を反映するようにします。論文と一貫した記法を保ちます。
• 理解を助ける場所でインタラクティビティを追加します。 ハイパーパラメータ用のスライダー、データセット変種用のドロップダウン、またはアブレーション用のトグルは、読者が直感を構築するのに役立ちます。
• 説明するのではなく、見せます。 段落の説明よりもプロットまたはテーブルを優先します。
• 変数に論文の記法と一致する名前を付けます（例：alpha、X、W）。実際には、方程式番号にマップするコメントを追加します。

ヒント

• 論文全体を再現しないでください。 ステップ 1 でユーザーが尋ねたことに焦点を当てます。
• 視覚的に反復します。 図をインクリメンタルに構築し（例：データを表示 → モデルフィットを表示 → 残差を表示）、すべてを 1 つのプロットにダンプするのではなく。
• 論文が重い記法を使用している場合、記号と説明をマップする markdown テーブルを含む小さな「記法リファレンス」セルを含めます。

ユーザーがカスタム anywidget を望む場合は、references/ANYWIDGET.md を参照してください。