masamasa59 Newsletter 作成手順（ai-agent-papers）
月次のトレンドニュースレターを作る手順。既存の書式は newsletters/*/*.md（特に近い号）を参照する。出力言語は日本語。
0. 大原則（過去のレビューで確定した必須事項）
- arXiv は HTML を読む（
https://arxiv.org/html/<id>）。/abs/は内容が足りないので使わない。HTML が 404 のときだけ/abs/にフォールバックし、その旨を号内に明記。 - 論文全体を読む：手法と数値だけを抜くのではなく、背景・動機（なぜ重要か）・実験・結果・考察(discussion)・限界(limitations) まで踏まえて要約する。著者の論旨・条件・反証を反映する（数値の羅列にしない）。
- 図を入れる：HTML から framework/overview 図を取り出し、実画像を保存して引用する。
- 複数論文で裏付けたファクトを重視：単一研究に過剰適合しない。1本だけの結果は「裏付けは弱め・要追試だがインパクト大」として別建てで明示する。
- 数字は初見でも凄さが分かる表現に：基準・倍率・意味を必ず添える。
- 対象月に 7本以上あるコヒーレントなテーマは、すべて号にする。本数の上限は設けない（下記の選定基準）。
- 読みやすさを最優先（下記「読みやすさの原則」）。
読みやすさの原則（最重要）
読者は毎月この分野の論文を読む専門家。基礎の説明ではなく「先月からの差分・今月の含意」を求めている。過剰な噛み砕きは逆効果。
- 専門家向けに、差分で書く：各号の冒頭は
## この号の位置づけ（先月からの差分）。「◯◯とは」という初歩の定義や日常比喩（運転手・レシピ等）は入れない。先月の状態→今月何が変わったか、を簡潔に。 - 日本語として自然に書く（言葉遣いが最重要）：日本の研究機関・研究ブログのように読める文章にする。英単語を日本語の助詞でそのままつながない（× 「harness適応が主流化」→ ○ 「テスト時にハーネスを適応させる手法が主流に」）。
- 借用語はカタカナ：ハーネス／エージェント／モデル／プロンプト／ツール／メモリ／スキル／コンテキスト／ベンチマーク。タイトルはカタカナ併記可（例「ハーネス（Agent Harness）」）。
- 概念は日本語に言い換える：held-out→「学習に使っていない別のタスク」、backbone→「ベースのモデル」、test-time→「テスト時」、weights(θ)→「重み」、scaffold(Σ)→「外側の仕組み／足場」、transfer→「（別のモデルへ）移す・転移」、fine-tune→「微調整」。
- 勝手な訳語・造語を作らない：×「被覆ギャップ」→説明で置き換える（「候補が一度も作られないまま終わるタスク」）。単一論文の造語（confidence cliff 等）はそのまま出さず、意味を一度だけ日本語で述べる。
- 記号的な略記を避ける：×「G 分岐×R ラウンド」→○「候補をいくつも並行して作って選ぶ」。
- 固有名詞（TTHE / SWE-bench / GPT-5.5 等）と一般的な略語（LLM / RL / RAG）はそのまま使う。
- 数値は必ずモデル/データ条件つき：
12→50%ではなくtext-to-SQL(BIRD hard, 凍結LLM) 12→50%。条件を欠いた数字は載せない。 - 解釈（倍率・コスト比）は控えめに扱う：「4倍」「1/25」等の解釈はどのモデル/データかで意味が変わる。だから (a) 太字にしない、(b) 3行サマリなど短い要約には入れない。本文で触れるとしても、条件を添えて淡々と。
- なぜ → どう の順：目的・効く理由 → 仕組み → 結果（条件つき）→ 限界。手法名や数値の抜き書きにしない。
- 明示的なつなぎ：「先月まで」「ところが」「つまり」等で論の流れを示す。
- 各号は
## この号のまとめで、確実な点／今月の注意／単発（要追試）を締めに整理する。
1. 対象カテゴリの選定
- 対象月の
[Mon YYYY]タグでカテゴリ別の本数を数える：for f in $(find capabilities applications architecture operations -name '*.md'); do n=$(grep -cE '\[<Mon> <YYYY>\]' "$f"); [ "$n" -gt 0 ] && printf "%3d %s\n" "$n" "$f"; done | sort -rn - 本数が ≥7本 かつコヒーレントなカテゴリはすべて号にする。3本などの上限を設けない。分野混在の受け皿（例
vertical-agents）は避け、1テーマ1号にする。 - 重複は落とす理由にならない。同じ論文が複数の号に出てよい。カテゴリが違えば読者の関心も違うので、角度を変えて書き、号どうしを相互リンクする（例：ある論文をハーネス号では「実行足場の設計」として、評価号では「測定器の非中立性」として扱う）。落とす判断は「テーマとして立たない」ときだけ。
- 前月と同じカテゴリでも、本数が基準を満たすなら継続して出す。トレンドの継続は報告に値するファクトである。大きな変化がなければ「先月の方向がそのまま続き、同種の論文が N 本出た」と正直に書けばよい。無理に新規性を演出しない——差分がないことを差分として書く。
- 本数を数えたら、落としたカテゴリと落とした理由を一言メモしておく（後から選定基準を説明できるようにする）。
- 各カテゴリの対象論文（当月分）の arXiv ID を抽出：
grep -E '\[<Mon> <YYYY>\]' <path.md> | grep -oE 'arxiv.org/abs/[0-9v.]+' | sed 's#arxiv.org/abs/##'
2. 各論文を HTML 精読
- 各 ID を
WebFetch https://arxiv.org/html/<id>で取得。プロンプトは手法/結果だけでなく 背景・動機・考察・限界も求める。例：「Extract from the full HTML: (1) title, (2) motivation/background — why this problem matters, (3) core method, (4) experimental setup + key quantitative results with numbers and baselines, (5) discussion/limitations. THEN: FIGURE | | <img src e.g. 2606.xxxxxvN/xxx.png>. If 404 reply only NO HTML.」
- 404 の場合のみ
/abs/にフォールバック（号内に「abstract のみ」と注記）。
3. 図の取得と埋め込み
- 図の 正確な
<img> srcを得る（版番号vNに注意。.../assets/xxx.pngのようにサブディレクトリのことがある）。 - 実画像をダウンロードし、本当に画像か検証（HTML 404 は 8KB 程度のテキストが返る）：
curl -sL "https://arxiv.org/html/<id>vN/<fig>.png" -o "newsletters/assets/<id>-<slug>.png" file newsletters/assets/<id>-<slug>.png # → "PNG image data" ならOK。HTMLなら破棄 - 保存先は
newsletters/assets/。1号あたり 3〜4点、代表的な framework/結果図を選ぶ。 - 埋め込み（相対パス）:
 > 図（<Paper>）：<caption>（[論文](https://arxiv.org/abs/<id>)）
4. 構成（ハウススタイル）
# <Theme> 研究トレンド（YYYY年M月）
> 対象カテゴリへのリンク・本数・「arXiv HTML 本文を精読」の一言。
## 3行サマリ
- できるだけ各項目を複数論文で裏付ける。
## クロス論文で見るトレンド（継続 / 明確化 / 単発の注目結果）
**継続する傾向（過去号からの延長）** … 複数論文が共有する方向（過去号にリンク）。
**今月明確になった点（複数論文で裏付け）** … 各項目に **裏付けた論文名を2〜4本明記**。
**単発だがインパクトの大きい結果（裏付けは弱め・要追試）** … 1本のみの striking な結果。「1事例／要追試」と明示。
## 数字で見るインパクト
| 論文 | 数字 | 初見の読み方 |
|---|---|---|
| … | 生の数字 | 基準・倍率・意味（例：「ほぼ据え置き＝進化は効いていない」「大型の9割を約1/25コスト」） |
## 論文紹介（サブテーマ別）
### ① …
[Title](https://arxiv.org/abs/<id>)
2〜4文：**背景/なぜ効くか（考察）** ＋ 手法 ＋ 主要結果（数値） ＋ 限界。
 ＋ 図キャプション
## 論点・未解決課題
番号付きで、**各論点に複数論文を引用**。
## 次に来るもの（Watch next）
---
*本ニュースレターは各論文の arXiv HTML 本文を精読（404 は abstract）。図は `newsletters/assets/` に保存。対象＝<category.md> の YYYY年M月。関連号にリンク。*
5. 数字を「初見で分かる」ように書くコツ
- 必ず 基準（vs baseline / human / legacy） か 倍率・割合 を添える。
- 「凄い/残念」の含意を言語化：
+0.6pt →「ほぼ据え置き＝過学習の警告」、89.7% at 4% cost →「大型の9割を約1/25の値段」、Jaccard=0 →「集約を変えるだけで1位が入れ替わる」。 - 低い絶対値は「なぜ難しい課題か」を補う（例：
脆弱性検出 6.2% →「従来1%が限界の難題を6倍」）。
6. 仕上げ・検証
- 画像参照がすべて実ファイル（有効 PNG/JPEG）か確認：
for img in $(grep -rhoE '\(\.\./assets/[^)]+\)' newsletters/*/*.md | sed -E 's#\(\.\./assets/##; s#\)##' | sort -u); do { [ -f "newsletters/assets/$img" ] && file "newsletters/assets/$img" | grep -q -E 'PNG|JPEG'; } || echo "BAD $img"; done - ファイル名：
newsletters/<mon>_<year>/<theme>_trends.md（例jul_2026/harness_trends.md）。 - 関連号（前月・関連カテゴリ）に相互リンク。
- README に反映（必須）：
# Trend Newsletters（研究トレンド）節へ当月分を追記する。書式は月ブロック＝**YYYY-MM**見出し＋[Theme](newsletters/<mon>_<year>/<theme>_trends.md) · …。該当月ブロックが無ければ最新が上に来るよう新設。追記後に README 内リンクの実在を確認する。 - コミットは説明的メッセージで。push はユーザーの明示指示があるときだけ。
チェックリスト（提出前）
- 各論文を
/html/で読んだ（abs のみは 404 時だけ・注記あり） - 背景・考察・限界まで反映（method＋数値の抜き書きになっていない）
- 図 3〜4点、すべて実画像・出典リンク付き
- 「今月明確化」は各項目 ≥2 論文で裏付け／単発結果は「要追試」と明示
- 数字テーブルに「初見の読み方」列があり、基準・倍率・意味が分かる
- ≥7本のコヒーレントなカテゴリをすべて号にした（3本などで打ち切っていない）
- 落としたカテゴリと理由を説明できる
- 継続テーマは「続いている」と正直に書いた（新規性の演出をしていない）
- README の
# Trend Newsletters節に当月分リンクを追記した（実在確認済み）