# トークリール台本作成スキル — 導入プロンプト（このファイルを丸ごとAIに渡してください）

---

## 【受け取った方へ】使い方（ここだけ読めばOK）

1. **Claude Code**（または Codex）を起動する。
2. このファイルを **AIにドラッグ＆ドロップで添付**（またはファイルを開いて全文コピー → AIに貼り付け）して送信する。
3. AIが自動でスキルを組み立てます。終わったら **AIを完全に終了して再起動**。
4. `/talk-reel-script` で起動します。

**ZIPの手動保存・解凍なしで復元できます。** 配布ZIPと同じ 8 ファイルをテキストで収録しています。復元後の依存ツール導入は説明書に従います。OSや環境による確認・警告が出る場合もあります。

うまくいかない時は「スキルが作れているか確認して」とAIに伝えてください。

---

あなた（AI）はこれから、「トークリール台本作成スキル」を利用者のPCに構築します。以下の指示に厳密に従ってください。

## 手順

0. 実行環境（Mac / Windows）を確認する。**手順1〜3ではファイル復元だけを行う。** 配布ファイルは本文にそろっている。外部ツールの依存導入は手順4で行う。

1. 作業フォルダ `~/Downloads/AI顧問スキル/talk-reel-script/` を作成する（Windows は `%USERPROFILE%\Downloads\AI顧問スキル\talk-reel-script\`）。
   - 同名フォルダが既にある場合は新しい作業フォルダへ復元する。導入先の旧版を別の場所にバックアップし、mydata・本人ナレッジ・認証設定を保全してから切り替える。復元やセットアップに失敗したら旧版へ戻す。

2. 下の「ファイル定義」にある **8 ファイル** を、指定された相対パス（`~/Downloads/AI顧問スキル/talk-reel-script/` からの相対）に作成する。
   - 各ファイルの内容は `========== FILE: パス ==========` 行の次の行から `========== END FILE ==========` 行の直前の行までを、
     **一字一句変更せずそのまま** 書き込む。ファイルの末尾は改行1つで終わらせる。
   - 要約・整形・体裁変更・翻訳・改行の増減・全角半角の変換・Markdown記法の「修正」は一切禁止。
     マーカー行（`========== ... ==========`）自体はファイルに含めない。
   - ファイル数が多い場合は数ファイルずつに分けて作成してよい。**途中で省略せず、必ず全ファイルを作りきる。**

3. 全ファイル作成後、次を検証して結果を報告する:
   - `~/Downloads/AI顧問スキル/talk-reel-script/` 配下に 8 ファイルが存在すること
   - 各ファイルの行数（`wc -l`）が下の「行数チェック表」と一致すること。
     一致しないファイルがあれば、そのファイルだけ作り直す。

4. **セットアップまで実行する。** 作成したフォルダの中にある説明書
   （`README.md` / `README_使い方.md` / `INSTALL.md` / `INSTALL_FOR_AI.md` / `はじめにお読みください.md` のうち存在するもの）を読み、
   そこに書かれた手順どおりに、このPCで `/talk-reel-script` が使える状態まで導入を完了させる。
   - 説明書に Claude Code 用・Codex 用の両方が書かれている場合は、現在のアプリを確認して該当手順を使う。判別できない場合だけ利用者に聞く。
   - 追加で必要なもの（Python等）が足りなければ、OSを確認して1ステップずつ案内する。

5. 最後に利用者へ、次の3点を伝える:
   - 作成したフォルダの場所（フルパス）
   - **AIを完全に終了して再起動する**必要があること
   - 再起動後 `/talk-reel-script` で呼び出せること

## 行数チェック表（wc -l の値）

| ファイル | 行数 |
|---|---|
| SKILL.md | 106 |
| agents/openai.yaml | 6 |
| references/composition.md | 67 |
| references/interview.md | 66 |
| references/knowledge.md | 45 |
| references/quality.md | 82 |
| references/writing.md | 56 |
| scripts/measure_script.py | 165 |

---

## ファイル定義

========== FILE: SKILL.md ==========
---
name: talk-reel-script
description: テーマから本人の考えを1問ずつ深掘りし、本人のナレッジを使い、内容に合う最大5つの構成案から選んでもらって、読み上げ用のトークリール台本を1本仕上げる。ショート動画の対話型台本作成、完成稿の口語修正にも使う。動画編集は対象外。
---

# トークリール台本作成スキル

テーマを受け取ったら、本人の考えを1問ずつ掘り、本人の資料を使う。内容から作った構成を見比べて選んでもらい、そのまま読める台本を1本仕上げる。

## 対象外
- 動画編集、テロップ、BGM、撮影演出（求められた時だけ短く添える）
- TTS、投稿、予約、分析
- 量産用プロンプトや企画の大量案（提案もしない）
- 新しい自動化や外部サービスの設定

## 情報の扱い
- 本人の考えは、会話での最新の発言（訂正後）を正とする。次に本人の資料を使う。旧メモや過去の条件は、今回の依頼より優先しない。
- 外部の事実は、本人の考えとは別の軸で扱う。本人の意見で事実を上書きせず、事実を理由に本人の価値観を書き換えない。食い違う時は、意見と事実を分けて確認する。
- 本人の発言は、誰の話か、一度の出来事か続けている習慣か、提案か仮説か、に加えて、予定・決定・実施・結果のどの段階か（未決の項目も）を区別して持つ。構成案・主張・本文まで、その段階と確かさのまま語る。一度の体験を習慣や成功実績に、予定を決定や開始済みの言い方に強めない。仮説は仮説のまま話す。
- 次は作らない: 本人が実際にやった事実・数字・声（発言や口コミ）、本人の新しい理由や好き嫌い、他者の内心、技術的な手順や適用条件、効果の因果や最適な頻度。制作メモで「AIの提案」と断っても、本文で断言してよいことにはならない。
- 書き手が考えてよいのは、接続・たとえ・配置と、聞き手にも仮定と分かる説明用の会話や対照まで。

## 流れ

### 1. 入口
- 渡されたファイルや資料は、質問より先に読む。読み方は references/knowledge.md。
- 既に分かることは聞き直さない。
- 台本の核になる手順の内訳・理由・条件が未提示で、説明に不可欠なら、その内容だけを1問聞く。既に記載がある内訳は採用し、聞き直さない。言い回しや形式の確認より、内容の穴を優先する。
- 完成稿の直しや修正の依頼なら、「修正依頼」へ進む。

### 2. 深掘り（1ターン1問）
- 1ターンは、受け止め1〜2文と質問1つ。
- 1問を許可や承認の確認に使わない。直前にまだ出ていない理由・場面・判断の分かれ目を聞く。
- 質問を出す前に、文中に含めた理由・因果・心情が本人の既出の言葉にあるか確かめる。なければ前提に置かず、その判断のきっかけや場面を聞く。
- 本人が言い切った結論や境界は聞き直さない。
- 材料が揃ったら、往復の回数に関係なく3へ進む。
- 本人が疲れた様子なら質問を止め、推奨の仮案を出して反応をもらう。
- 尺は、指定がなければ60秒前後で進める。話し手は、資料から誰の言葉か判別できず制作に支障がある時だけ、1問で確認する。
- 質問の選び方と詰まった時の対応は references/interview.md。

### 3. 構成候補
- まず「今回残すメッセージ」を1文で示す。
- 候補は最大5案。冒頭を除いた本文で、順序・見せる証拠・視聴者が気づく場所が違う案だけを出す。各案で、聞き手が何を中心に納得するかを一つずつ選ぶ。
- 材料が薄ければ5を埋めず、実質差のある2〜3案にし、理由を1行添える。
- 本人の材料にない知識がないと成り立たない案は外すか、不可欠な事実を1問確認してから出す。
- 実質差のある案が1つだけなら、その1案を仮案として示し、別の伝え方に必要な内容を1問だけ聞く。本人が任せた場合は、その1案で原稿へ進む。
- 名前はその回の中身から付ける普通の日本語にする。固定の型一覧や他者の構成名は使わない。
- 各案に載せるもの:
  - 番号と名前
  - 冒頭1文
  - 内容入りの流れ（→で3〜4段）
  - 視聴者がどこで何に気づくか
  - 材料が揃っているか（AIが補う事実を数えない）
- 最後に推奨1案と理由を1〜2文添え、「番号か『おまかせ』で返してください」で締める。
- 表示は作業場の決まりがあれば従う。なければ短い一覧か小さな表にする。
- 設計の詳細は references/composition.md。
- 通常は選択を省かない。「おまかせ」「go」「今すぐ書いて」と言われたら推奨案で進め、採用した案名を一言伝える。
- 選択後、原稿に不可欠な点で意味が二つに割れるものがあれば、その1点だけ聞く。

### 4. 執筆
references/writing.md に沿って書く。要点:
- 書く前に、最新の尺指定を字数の予算に変える。「以内」は上限ぎりぎりを狙わず、余裕を持って書く（詳細は references/quality.md の「尺」）。
- 冒頭で浮かんだ疑問に次の文が答え、その答えが本人の理由へつながるようにする。
- 選ばれた構成の順番で書く。場面・理由・結論がつながるようにし、一般論の言い換えを重ねない。
- 本人の引用、指定されたセリフ、指定された締めは原文のまま使い、細部を足さない。
- 境界は誇張しない短い1文で残す。免責の列挙を喋らせない。
- 余韻で終える指定なら、行動の呼びかけや問いかけを足さない。

### 5. 見直し
出す前に次を順に行う。本文を直したら、関わる確認をやり直してから6へ進む。
- 合否と照合: references/quality.md の合否を確認する。数字・手順・体験・引用を使う案は、原資料との照合を行う。素材を補った箇所や曖昧な箇所があれば、利用可能な別のAIへ原資料と案だけを渡して初見の点検を頼む。書き手の「材料は揃った」という自己申告で通さない。別AIを使えなければ、原資料だけから材料を書き出し直す別の確認を行う。
- 尺: references/quality.md の「尺」に沿って推定する。ツールが使えれば、字数と読みを測って確かめる。「以内」で上限を超えたら合格とせず、書き直して再確認する。
- 反映: 直す点や短縮案が見つかったら、自分で本文へ反映して確認し直す。案のまま本文の後に残さない。
- 検品や尺のために中身を痩せさせない。削る時は、伝える価値を1つに絞って書き直す。

### 6. 出力
利用者の最新の出力指定を最優先する。指定がなければ次の形で出す。

主張: （1行）

【読み上げ原稿】
（本文のみ）

字数: ○○字 / 推定尺: 約○〜○秒（未収録）

- 「原稿だけ」は出力の形の指定。5の確認は内部で済ませ、本文だけを出す。字数・尺・評価は添えない。
- 両立しない条件があれば短く伝え、何を優先した稿かを1行示す。満たせていないものを、完成や尺内と呼ばない。
- 制作メモは、未確定の事実や本人しか確認できない点が残る時だけ、1〜2短行で添える。削り方・改善案・別候補は本文へ反映するか、書かない。
- 点検や制作側のやりとりは内部にとどめる。利用者に見せるのは、採用した案・必要な修正点と完成稿に絞る。

## 修正依頼
- 最初の質問に戻らない。変更が主張・構成・声・尺のどれに当たるかを判断し、該当部分だけ直す。
- 「ここだけ」「ほかは変えない」という局所指定では、それ以外の文字列をそのまま残す。主張や構成の変更なら、必要な接続や指示語も整える。固定されたセリフや末尾は、省略も肉付けもしない。
- 直した点は1行で添える。「原稿だけ」と言われていれば添えない。

## 保存
- 利用者が指定した作業場・保存先を使う。作業場に保存の規約（フォルダ構成やファイル名の決まり）があれば、それに従う。
- 保存先の指定がなければ、完成稿は会話に出す。保存が必要な時だけ、保存先を一言確認する。
- 質問のたびにファイルは作らない。途中再開を頼まれた時だけ、回答済み / 未解決 / 選んだ案 を短く保存する。

## 参照（必要な時だけ読む）
- references/interview.md: 深掘り中。次の1問の選び方、詰まった時の対応
- references/knowledge.md: 深掘り中。資料の読み方、出典の持ち主
- references/composition.md: 構成候補を作る時
- references/writing.md: 執筆時。聞ける台本の書き方
- references/quality.md: 出す前。合否、尺、計測
========== END FILE ==========

========== FILE: agents/openai.yaml ==========
interface:
  display_name: "トークリール台本作成スキル"
  short_description: "内容を深掘りし、最大5つの構成案から選んでトークリール台本を作成"
  default_prompt: "$talk-reel-script で、このテーマを対話で深掘りし、最大5つの構成案から選んでトークリール台本を作って。"
policy:
  allow_implicit_invocation: true
========== END FILE ==========

========== FILE: references/composition.md ==========
# 構成候補の設計

## 前提
- 型一覧から選ばせず、集めた中身から組み立てる。名前は毎回中身から付ける。
- 全候補で、主張・境界・何を問題にしているか・話の段階（予定／決定／実施／結果と、その確かさ）を共通に保つ。入口を変えるために「無断で内容が変わる怖さ」を「整った文章そのものが怖い」へ変えるなど、対象や理由をずらさない。予定の話を、始めた話や結果の出た話にした案を作らない。
- 素材は手元にあるものから選ぶ。場面、会話、誤解、比較、試したこと、本人の一言、理由の説明など。固定のカテゴリにはしない。
- 今ある資料と会話だけで話せる案を優先する。未提供の研究、お客様の声、別の体験がないと成り立たない案は作らない。
- 本人の新しい理由や好き嫌い、他者の内心、技術的な手順や適用条件、効果の因果や頻度を足さないと成り立たない案も作らない。「AI仮案」「一般論」と付けても材料が揃ったことにはならない。不可欠なら、その事実を1問確認してから出す。
- 内訳や理由が語られていない決め台詞は、そのまま置く案にする。未提示の内訳の解説を候補にしない。

## 差の確かめ方
冒頭1文を隠し、本文だけを並べて次を比べる。
- 何を先に見せるか
- どんな順番と因果で進むか
- 何を証拠として見せるか
- 視聴者がどこで何に気づくか

冒頭以外が同じなら、1案にまとめる。少なくとも推奨案と他の案は、「何を先に見て、どこで気づくか」が違っていること。

各案で、聞き手が何を中心に納得するかを一つ選ぶ（例: 体験の時系列で発見する／短い仮定の二場面を比べて本人の意見へ進む）。毎案に同じ体験と同じ解説を戻して説明しない。仮定の場面の後に同じ体験と解説が要るなら、体験の案へ統合する。

材料が薄ければ5案を埋めず、実質差のある2〜3案で出し、「材料が一つの場面なので2案です」のように短く理由を添える。

実質差のある案が1つしか残らない場合は、その1案を仮案として示す。本人が任せていなければ、別の見せ方に必要な内容を1問だけ聞き、任せていればその案で書く。

## 入れないもの
- 根拠のない成功物語やビフォーアフター
- 一度の出来事を、習慣や実績として語る流れ
- 本人の立場と逆の結論
- 出来事の後に良い結果があっただけで、その行動が原因だったと証明する流れ。本人の考えなら「そう考えたきっかけ」とし、結果の理由が分かったとは書かない。
- 尺に入らない多段構成

## 推奨の選び方
次を満たす案を選び、理由を1〜2文で添える。
- 本人の材料が最も揃っている
- メッセージまでの道が短い
- 境界を自然に残せる

## 比較例
※説明用の架空設定。本人の体験として流用しない。

- テーマ: 頼まれごとを断れずに抱え込む
- 材料: 先月一度、予定を見ずに引き受けて、週末に作業した。
- 本人の考え: 断るのが下手なのではなく、引き受ける前に予定を見る一手が抜けている。全部断れという話ではない。
- 今回残すメッセージ: 断る練習より先に、引き受ける前に予定を見る一手を入れる。

1. 週末にしていた作業
冒頭: 「先月、予定を見ずに引き受けた仕事を、週末にやっていました」
流れ: 週末の作業 → 振り返ると、返事の時点で予定を見ていなかった → 断るのが下手なのではなく、確認が抜けていた → 次は予定を見てから返したい
気づく所: 中盤。原因が性格ではなく、返事の瞬間にあったと分かる
材料: 揃っている

2. 性格のせいにしない
冒頭: 「断れないのを、性格のせいにしていませんか」
流れ: 性格の問題にしがち → 性格を変えなくても、予定を見る一手は入れられる → 先月の週末の例 → 全部断る話ではない
気づく所: 前半。問題の置き場所が、性格から手順に移る
材料: 揃っている

3. 二つの返事
冒頭: 「同じ頼まれごとに、いいですよと返すか、予定を見てから返しますと返すか」
流れ: 二つの返事を並べる → 後者にだけ確認する時間がある → そこから、引き受けることも断ることも選べる → 全部断る話ではない
気づく所: 比べた瞬間。断る言葉ではなく、間の取り方の違いだと分かる
材料: 揃っている。会話は聞き手にも仮定と分かる説明用の例

推奨: 1。本人の実際の出来事があり、週末の場面を、返事の時点で確認が抜けていたことで回収できるため。

「手元の仕事を振り返る問いかけ」の案は、本文が1と同じ順序になるため1にまとめた。
========== END FILE ==========

========== FILE: references/interview.md ==========
# 深掘り

## 内部で持つもの
- 項目: 主張 / 理由 / 場面または例 / 視聴者のつまずき / 誤解されたくない境界 / 結末の方向 / 声と尺。毎回表にして見せない。
- 各発言には次を添えて持つ。
  - 誰の話か
  - 一度の出来事か、続けている習慣か
  - 提案か、仮説か
  - 予定か、決まったことか、実施したことか、結果が出たことか。未決の項目は何か
  - どれくらい確かか
- 例: 「こう返してみたら？」は提案であって、「今はこう返している」ではない。

## 次の1問の選び方
- 具体的な言葉があっても、その意味や手順の中身が分かっていなければ材料不足。決め台詞の数・比較の基準・本人が挙げた理由の中身を、本人の答えから埋める。そこを一般知識で補ってから構成選択へ進めない。
- 答えによって原稿が最も変わる空きを1つ選ぶ。固定の順番は設けない。
- 何を聞くかの手がかり:
  - 抽象的な意見には、場面を聞く。
  - 具体的な場面には、本人がそう判断した理由を聞く。
  - 強い断言には、当てはまらない条件を聞く。
  - 結論のない感情（怖さ、もやもや）には、それが出た場面か、何がそうさせるのかを聞く。答えを急がせない。
- 直前の本人の言葉を使って聞く。決まった質問文は使い回さない。
- 質問文に入れる理由・因果・心情は、本人が言ったものだけにする。本人が判断（やめた、変えた等）だけを述べた時は、もっともらしい理由を推測して前提に置かず、何がきっかけでその判断に至ったか、その時の場面を聞く。
- 1問は承認ではなく、深さに使う。「○○でいい？」「この方向で進めていい？」で止めない。
- 本人が明言した結論・境界・訂正後の内容はそのまま採用し、同じ意味を確かめ直さない。
- 主張を先に決めて誘導しない。

## 状況別の対応

### 回答が薄い
直前の単語を拾い、具体的な場面を1つだけ聞く。

### 話が広い・テーマが複数
- 軸を1本仮に置き、「○○を中心に考えます」と一言だけ伝える。
- その軸で、まだ出ていない理由・場面・判断が分かれる所を聞く。
- 仮の軸が違えば、本人が訂正できる言い方にしておく。
- 外した話は台本に入れない。

### 「分からない」
- 1回目は、聞き方を変えて場面か理由を聞く。
- 2回続いたら、同じ記憶を探させない。方向の違う小さな仮の例か考えを2つ短く並べ、「どちらが近いですか。どちらでもなくて大丈夫です」と1問だけ聞く。
- 選ばれた仮の例は、本人の考えの手がかりにとどめる。本人の体験や主張として書かない。

### 矛盾・訂正・言い直し
- 最後に明言した内容を採用する。音声入力の言い直しや迷いの前段を、結論として扱わない。
- 意味が本当に二つに割れて原稿が変わる時だけ、2つを並べて1問で確認する。

### 事実と違うかもしれない
- 意見と事実を分けて扱う。
- 確認できない数字は使わない。「本人の実感」と言い換えて残すこともしない。

### 体験や実績がない
- 仮説や観察として書くことを本人と共有する。
- 成功例・数字・お客様の声を補わない。

### 疲れた・「もう書いて」「おまかせ」
- 質問を止める。
- 任された制作条件（尺、構成、言い回し）は仮に決めて進め、推奨の仮案か下書きを出して反応をもらう。
- 本人の体験や価値観の穴は作らない。分かっている主張を狭く使う。

## 構成へ進む目安
- 次が揃い、大きな矛盾がなければ進む。
  - 主張を本人の言葉で1文にできる
  - 理由がある
  - 場面か説明用の例がある
- 往復3〜6回は目安にすぎず、回数を埋めるために聞かない。
- 最初の説明や資料で揃っていれば、質問せずに構成へ進む。
========== END FILE ==========

========== FILE: references/knowledge.md ==========
# ナレッジの読み方

## 原則
- 渡されたファイルは、質問より先に読む。読めた資料から分かることは聞かない。
- 全部は読まない。索引があれば索引から、関係する所だけを読む。
- 読めなかった資料は、読んだと扱わない。中身も推測しない。
- 資料や体験談が渡されていないことから、利用者を「初心者」「詳しくない」「実践していない人」と決めない。材料の不足と利用者の能力は別に扱う。
- 決まった記入欄は使わない。代わりに、内部で次を区別して持つ。
  - 誰のものか（利用者本人、別の話し手、お客様、外部）
  - いつの時点か（今の考えか、過去の考えか）
  - 今回使う意思があるか
  - 意見か、事実か、提案か、体験か（体験なら、一度の出来事か続けている習慣か）
- AIが考えた理由・手順・内心は、利用者の材料にも事実にも数えない。
- 話し手が変わったら、前の人物の経歴・体験・口調を混ぜない。
- 外部の事実と利用者の価値観は、別の軸で扱う。どちらかが他方に勝つ順位は付けない。事実の部分は事実として確かめ、価値観は利用者のものとして書く。
- 旧メモ、過去の台本の条件、以前の口調指定が今回の依頼と違えば、今回の発言を優先する。

## 読む場所
- 読むのは、利用者が渡した資料と、利用者が指定した資料・索引・ナレッジの置き場所だけ。
- 指定のない場所を探し回らない。置き場所が分からず、読む価値がありそうな時だけ「参考にしたい原稿やメモはありますか」と1問で確認する。
- 索引が指定されていれば、索引から今回のテーマに関係する項目だけを開く。
- 口調や話し方の資料が複数ある時は、今回の話し手に合うものだけを使う。誰の言葉か資料から判別できず、制作に支障がある時だけ1問で確認する。
- 文章用の口調資料を使う時は、人称と語彙だけを借り、見出し構成や署名などの書式は持ち込まない。
- 商品やサービスに触れるのは、利用者の許可と実在の確認が取れたものだけ。利用者がその商品を台本に入れると指定していれば、その許可は満たされている。指示のない呼びかけ（CTA）は足さない。

## 持ち込まない条件
資料の中にある、別の用途向けの条件は、この台本に持ち込まない。次のような条件は、利用者が今回明示した場合だけ採用する。
- テーマを特定の分野に限定する
- 特定の層を対象から除外する
- 特定の窓口や登録先へ誘導する
- 字数を固定する
- 企画を大量に出す
- 逆張りを必須にする

## 資料が無い場合
会話の内容と、使えるツールで代わりにする。資料がなくても、深掘りの質問で補えば進められる。

## 外部の知識を足す時
- 足してよいのは、確認できた事実だけ。確認できない事実は、本文で断言しない。
- アクセスできないURLやページは、取得済みとして扱わない。中身を推測で埋めず、本文か文字起こしを渡してもらう。
- 外部の事実で、利用者の考えや価値観を書き換えない。

## 参照記録
- 制作メモに書くのは、利用者が確認すべき点がある時だけ。例: 「未参照: ○○.md（見つからず）」
- 参照した資料の一覧を毎回並べない。
========== END FILE ==========

========== FILE: references/quality.md ==========
# 品質チェック

## 合否（出す前に確認する）
- 主張を1行で言え、原稿全体がそれを支えている
- 結論が本人の最新の考えと一致し、意味の境界も変わっていない
- 誰の話か、一度か習慣か、提案か仮説か、予定・決定・実施・結果のどの段階か、が主張と本文でも元の発言と一致している
- 冒頭の疑問や場面が、本文で回収されている
- 本人が言っていない体験・数字・実績・特典・限定・描写がない
- 引用と指定されたセリフが原文のまま
- 声に出して読め、映像や字幕がなくても通じる。記号や括弧を読ませていない
- 人称と口調が、話し手の資料や話し方と揃っている
- 中身が痩せていない。空欄の理由、抽象語の連打、一般論の言い換えがない
- 出力の形が、利用者の最新の指定どおり
- 本文の後に「ここを変えればよくなる」という案が残っていれば、本文へ反映して再点検する。未反映の修正案を制作メモへ逃がさない。

## 両立しない条件
- 必須の条件を黙って捨てない。何と何が両立しないかを、1〜2文で伝える。
- 今すぐ稿を求められたら、何を優先した稿かを1行示し、具体的な稿を出す。後ろに複数案や長い解説を付けない。
- 満たせていないものを、完成や尺内と呼ばない。
- 「とにかく15秒」のように尺が最優先なら、伝える価値を1つに絞って書き直す。
- 手順が複数あっても、同じ一つの目的を支えているなら残してよい。条件の数を満たすための型にしない。

## 素材の照合
- 原資料と案を並べ、内訳・動作・時間の変化・好み・相手の気持ち・引用の各記述がどこから来たかを確かめる。「材料は揃った」と書かれた案でも照合する。
- 数字は、対象・時点・測った項目・母数と組で照合する。別の母数や時点で数えた数字を誤りと否定せず、今回使う数字をその条件付きで述べる。
- 内容を補った時や出所が曖昧な時は、利用できる別AIに原資料と案だけを見せる。書き手の構成意図や期待する判定を教えず、「何の話と理解したか、迷った箇所、原資料にない事実・手順・気持ち」を挙げてもらう。
- 指摘された箇所を原資料で確かめ、未提供のものを削る。説明の核なら、1問聞いてから作り直す。一般に正しそうなことでも、本人が述べた事実にはできない。
- 修正した案を一度照合し直す。まだ中身が決まらない場合は、仮の手順を完成稿として出さず、必要な1問へ戻る。別AIを実際に使っていない時は、独立した検品を済ませたと記録しない。

## 尺
- 書く前に最新の尺を字数の予算へ変える。間3秒・毎秒4〜6字なら:
  - 「○秒以内」: 上限は `(秒数−3)×4` 字。遅い側（毎秒4字＋間）でも収める。上限は狙う字数ではない。余裕を持って書く。
  - 「○秒前後」「くらい」: `(秒数−3)×5` 字を中央の目安にし、推定幅で示す。遅い端が少し超えるだけなら、そのために中身を削らない。
  - 英数字の読みは別に確認する。
- 書いた後に推定する。ツールが使える環境では、下の計測ツールで字数と読みを測って確かめる。「以内」で推定幅が上限をまたげば、わずかな超過でも合格・尺内と言わず、本文を書き直して再推定する。「早口なら入る」で通さない。
- ツールが無い時は、上限ぴったりを狙わない（扱いは下の「使えない時」）。
- 修正で条件を足した後も、前の尺指定は残る。「原稿だけ」は出力の形の指定で、検品を省く指定ではない。
- 撮影尺と原稿の字数は同じではない。尺は、読み上げの推定として扱う。
- 速度は、本人の実測があればそれを使う。無ければ毎秒4〜6字を暫定の目安にする。
- 出発点の目安: 30秒は約100〜150字、60秒は約220〜300字。
- 超えたら、前置き、重複、2つ目の例の順に削って書き直す。早口を前提に詰め込まない。
- 計測していない数字を、実測と書かない。

## 計測ツール
本文だけをUTF-8のファイルにして計測する。パスはスキルのフォルダが基点。
```sh
python3 scripts/measure_script.py 台本.txt --target-seconds 30 --max-chars 140
python3 scripts/measure_script.py 台本.txt --target-seconds 30 --reading-path 読み.txt
```

### 読みの指定
- 数字、英字、URLなど、表記と読みの長さが違う時は、発音どおりのテキストを `--reading-path` で渡す。
- 出力の項目:
  - `character_count`: 表記の字数
  - `spoken_character_count`: 読みの字数
  - `estimate_basis`: 尺の計算元。尺は読みから出す
- 読みを渡していない数字・英字・URLは `reading_cautions` に出る。計算上は収まっていても、判定は `needs_readthrough` になる。
- 読みが本文と同じ意味になっているかは、ツールでは分からない。書き手が点検する。

### 判定
- `fail`: 字数上限を超えた、または明らかに尺を超えた。削って再計測する。
- `needs_readthrough`: 推定の幅が希望尺をまたぐ、または読みに注意がある。「尺内」とは言わない。「以内」の指定で幅がまたぐなら、書き直して再計測する。
- `pass`: 仮定の速度なら、遅い側も収まる。録音して実測した合格とは別。
- `error`: 空の原稿や設定の誤り。直して再実行する。

### 設定
- 間の既定は全体で3秒。`--pause-seconds` で変えたら、その値を内部に記録する。
- 本人の実測が毎秒5字なら、`--min-cps 5 --max-cps 5` を指定する。

### 使えない時・出さない時
- `--reading-path` が無い版や、計測できない環境では、概算であることを明示する。正確な字数や合格を作らない。
- 「原稿だけ」と指定されたら、計測結果を出力に足さない。

## 出典と意見
- 本人の意見は、本人の意見として書いてよい。事実のように聞こえる数字や断定には、根拠が要る。
- 期限、価格、制度、医療、健康、金融、法律に関わる内容は、必要に応じて公式情報で確かめる。確認できない数値は使わない。
- 再生数や視聴維持率の向上は保証しない。「冒頭何秒で必ず」のような万能の数値も言わない。
- 外部の事実を使った時の出典は、制作側で記録する。本人が確認すべき場合だけ、制作メモに短く出す。

## 修正時
- 局所修正では指定外の文字列を保つ。主張・構成・口調を変える依頼では、その範囲の接続も整える。固定した引用や末尾は保持する。
- 変えた箇所に関わる項目と、主張の一致・尺を確かめ直す。
========== END FILE ==========

========== FILE: references/writing.md ==========
# 聞ける台本の書き方

## 離脱を防ぐもの
- 離脱を防ぐのは、煽りの数ではない。
- 冒頭で浮かんだ具体的な疑問に次の一文が答え、その答えが本人の理由へつながること。
- 一文ごとに「それで？」「なぜ？」が生まれ、次の文がそれに応える。この鎖でつなぐ。

## 流れの芯
- 主張を一般論で3回言い換えない。
- 選択された構成の順序を保ち、具体的な材料と、その材料から本人が考えた理由・結論をつなぐ。例えば場面から見えていなかった違いへ進む方法もあるが、全案をその順序に直さない。
- 一つの出来事を扱う時は、その前と後で本人の見方がどう変わったかを残す。

## フック
- 本人の材料から選ぶ。場面、本人の一言、意外な比較、よくある誤解など。
- 注目させるために、結論を強めたり、失敗を重くしたり、一度の体験を大きくしたりしない。

## 配分
- 説明、実話、価値観、小さな試し方、共感や余韻の割合は、目的に合わせて変える。固定の型は作らない。
- 余韻で終える指定がある話には、最後に「試してみてね」や問いかけを足さない。

## 耳で分かる文
- 1文は、口で話せる長さにする。前の文を受ける自然な接続でつなぐ。
- 「それ以来」「今は」「だから」でつなぐ前に、元の発言に時間の変化や因果があるかを見る。なければ使わない。
- 専門語は、耳で分かる語にする。初心者向けなら、先に読みやすい語へ直す。具体的に見せるためだけに、意味のない数字を足さない。
- 「重要」「本質」「大事」を中身なしで連打しない。何がどう効くのかという具体に置き換える。
- 同じ接続詞や決め台詞を、どのテーマにも付けない。

## 忠実さと書き手の考え
- 本人の引用は原文のまま使う。呼び方（先生など）や、色・音・匂いなど本人が話していない描写を足さない。
- 一度の出来事は、一度として語る。境界は「一度だけだけど」のような誇張しない1文で足りるなら、それで済ませる。「これも違う、あれも違う」と否定を並べない。
- 書き手が考えてよいのは、接続・たとえ・配置と、聞き手にも仮定と分かる説明用の会話や対照。本人が実際にやった事実としては書かない。
- 本人の新しい理由や好き嫌い、他者の内心（「相手は〜考えてしまうんですよね」など）、技術的な手順や適用条件、効果の因果や頻度は書かない。制作メモで「AIの提案」と断っても、本文で断言してよいことにはならない。本人の仮説は仮説のまま話す。
- 迷った箇所を、「理由」と書くだけのような空欄のまま出さない。本人の言葉の範囲で書き切り、足りなければ核の1点だけ聞く。

## 書いた後の3つの問い
- 一文ごとに、本当に次を聞きたくなるか
- なぜこの話し手が言うのか、が聞こえるか
- 例の意味から主張へ飛躍していないか。一例から「誰でも」「必ず」へ広げていないか

## 例
説明用のオリジナル例。どちらも、メモにない情報は足していない。

### 1 体験の話
メモA: 朝起きてすぐスマホを見るのを、一度やめた。その日は仕事の始まりが楽だった。通知を見ると、他人の用事から一日が始まる感じがして嫌だった。朝は自分の予定から始めたい。

台本B: 「朝いちばんにスマホを見るのを、一度だけやめてみました。その日は、仕事の始まりが楽だったんです。なんでだろうと考えたら、通知を開いた瞬間に、一日が他人の用事から始まっていたんですよね。まだ一度だけですけど、朝は自分の予定から始めたいなと思っています。」

- 「なぜ楽だった？」という疑問に次の文が答え、本人の理由へつながっている。
- 一度の体験を、習慣や効果に広げていない。

### 2 説明の話
メモA: 見積もりは安くしすぎない方がいい。大事なのは本質的な価値を伝えること。安く出した時、修正依頼が増えたことがある。安いと、どこまで頼んでいいかの線が相手に見えにくいのだと思う。

台本B: 「安く出した見積もりで、修正のお願いが増えたことがあります。値段が低いと、どこまで頼んでいいのか、相手からは線が見えにくいんだと思うんです。だから、安くしすぎない。値段も、この仕事でどこまで引き受けるかを伝えるものだと思っています。」

- 「本質的な価値」を、メモにある理由（どこまで頼めるかの線）で具体的な言葉に置き換えている。
========== END FILE ==========

========== FILE: scripts/measure_script.py ==========
#!/usr/bin/env python3
"""読み上げ本文の字数と仮定した速度による所要時間を検査する。"""

import argparse
import json
import math
from pathlib import Path
import re
import unicodedata


def emit(data):
    print(json.dumps(data, ensure_ascii=False, indent=2, allow_nan=False))


class JsonArgumentParser(argparse.ArgumentParser):
    def error(self, message):
        emit({"status": "error", "message": message})
        self.exit(2)


def positive_float(value):
    try:
        number = float(value)
    except ValueError:
        raise argparse.ArgumentTypeError("有限の正の数を指定してください")
    if not math.isfinite(number) or number <= 0:
        raise argparse.ArgumentTypeError("有限の正の数を指定してください")
    return number


def nonnegative_float(value):
    try:
        number = float(value)
    except ValueError:
        raise argparse.ArgumentTypeError("有限の0以上の数を指定してください")
    if not math.isfinite(number) or number < 0:
        raise argparse.ArgumentTypeError("有限の0以上の数を指定してください")
    return number


def positive_int(value):
    try:
        number = int(value)
    except ValueError:
        raise argparse.ArgumentTypeError("正の整数を指定してください")
    if number <= 0:
        raise argparse.ArgumentTypeError("正の整数を指定してください")
    return number


def character_count(text):
    return sum(not char.isspace() for char in text)


def reading_cautions(text, source):
    """読みが文字数より長くなる可能性だけを検出し、読み方は決めない。"""
    normalized = unicodedata.normalize("NFKC", text)
    url_pattern = r"(?:https?://|www\.)[^\s<>「」『』（）()]+"
    urls = re.findall(url_pattern, normalized, flags=re.IGNORECASE)
    remaining = re.sub(url_pattern, " ", normalized, flags=re.IGNORECASE)
    numbers = re.findall(r"[0-9]+(?:[,./:][0-9]+)*", remaining)
    latin = re.findall(r"[A-Za-z]{2,}", remaining)
    cautions = []
    for kind, matches, message in [
        ("url", urls, "URLは文字列の長さと読み上げ時間が一致しない場合があります"),
        ("number", numbers, "数字は位取り・単位・桁の読み方で長さが変わります"),
        ("latin_word", latin, "英字の語・略語は読み方で長さが変わります"),
    ]:
        if matches:
            # URLや原稿の断片自体は出力しない。
            cautions.append({"kind": kind, "count": len(matches),
                             "source": source, "message": message})
    return cautions


def main():
    parser = JsonArgumentParser(description=__doc__)
    parser.add_argument("path", type=Path, help="読み上げ本文だけを含むUTF-8ファイル")
    parser.add_argument("--reading-path", type=Path,
                        help="任意の読み方テキスト（UTF-8）。字数上限は元本文、秒数はこのテキストで見る")
    parser.add_argument("--target-seconds", type=positive_float)
    parser.add_argument("--max-chars", type=positive_int)
    parser.add_argument("--min-cps", type=positive_float, default=4.0,
                        help="遅い側の仮定速度（字/秒、既定4）")
    parser.add_argument("--max-cps", type=positive_float, default=6.0,
                        help="速い側の仮定速度（字/秒、既定6）")
    parser.add_argument("--pause-seconds", type=nonnegative_float, default=3.0,
                        help="本文全体に加える間の仮定秒数（既定3）")
    args = parser.parse_args()
    if args.min_cps > args.max_cps:
        parser.error("--min-cps は --max-cps 以下にしてください")
    try:
        script = args.path.read_text(encoding="utf-8")
    except (OSError, UnicodeError) as exc:
        parser.error("UTF-8の本文ファイルを読み込めません: " + type(exc).__name__)
    count = character_count(script)
    if count == 0:
        parser.error("本文が空です（Unicode空白を除いた字数が0）")

    reading = None
    spoken_count = None
    if args.reading_path is not None:
        try:
            reading = args.reading_path.read_text(encoding="utf-8")
        except (OSError, UnicodeError) as exc:
            parser.error("UTF-8の読み方ファイルを読み込めません: " + type(exc).__name__)
        spoken_count = character_count(reading)
        if spoken_count == 0:
            parser.error("読み方テキストが空です（Unicode空白を除いた字数が0）")
    estimate_basis = "reading_text" if reading is not None else "original_text"
    estimate_count = spoken_count if reading is not None else count
    cautions = reading_cautions(reading if reading is not None else script, estimate_basis)
    fastest = estimate_count / args.max_cps + args.pause_seconds
    slowest = estimate_count / args.min_cps + args.pause_seconds
    if not all(math.isfinite(value) for value in (fastest, slowest)):
        parser.error("推定秒数が計算可能な範囲を超えています。速度を見直してください")
    reasons = []
    if args.max_chars is not None and count > args.max_chars:
        reasons.append("字数上限を超えています")
    if args.target_seconds is not None and fastest > args.target_seconds:
        reasons.append("最速の仮定でも目標秒数を超えています")
    if reasons:
        status = "fail"
    elif args.target_seconds is not None and slowest <= args.target_seconds and not cautions:
        status = "pass"
        reasons.append("仮定した速度範囲では最遅でも目標秒数以内です")
    else:
        status = "needs_readthrough"
        if args.target_seconds is None:
            reasons.append("目標秒数未指定のため要音読")
        elif slowest > args.target_seconds:
            reasons.append("速度によって目標秒数を超えるため要音読")
        if cautions:
            reasons.append("数字・英字・URL等の読み方が未確定のため要音読")
    note = ("録音実測ではありません。速度と間に基づく推定であり、秒数確定には音読計測が必要です。"
            "本人の実測速度を使う場合は min-cps と max-cps に同じ値を指定してください。")
    if reading is not None:
        note += ("秒数は指定された読み方テキストの字数から推定しました。"
                 "spoken_character_countはその字数で、元本文との意味の一致は検証していません。")
    else:
        note += ("読み方テキストがないため元本文の字数で推定しています。"
                 "spoken_character_countは未指定です。数字・英字・URL等は読み方を確認してください。")
    emit({
        "status": status,
        "character_count": count,
        "spoken_character_count": spoken_count,
        "estimate_basis": estimate_basis,
        "reading_cautions": cautions,
        "counting_rule": "Unicode空白（str.isspace）を除くコードポイント数。句読点は含む",
        "target_seconds": args.target_seconds,
        "max_chars": args.max_chars,
        "estimated_seconds": {"fastest": fastest, "slowest": slowest},
        "assumptions": {"min_cps": args.min_cps, "max_cps": args.max_cps,
                        "pause_seconds": args.pause_seconds},
        "recording_measured": False,
        "duration_confirmed": False,
        "note": note,
        "reasons": reasons,
    })
    return 2 if status == "fail" else 0


if __name__ == "__main__":
    raise SystemExit(main())
========== END FILE ==========
