video-planner

動画プランニング＆公開用素材

YouTuber／UP主が動画コンテンツを準備できるよう支援します。構成のある台本（口播稿）、ブログ記事、プラットフォームごとの公開用素材、X（Twitter）の宣伝ポストを作成します。

出力構成

各動画について、ユーザーが選択した場所の下に日付ベースのディレクトリを作成します。

./videos/{YYYY-MM-DD}-{short-slug}/
├── script.md       # 视频口播稿
├── blog.md         # 博客文章
├── youtube.md      # YouTube 发布素材
├── bilibili.md     # Bilibili 发布素材
├── x.md            # X (Twitter) 推广文案
├── fact-check.md   # 技术事实审核表（技术类视频必出，见 Step 8）
└── cover.png       # 封面（可选，见 Step 10）

対話型ワークフロー

ステップ 1：情報を集める

重要：何かを書く前に、ユーザーから十分な背景情報を集めます。次のことをユーザーに尋ねます。

请提供以下信息，帮我为你准备视频内容：

1. **视频主题**：这期视频讲什么？（必填）
2. **目标平台**：YouTube / Bilibili / 两者都有？（默认：两者）
3. **目标时长**：大约几分钟？（默认：10分钟）
4. **目标观众**：面向什么人群？（如：开发者、AI爱好者、初学者）
5. **关键要点**：你希望视频覆盖哪些要点？（可以是大纲、笔记、或链接）
6. **相关资料**：有没有参考文章、文档、代码仓库？（可选，我可以帮你研究）
已有部分信息的话，直接告诉我就好，缺的我会追问。

ユーザーが最初に一部の情報を提供している場合は、不足している項目だけを尋ねます。

ステップ 2：調査する（必要な場合）

ユーザーが参考 URL、ドキュメント、リポジトリを提供した場合：

• WebFetch を使って参考記事やドキュメントを読みます
• Read/Grep/Glob を使ってコードリポジトリを調べます
• WebSearch を使って補足情報を探します
• 台本で使う要点をまとめます

特定の技術やツールがテーマの場合：

• その中核機能とセールスポイントを調べます
• 解決できる一般的な課題を見つけます
• 代替手段との比較の切り口を探します

ステップ 3：ディレクトリを作成する

日付ベースのディレクトリを作成します。

./videos/{YYYY-MM-DD}-{short-slug}/

例：./videos/2026-03-07-react-server-components/

short-slug は、テーマから作成した、短く説明的な kebab-case のラベルにします。

ステップ 4：台本を書く（script.md）

ユーザーが希望する言語で、構成のある口播稿を書きます。台本は録画中にユーザーが声に出して読むものなので、内容と同じくらい次の 2 点が重要です。

• 読み上げやすさを優先：一文一文を「すらすら声に出して読める」言葉にします。書き言葉に寄りすぎたり、技術文書のように聞こえたりする文は、録画のペースを落とします。書き終えたら見直し、長い修飾語、専門用語の羅列、入れ子になった節を短い口語表現に直します（詳しくは references/script-guidelines.md の「読み上げやすさを優先」のルールを参照）。
• 画面表示の提案：AI として、各段落に最適な画面を個別に判断します。特定のウェブページの一部、アプリやターミナルの画面、コード、比較カードや早見表などを判断し、（画面：……） の注記として記載します。目的は、ユーザーが台本を読み上げながら、画面に何を表示すればよいかすぐに把握できるようにすることです。台本の冒頭に「画面表示の基本方針」の総覧表（画面の出どころ＋各段落への対応）を追加し、本文の各段落にはインラインの （画面：……） 注記で具体的な内容を示します。すべての段落で画面を切り替える必要はありません。「切り替える必要があるかどうか」の判断も作業の一部です。音声のみの段落には「音声のみ」と記載します。

参考資料：

• templates/script.md — 出力形式のテンプレート（「画面表示の基本方針」表とインラインの画面注記を含む）
• references/script-guidelines.md — 詳しい執筆ルール（「読み上げやすさを優先」「画面表示の提案」の 2 項目を含む）
• references/examples-tutorial.md — チュートリアル／設定系の標準サンプル。設定／how-to／セットアップ系の動画を書く前に必ず読みます

ステップ 5：ブログ記事を書く（blog.md）

動画の内容をブログ記事に再構成し、コンテンツを最大限に活用します。ブログ記事は文字起こしではなく、単独の記事として自然に読めるものにします。

• 出力形式のテンプレートは templates/blog.md を参照します
• 詳しい執筆ルールは references/blog-guidelines.md を参照します
• 重要：personal-chinese-writing-style スキルの規則に従います

ステップ 6：プラットフォームごとの説明文を書く（youtube.md & bilibili.md）

プラットフォームごとに個別の公開用素材を作成します。2 つのプラットフォームで中心となる内容は共通ですが、構成と宣伝の配置は異なります。

• 出力形式のテンプレートは templates/youtube.md と templates/bilibili.md を参照します
• プラットフォーム固有のルールとガイドラインは references/platform-differences.md を参照します
• YouTube のチャプター：YouTube の説明文には章のタイムスタンプを記載します（00:00 から開始し、台本の構成をもとに見積もります）。一覧の上には免責文「タイムスタンプは台本の構成に基づく推定値です。編集完了後、実際の長さに合わせて調整してください」を記載します。Bilibili の説明文には章を記載しません。
• 参考資料ブロック：動画に外部リンク（repo／公式サイト／ドキュメント）が含まれる場合、YouTube の説明文の末尾に「参考資料」ブロックを追加し、リンクと、再利用しやすいよう表紙のソースファイルのパス（cover.html / cover.png）を記載します。

ステップ 7：X/Twitter の宣伝ポストを書く（x.md）

動画への誘導を目的とした、短い宣伝ポストを作成します。要約ではなく、動画を見たくなるようなフックを盛り込みます。

• 出力形式のテンプレートは templates/x.md を参照します
• 重要：personal-chinese-writing-style スキルの references/social-media-style.md のルール（リンクの位置、箇条書きと文章の使い分け、トーン）に従います
• [動画リンク] はプレースホルダーのままにし、公開時にユーザーが実際の URL を入力します

Step 8: 事実確認（技術的事実の監査）

技術解説／レビュー／技術的な事実を含む動画では必須です。省略できません。 スタイル校正の前に、まず内容を確認してください。監査の結果、段落単位で削除・修正が必要になる場合があるためです。

• 項目ごとに確認：script.md と blog.md に含まれる技術的な記述をすべて列挙し、出典と確認結果を記載します。ルールと出典のランク分けについては references/fact-audit.md を参照してください。
• 判定は3段階：✅ 正しい（公式の出典があり、そのまま説明できます）／⚠️ 画面上で出典を提示（非公式の出典。記述は残しますが、録画時に画面上で確認可能な根拠を提示します）／❌ 削除（出典がない、または推測にあたるため、スクリプトとブログから削除します）
• モデルの推測や幻覚を原稿に入れないでください：出典に裏付けられていない推測はすべて削除するか、「公式には公開されていないため、推測しません」と変更します。
• クローズドソース／research preview の内容：スクリプトに開示文（「研究プレビューで、一部の詳細は公開されていません」）と境界を示す文（「公開されていない実装については推測しません」）を含めてください。有効化の方法（環境変数／コマンド／メニュー）は、現行の公式ドキュメントと照合してください。数値に異論がある場合は、原則として公式の数値を採用します。
• 成果物：確認結果を fact-check.md にまとめ、動画のディレクトリに保存します。後から確認できるようにするためです。形式については templates/fact-check.md を参照してください。

Step 9: personal-chinese-writing-style を適用（スタイルの統一）

すべてのファイルを書き終え、事実確認を済ませた後、生成したすべての中国語テキストファイルを専用の校正工程にかけます。これは必須の仕上げ作業であり、省略できません。

• personal-chinese-writing-style スキルを呼び出し、生成したすべてのファイルに適用します：script.md、blog.md、youtube.md、bilibili.md、x.md
• 口頭用スクリプトも例外ではありません：script.md は読み上げるためのものですが、句読点とスタイルのルールを完全に適用してください。中国語の曲線引用符、半角ダッシュ " - "、ASCII の省略記号 "......"、見出し番号を付けないこと、簡潔な見出し、全角および英語の句読点を残さないこと。
• 「声に出して読む」確認を追加で行います（口頭用スクリプト専用。standalone-style とは別です）：句読点が統一されていても、読みやすいとは限りません。script.md をもう一度確認し、すべての文が自然に読めることを確かめてください。堅苦しすぎる文や技術文書のような文（長い修飾語、用語の羅列、入れ子になった節、受動態）は短く口語的な文に直します。頭の中で一度読み上げて、つかえるところがあれば修正してください。判断基準については references/script-guidelines.md の「声に出して読みやすい」を参照してください。（画面：……） の画面メモは残し、スタイル校正で削除しないでください。
• 口語的で自然な流れを保ちます：personal-chinese-writing-style が行うのは句読点と語調の統一のみです。定型的な構成を無理に当てはめないでください（script.md を Hook／導入／本文／CTA のような定型構成に変更しないでください）。
• x.md には引き続き personal-chinese-writing-style の references/social-media-style.md を適用します（リンクの位置、箇条書きと文章の使い分け、語調）。

Step 10: カバー画像を生成（任意）

カバー画像は標準の成果物ではありません。まずユーザーにカバー画像を作成するか確認し、必要な場合にのみ生成してください。

質問：

要不要顺手做一张封面？
- 视频缩略图（YouTube / Bilibili）→ 我用 `cover-design`（代码驱动的排版封面，文字清晰、适合缩略图）
- 文章头图（博客 / X Article）→ 我用 `cover-image`（AI 生成的插画风头图）

• サムネイルの依頼 → cover-design スキルを呼び出します
• 記事のヘッダー画像の依頼 → cover-image スキルを呼び出します
• 成果物は動画のディレクトリに保存します（例：cover.html ／ cover.png）

Step 11: レビューと反復

完了後、ユーザーに次のように伝えます：

视频脚本和配套内容已准备好：

📂 {目录路径}/
├── script.md      — 口播稿（约 X 分钟）
├── blog.md        — 博客文章
├── youtube.md     — YouTube 发布素材
├── bilibili.md    — Bilibili 发布素材
├── x.md           — X (Twitter) 推广文案
├── fact-check.md  — 技术事实审核表（技术类视频）
└── cover.png      — 封面（如已生成）

请检查内容，如果需要调整，告诉我：
- 需要修改哪个部分？
- 风格/语气需要调整吗？
- 有要补充的要点吗？

個人プロモーション情報

ユーザーにはプロモーション欄を設定してもらいます。初回利用時にプロモーション用リンクを尋ね、セッションをまたいで保持できるよう自動メモリに保存します。

尋ねる際は：

我注意到这是你第一次使用视频策划 skill。请提供你的个人推广信息，我会记住以便后续使用：

- 社交媒体链接（Twitter、Bilibili、YouTube 等）
- 知识星球/社群链接
- 联系方式
- 其他固定推广信息（如课程链接、赞助信息等）

自動メモリのディレクトリに video-promo.md として保存します（例：~/.claude/projects/.../memory/video-promo.md）。2回目以降は、このファイルがメモリのディレクトリに存在するか確認し、直接読み込みます。再度尋ねる必要はありません。

例

さまざまな利用シナリオの詳細な例については references/examples.md を参照してください。

重要なルール

1. 書く前に尋ねる — 情報が不足している場合は必ず質問し、ユーザーの意図を推測しないでください
2. 声に出して読みやすくする — 口頭用スクリプトは作者が読み上げるものです。すべての文が自然に読めるようにしてください。堅苦しすぎる文や技術文書のような文は、短く口語的な文に必ず修正してください（Step 4、Step 9、および references/script-guidelines.md の「声に出して読みやすい」を参照）
3. 画面に表示する内容を提案する — 口頭用スクリプトの各段落に合わせる画面（ウェブページの該当箇所／アプリ／ターミナル／コード／比較カード）を判断し、インラインの （画面：……） メモとして記載します。また、スクリプトの冒頭に「画面表示の総則」の一覧表を付けます。口頭のみの段落には「口頭のみ」と記載します（Step 4 を参照）
4. スクリプトにタイムスタンプを付けない。章立ては YouTube の説明欄のみ — script.md の章見出しにタイムスタンプを付けません（録画時の進行は作者が調整します）。YouTube の説明欄には推定の章タイムスタンプを記載します（00:00 から開始）。一覧の上に免責事項を加えてください（編集後に実際の長さに合わせて調整します）。Bilibili の説明欄には章を記載しません
5. 自動公開しない — ファイルを生成するだけにし、公開操作は実行しないでください
6. ユーザーのスタイルを保つ — ユーザーから過去の動画のスタイル見本が提供された場合は、できるだけそれに合わせてください
7. プロモーション情報を再利用する — 初回に尋ねた後、自動メモリに保存し、以降は自動入力します
8. 日付ごとのディレクトリ — 各動画について、当日の日付で個別のディレクトリを作成します
9. 技術的な内容は確認してから公開する — 技術解説／レビューなど、技術的な事実を含む動画は、公開前に項目ごとの事実確認が必須です（Step 8 を参照）。公式の出典がない項目は削除するか、画面上で確認可能な出典を提示してください。モデルの推測や幻覚を原稿に入れないでください。記録として fact-check.md を作成します
10. 仕上げにスタイルを統一する — 生成したすべての中国語原稿（口頭用スクリプトを含む）は、仕上げに personal-chinese-writing-style を適用する必要があります。Step 9 を参照してください。省略できません
11. カバー画像は必要に応じて生成する — カバー画像は標準の成果物ではありません。まずユーザーに確認してください。サムネイルには cover-design、記事のヘッダー画像には cover-image を使用します（Step 10 を参照）