---
name: video-manual-maker
description: 店舗・フランチャイズの業務マニュアル動画（接客・洗車・トラブル対応など）と、お客様向けの説明動画（約款・重要事項・使い方）を、AIで作るための材料一式をそろえるスキル。手書きメモ・既存の紙マニュアル・約款の原文を渡すだけで、動画の台本・撮影リスト・字幕ファイル（SRT）・アバター/スライド用の原稿・見終わった後の確認テストまで作ります。「動画マニュアル作って」「マニュアルを動画にしたい」「接客マニュアル」「洗車マニュアル」「トラブル対応マニュアル」「約款の説明動画」「研修動画の台本」「/video-manual-maker」「$video-manual-maker」で発動。Claude Code・Codex のどちらでも使えます。
---

# 動画マニュアル作成スキル（video-manual-maker）

## このスキルの考え方
- **AIが得意なのは「話す内容」**：台本・字幕・ナレーション・翻訳・確認テストはAIでほぼ自動で作れます。
- **AIが苦手なのは「手の動き」**：洗車の拭き方や鍵の受け渡しなど、実際の作業は今の動画生成AIでは正確に再現できません。ここは**スタッフがスマホで撮影**し、AIは編集・字幕・ナレーションを担当します。
- **約款は「言い換えない」**：約款の読み上げ部分は原文のまま使い、わかりやすい補足は「解説」と分けて表示します。最終確認は専門家（弁護士・行政書士）にお願いする前提です。

## 動画の4つの型（マニュアルの種類で自動的に選びます）
| 型 | 作り方 | 向いているマニュアル |
|---|---|---|
| A. アバター／スライド型 | 原稿をAIアバター（HeyGen・Google Vids など）かスライド＋AIナレーションで動画にする | 約款説明・接客の心構え・本部の方針・トラブル時の連絡手順 |
| B. 実写＋AI編集型 | スタッフがスマホで撮る → Vrew 等でAI字幕・ナレーション・カット | 洗車・車両チェック・鍵の受け渡し・清掃 |
| C. 組み合わせ型 | 冒頭と注意点はA、作業の場面はB | 接客の流れ・トラブル対応（傷の確認など） |
| D. イラスト＋ナレーション型 | 図解イラスト＋自然なAI音声＋字幕を手元で全自動生成（無料） | 約款説明・トラブル時の連絡手順・接客の流れ（アバター不要） |

## 手順

### 1. ヒアリング（足りない時だけ聞く）
次の5つがそろっていれば聞かずに進めます。
1. マニュアルの種類（接客／洗車／トラブル対応／約款／その他）
2. 見る人（新人スタッフ／加盟店オーナー／お客様）
3. 元になる材料（紙マニュアル・メモ・約款の原文・ベテランの話の文字起こし など）
4. 1本の長さの目安（スタッフ向け＝1本3分以内を推奨、お客様向け＝1本90秒以内を推奨）
5. 多言語化の有無（英語・中国語・韓国語 など）

### 2. 章立てを作る（1本＝1つの作業）
- 長い1本ではなく、**1本＝1つの作業／1つのテーマ**に分けます（例：洗車＝①準備 ②外装 ③内装 ④最終チェック）。
- 出力：`output/<マニュアル名>/00_章立て.md`（本数・各本のゴール・型A/B/C）

### 3. 台本を作る（1本ずつ）
`output/<マニュアル名>/<番号>_<タイトル>/台本.md` に、下の形で書きます。
```
## シーン1（0:00〜0:15）
- 画面：〇〇（撮影 or スライド or アバター）
- ナレーション：「〜です。」
- 画面の文字（テロップ）：〇〇
- 注意マーク：あり／なし
```
- 1シーン＝15秒前後、1文は40字以内。
- 「ここ間違えやすい」ポイントには注意マークを付けます。
- **約款の場合**：ナレーションは原文をそのまま引用し、`【原文】`と`【解説】`を必ず分けて書きます。補償・免責・NOC（ノンオペレーションチャージ）・事故時の連絡は**別々のシーン**にします。

### 4. 撮影リストを作る（型B・Cのみ）
`撮影リスト.md`：場面ごとに「どこで・何を・どの角度で・何秒」を表にします。スタッフがスマホを持ってこの表どおりに撮れば足りる粒度にします。
- 撮影のコツも添えます：横向き／手元はアップ／1場面ずつ止めて撮る／個人情報・ナンバープレート・お客様の顔は映さない。

### 5. 字幕ファイルを作る
`字幕.srt`（日本語）。多言語化する場合は `字幕_en.srt` などを追加します。約款の翻訳版は**必ず人がチェックしてから使う**と台本に明記します。

### 6. 動画にする（ツール別の原稿を出す）
- 型A：`アバター原稿.txt`（HeyGen / Google Vids にそのまま貼れる形。シーンごとに区切る）
- 型B：撮った動画を Vrew に読み込み、`字幕.srt` を当てる手順を `編集手順.md` に書きます。
- 型D：**イラスト＋ナレーション型（手元で全自動・無料）**。アバターを使わず、シーンごとの図解イラスト＋自然なAI音声＋字幕で動画にします。約款・トラブル対応・接客の流れに向きます（下の「全自動で動画にする」）。

#### 全自動で動画にする（任意・型D）
ユーザーが「動画まで作って」と言ったときだけ行います。**同梱のプログラム `tools/make_video.py` を使い、自分でプログラムを書き直さない**（毎回同じ品質にするため）。
必要な道具：Python 3・ffmpeg・Google Chrome（または Microsoft Edge）・edge-tts（`pip install edge-tts`）。無いものだけ1つずつ入れ方を案内します。
1. このスキルのフォルダの `tools/FORMAT.md` を読む（台本ファイルの書き方・使える型とアイコン）。見本は `tools/sample_script.json`。
2. **絵の作り方をユーザーに1回だけ聞く**（settings.md に決まっていれば聞かない）：
   - **A. 図形の絵（おすすめ・全自動）**：同梱の型とアイコンで描く。絵柄が毎回そろい、文字もくっきり。手間ゼロ
   - **B. 画像生成AIの絵**：ChatGPT・Gemini などで作った絵をはめ込む（`layout: "image"`）。本格的な見た目になるが、ユーザーが絵を1枚ずつ作って保存する手間がかかる。手順は `tools/FORMAT.md` の「画像生成AIの絵を使うとき」。プロンプトは `画像プロンプト.md` に書いて渡し、絵がそろう前でも枠だけの仮動画を作って見せてよい
   - A と B を混ぜてもよい（表紙やまとめは図形、作業の場面だけ画像 など）
3. 台本（台本.md）をもとに、`output/<マニュアル名>/<番号>_<タイトル>/script.json` を書く。
   - `style` は **会社で使うものは `business`**（顔なし・青系）。ユーザーが「かわいく」「ポップに」と言ったときだけ `pop`
   - 声は `ja-JP-NanamiNeural`（男性なら `ja-JP-KeitaNeural`）。英字・記号の読みは `read` に入れる（例：NOC→エヌオーシー）
   - 声の道具（edge-tts）は Edge の読み上げ機能を使う非公式の方法。試作・社内用はこれでよいが、**お客様向けに正式に使う・販売する動画**なら、同じ声が使える公式の Microsoft Azure AI Speech に切り替える案内をする
4. 動かす：`python3 <このスキルのフォルダ>/tools/make_video.py <script.json>`（Windows は `python`）
   - このスキルのフォルダ＝Claude Code は `~/.claude/skills/video-manual-maker`、Codex は `~/.codex/skills/video-manual-maker`（Windows は `%USERPROFILE%\.claude\…`／`%USERPROFILE%\.codex\…`）
5. できた `<名前>_確認用一覧.png` を**必ず画像で見て**、文字のはみ出し・字幕の改行・絵と内容が合っているかを確認する。直すときは script.json を直して作り直す。
6. 動画（mp4）と字幕（srt）の場所をユーザーに伝える。OS標準の読み上げ音声は使わない（ロボットっぽくなる）。
- 型Dの動画は、お店の実際の映像ではなく**説明用の図解動画**として使う前提です。

### 7. 見終わった後の確認テストを作る
`確認テスト.md`：3〜5問の選択式＋答え。
- スタッフ向け：研修の合格ラインに使えます。
- お客様向け（約款）：見終わった後に「要点を確認しました」のチェック欄＋サインをもらう紙／画面の文面も作ります。**動画は説明を補うもので、店頭での車両確認と書面の説明は残します。**

### 8. 仕上げチェック（毎回）
- [ ] 1本＝1テーマになっている
- [ ] 約款の原文と台本の【原文】部分が一字一句一致している
- [ ] お客様の個人情報・ナンバープレートが映る指示になっていない
- [ ] 店舗ごとに違う部分（営業時間・連絡先・料金）は `{店舗名}` などの差し込み欄にしてある（フランチャイズの全店で使い回すため）
- [ ] 専門家に確認してもらう箇所に印を付けた

### 9. 業務マニュアルサイトにまとめる（任意）
動画が何本かできたら、**全業務がまとまったマニュアルサイト**（ブラウザで開けるページ）にまとめると、スタッフが「困ったことから探せる」ようになります。ユーザーが希望したときだけ作ります。
- 形：1つの `index.html`＋中身のデータ `data.js`＋`videos/` フォルダ。カテゴリ別の目次（受付・返却・清掃・接客・トラブル対応・約款・店舗運営・新人向け など）／キーワード検索／スマホ対応／各ページ＝要点・動画・写真の枠・手順・注意
- 動画にした項目は動画を埋め込み、手の動きの作業は写真の枠、それ以外は文章でOK（全部を動画にしなくていい）
- デザインは企業向けの落ち着いたもの（紺×白などのコーポレート系、絵文字は使わない）。迷ったら案を複数作って切り替えて選んでもらう
- **社外秘の手順・約款を載せるなら、関係者だけが見られる場所に置く**（社内のGoogleサイト・Notion、またはログインが必要な公開設定）。誰でも見られるURLには一般的な内容しか載せない
- 見本：https://rental-manual-sample.pages.dev/ （レンタカー店の例・中身は一般例）

## 育て方（使うほど自分の会社専用になります）
このスキルのフォルダにある `settings.md` に会社のルールを書き足していきます（作業を始める前に必ず読む）。例：
- 口調（「〜してください」で統一 など）
- 必ず入れる決まり文句（「ご不明な点はスタッフまで」など）
- NGワード・言い換えルール
- 動画の長さの上限、ブランドカラー

## できないこと（先にお伝えしておきます）
- 実際の作業映像をAIだけで正確に作ること（手の動き・道具・車の状態）
- 約款の法的な正しさの保証（専門家の確認が必要です）
- アバターに実在の人物（社長・スタッフ）を使う場合の同意取得