# Newsletter

> Write a monthly trend newsletter for this ai-agent-papers repo. Use when asked to create/update a monthly trend report, summarize a category's recent papers, or "make a newsletter". Encodes the house procedure: cover every coherent category with enough papers that month (no fixed number of issues; overlap between issues is fine when the angle differs), read each paper's arXiv HTML in full (background + discussion, not just method/numbers), embed real figures, and write a Japanese summary built on facts corroborated across multiple papers with numbers made legible to a first-time reader.

- Skill: `masamasa59/newsletter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add masamasa59/newsletter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/masamasa59/newsletter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: masamasa59 (https://skillmd.com/u/masamasa59)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/masamasa59/newsletter

---


# Newsletter 作成手順（ai-agent-papers）

月次のトレンドニュースレターを作る手順。既存の書式は `newsletters/*/*.md`（特に近い号）を参照する。出力言語は**日本語**。

## 0. 大原則（過去のレビューで確定した必須事項）
1. **arXiv は HTML を読む**（`https://arxiv.org/html/<id>`）。`/abs/` は内容が足りないので使わない。HTML が 404 のときだけ `/abs/` にフォールバックし、その旨を号内に明記。
2. **論文全体を読む**：手法と数値だけを抜くのではなく、**背景・動機（なぜ重要か）・実験・結果・考察(discussion)・限界(limitations)** まで踏まえて要約する。著者の論旨・条件・反証を反映する（数値の羅列にしない）。
3. **図を入れる**：HTML から framework/overview 図を取り出し、実画像を保存して引用する。
4. **複数論文で裏付けたファクトを重視**：単一研究に過剰適合しない。1本だけの結果は「**裏付けは弱め・要追試だがインパクト大**」として別建てで明示する。
5. **数字は初見でも凄さが分かる表現に**：基準・倍率・意味を必ず添える。
6. **対象月に 7本以上あるコヒーレントなテーマは、すべて号にする**。本数の上限は設けない（下記の選定基準）。
7. **読みやすさを最優先**（下記「読みやすさの原則」）。

## 読みやすさの原則（最重要）
**読者は毎月この分野の論文を読む専門家**。基礎の説明ではなく「**先月からの差分・今月の含意**」を求めている。過剰な噛み砕きは逆効果。

1. **専門家向けに、差分で書く**：各号の冒頭は `## この号の位置づけ（先月からの差分）`。「◯◯とは」という初歩の定義や日常比喩（運転手・レシピ等）は**入れない**。先月の状態→今月何が変わったか、を簡潔に。
2. **日本語として自然に書く（言葉遣いが最重要）**：日本の研究機関・研究ブログのように読める文章にする。英単語を日本語の助詞でそのままつながない（× 「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）はそのまま使う。
3. **数値は必ずモデル/データ条件つき**：`12→50%` ではなく `text-to-SQL(BIRD hard, 凍結LLM) 12→50%`。条件を欠いた数字は載せない。
4. **解釈（倍率・コスト比）は控えめに扱う**：「4倍」「1/25」等の解釈は**どのモデル/データかで意味が変わる**。だから **(a) 太字にしない、(b) 3行サマリなど短い要約には入れない**。本文で触れるとしても、条件を添えて淡々と。
5. **なぜ → どう の順**：目的・効く理由 → 仕組み → 結果（条件つき）→ 限界。手法名や数値の抜き書きにしない。
6. **明示的なつなぎ**：「先月まで」「ところが」「つまり」等で論の流れを示す。
7. 各号は `## この号のまとめ` で、確実な点／今月の注意／単発（要追試）を締めに整理する。

## 1. 対象カテゴリの選定
- 対象月の `[Mon YYYY]` タグでカテゴリ別の本数を数える：
  ```bash
  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 を抽出：
  ```bash
  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 | <caption of main framework 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 程度のテキストが返る）：
  ```bash
  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/結果図を選ぶ。
- 埋め込み（相対パス）:
  ```markdown
  ![<label>](../assets/<id>-<slug>.png)
  > 図（<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文：**背景/なぜ効くか（考察）** ＋ 手法 ＋ 主要結果（数値） ＋ 限界。
![…](../assets/…)  ＋ 図キャプション

## 論点・未解決課題
番号付きで、**各論点に複数論文を引用**。

## 次に来るもの（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）か確認：
  ```bash
  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` 節に当月分リンクを追記した**（実在確認済み）