# テロップ改行ナレッジ（まさき式）

> まさき本人の改行 vs AIの自動改行の差分を言語化したナレッジ。
> `/supermovie subtitles` および台本ドリブン分割では、このナレッジを最優先で適用する。
> 最終更新: 2026-06-09（APIキー解説動画の台本でキャリブレーション）

---

## 結論（最重要・3行で）

1. **1行は長めに使う。上限15字 → 最大18字。** 平均12〜17字を狙う（19字だと2行に折り返すため18字厳守）。
2. **改行頻度を下げる。** AIは切りすぎ。短い断片は隣の行に統合する。
3. **助詞ごとに切らない。意味の塊（主語〜述語 / 修飾語〜被修飾語 / 節）がまとまるまで切らない。**

---

## まさき式の改行ルール（精密版 v2）

### ★ 第一原理（これが全て）

> **「文節」で切るな。「節（せつ）」で切れ。**
>
> - 文節 = 名詞＋助詞 / 用言ひとつ（例:「サイトごとに」「固有の文字列が」）← AIはここで切る癖＝×
> - 節 = 主語〜述語、目的語〜動詞 など **意味が一区切りする単位**（例:「サイトごとに固有の文字列が発行されて」）← まさきはここで切る＝○
>
> **1行＝1節。** 節がまるごと1行に収まるなら、途中の助詞では絶対に切らない。

### 手順（この順で判定する）

```
1. 文を「節」に分ける（主語〜述語 / 接続で区切れる意味のまとまり）
2. 各節を1行にする
3. 節が18字を超える場合だけ、その節の中の「最後の助詞」で2行に割る
   （を/に/で/と/が/は/の の後ろ。割っても主語側が宙ぶらりんにならない位置）
4. 行頭の「シーン設定句（接続詞＋主題）」は短くても独立行にする
5. 見出し・フィラー・句読点を処理する
```

### 【1行の長さ】
- **目標 12〜18字 / 最大18字**
- シーン設定句・見出し・決め台詞は **5〜9字でもOK**（短いこと自体は悪くない。中途半端な所で切るのが悪い）

### 【必ず改行する】（節の終わり）
1. 文末：です / ます / ますね / ですね / ください / ません / んです / でした / ましょう
2. 接続の節切れ：けど / けれど / ので / から / たら / ば / し / 〜て（テ形で節が切れる時）
3. 18字を超える時：その節の中の最後の助詞で割る（強制）

### 【短くても独立行にする】（シーン設定句）
文頭の「接続詞＋主題」は、次に来る内容（コメント）と分けて独立させる。
- なので今回は / それでは今回は / なぜかと言うと / ちなみに〜は / この2つって / 細かい違いは
- では / ではまず1つ目 / では続いて2つ目 / では最後4つ目 / ということで
→ これらは5〜8字でも改行してよい（むしろ分けた方がリズムが出る）

### 【絶対に切らない】（節の内部）
- 主語＋述語、目的語＋動詞（「APIキーを使うことになるので」を割らない）
- 修飾語＋被修飾語（「ものすごく大きな金銭的損害」を割らない）
- 固有名詞（API / Claude Code / .env / CLAUDE.md / AGENTS.md）
- 数字＋助数詞（3つ / 2層 / 何十万円 / 1日）
- 用言の活用途中（設定する / 漏洩して）
- 「〜って」「〜という」は後続の体言（ことが / もの / 方法 / 形）まで繋いでから切る

### 【見出しの扱い】
- 目次の列挙内：番号マーカーを独立行（「1つ目」「2つ目」…単独）
- 本編の章開始：シーン設定とセットで1行（「ではまず1つ目」「では続いて2つ目」）
- ルール／層：「ルール1」「ルール2」「1層目」は独立行
- ※★は内部判定用（強調＝アニメ＋SE）。**出力には★を出さない。**

### 【その他】
- 句読点（、。）除去。！？は残す
- フィラー（えーと / あのー 等）削除
- 話題転換で空行（段落）

---

## 差分の言語化（AI → まさき）

### 差分1: 短い断片を作らない（隣に統合）
AIは2行に割るが、まさきは1行にまとめる。

| AI（×切りすぎ） | まさき（○） | 字数 |
|---|---|---|
| 「APIの渡し方と」「セキュリティ対策」 | 「APIの渡し方とセキュリティ対策」 | 14 |
| 「何ができて」「何ができないかを」 | 「何ができて何ができないかを」 | 13 |
| 「すごく大事な」「機密情報なんですね」 | 「すごく大事な機密情報なんですね」 | 14 |
| 「もっと安全な」「接続方法が」 | 「もっと安全な接続方法が」 | 11 |
| 「家の鍵と同じ」「イメージで」 | 「家の鍵と同じイメージで」 | 11 |

### 差分2: 意味のまとまり（修飾語＋被修飾語/主語＋述語）を割らない
| AI（×） | まさき（○） | 字数 |
|---|---|---|
| 「ものすごく大きな」「金銭的損害が」 | 「ものすごく大きな金銭的損害が」 | 13 |
| 「入り口の鍵みたいな」「ものなんですね」 | 「入り口の鍵みたいなものなんですね」 | 16 |
| 「基本的にこのキーを」「使うことになるので」 | 「基本的にこのキーを使うことになるので」 | 18 |

### 差分3: 助詞ごとに切らず「節」単位で切る
AIは助詞の直後で細切れにするが、まさきは主語〜述語/目的語〜動詞が繋がるまで切らない。

| AI（×） | まさき（○） | 字数 |
|---|---|---|
| 「サイトごとに」「固有の文字列が発行されて」 | 「サイトごとに固有の文字列が発行されて」 | 17 |
| 「それを使うことで」「AIがそのサービスに」 | 「それを使うことでAIがそのサービスに」 | 17 |
| 「裏から入って」「操作できるようになります」 | 「裏から入って操作できるようになります」 | 17 |
| 「AIにサービスと」「連携してもらうためには」 | 「AIにサービスと連携してもらうためには」 | 18 |

### 差分4: 「って/という」は後ろの語句まで含めてから切る
| AI（×「って」で切る） | まさき（○ 塊にする） |
|---|---|
| 「勝手に操作されるって」「ことが起きてしまいます」 | 「勝手に操作されるってことが」「起きてしまいます」 |

→ 「って」単独で改行せず、「ってことが」まで繋げて意味の塊にし、述語（起きてしまいます）の前で切る。

### 差分5: 変えない点（AIと一致）
- 見出し（1つ目 / ルール1 / 1層目 / 最後4つ目）は独立1行。
- 文末（です/ます/ね/ですね/ください）では切る。
- 段落（話題転換）で空行。

---

## 実装方針

### 原則: 分割は LLM（Claude）が「節」を見て行う

純アルゴリズム（文字数＋助詞）では「文節切り」になりやすく、まさき式（節切り）は再現できない。
**台本／文字起こしを Claude が読み、上の手順で節に分けて改行する**のが正道。
このナレッジの例を few-shot として参照し、迷ったら「この節は1つの意味か？」で判断する。

### アルゴリズム併用時の近似パラメータ（フォールバック）

```
TARGET = 12〜18字, HARD_MAX = 18
強い改行: 文末(です/ます/ね/ですね/ください/んです/でした) → 必ず改行
節の改行: けど/けれど/ので/から/たら/ば + テ形節切れ → 改行
助詞改行: を/に/で/と/が/は/の → 「18字を超える時だけ」最後の助詞で割る
         （※14字未満では助詞で切らない＝断片化防止）
シーン設定句: なので〜は / では〜 / ちなみに〜 / この〜って → 独立行(短くてもOK)
固有名詞・数字+助数詞・「ってことが」「という方法」: 塊を割らない
見出し: 目次=番号単独行 / 本編=「では〜N つ目」セット / ルールN・N層目=独立行
```

### キャリブレーション履歴
- 旧: MIN=7 / PART_MIN=12 / HARD=24 → 切りすぎ（文節切り）
- v2: 節ベース判定 + HARD=18 + 助詞切りは「18字超のみ」→ まさき式に一致
- v2.1: 上限を19→18字に厳格化（19字だと盤面で2行に折り返したため）
- v2.2: ★全編均一（まさきFB）。長文ほど後半の改行が粗く・忠実度が落ちる癖あり。
  対策=セクション分割で前半と同じ集中度・粒度で処理し、後半・締めも喋った内容を省略しない。
  数(密度)が揃っていても「切る位置の自然さ・言い回しの忠実さ」が落ちやすいので、
  後半ほど一語一語ていねいに節を見る。書き出し前に前半/中盤/後半の質を点検。
