tech-report-voicevoxlisted
Install: claude install-skill yumeiriowl/tech-report-voicevox
# tech-report-voicevox — 解説レポートHTML + 対話台本md + VOICEVOX音声
対象の技術・記事・論文を、次の3点セットで出力する。
1. **レポートHTML** — 前提知識の薄い人が上から順に読めば理解できる単一HTML
2. **台本md** — 解説役と初級者役がレポートを上から順に解説していく対話台本
3. **音声WAV** — 台本を VOICEVOX で読み上げた通し音声1本
解説役と初級者役は依頼者が VOICEVOX のキャラから指定できる。無指定なら解説役は冥鳴ひまり、初級者役はずんだもん。
> 詳細仕様は `reference/` に分割してある。手順の該当箇所で必要になった時点で読むこと。
| 参照ファイル | 内容 | 読むタイミング |
|---|---|---|
| `reference/html-layout.md` | レポートHTMLの構成・CSS・インラインSVG図 | レポートを作る時(手順3) |
| `reference/characters.md` | 解説役プロファイルの作り方・話者名の対応表・人称表(一人称/二人称/呼び合い)・ずんだもんの設定・掛け合いの型 | 解説役を決める時(手順1)と台本を書く前(手順4) |
| `reference/script-writing.md` | 台本mdの書式と、読み上げ向け日本語の書き方(「は」の読み・小休止・文の長さ) | 台本を書く時(手順4) |
| `reference/engine-setup.md` | VOICEVOX ENGINE の導入・起動・停止 | エンジンが未導入・未起動��時(手順5) |
| スクリプト | 用途 |
|---|---|
| `scripts/tts.py` | 台本mdの読み・クレジット検査(`--check`)と、通しWAVの合成 |
## 引数
- **対象**(必須): 技術名・URL・論文PDF・ソースコード・既存のHTML資料など。既にHTMLレポートが提示された場合はそれを手順3の成果物として扱い、新規生成しない
- **解説役**(任意): VOICEVOX のキャラ名。省略時は冥鳴ひまり。指定できるキャラと表記は `reference/characters.md` の3章の対応表にある
- **初級者役**(任意): 省略時はずんだもん
- **出力先ディレクトリ**(任意): 省略時はカレントディレクトリ
出力ファイル名は対象から作った英小文字ケバブケースのスラッグ `<slug>` を使う:
```
<slug>-report.html レポート
<slug>-script.md 台本
<slug>-voice.wav 通し音声(1本)
```
## 実行手順
1. **入力を確定する。** 対象が何か、既存HTMLがあるか、出力先はどこかを決める。対象がURL・論文・コードなら中身を読む。技術名だけを渡された場合は、Web検索・ページ取得の手段があれば一次情報(公式ドキュメント・論文・リポジトリ)を調べる。手段が無ければ確認できた範囲だけ書く。
**同時に話者を確定する。** 既定(冥鳴ひまり×ずんだもん)以外が指定された場合は、`reference/characters.md` の1章に従ってプロファイル表を埋め、3章の対応表で `話者名/スタイル名` を、3章の人称表で一人称・二人称・互い