video-script

動画の台本と公開用素材

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）

ユーザーの希望する言語で、構成された口播稿を作成します。話し言葉として自然な台本にしてください。

• 出力形式のテンプレートは templates/script.md を参照してください
• 詳細な執筆ルールは references/script-guidelines.md を参照してください
• 教程／設定系の動画については、標準となるサンプル台本 references/examples-tutorial.md を参照してください。設定／操作方法／セットアップ動画の場合は、執筆前に必ず読んでください

ステップ 5：ブログ記事を作成する（blog.md）

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

• 出力形式のテンプレートは templates/blog.md を参照してください
• 詳細な執筆ルールは references/blog-guidelines.md を参照してください
• 重要：personal-writing-style スキルの規約に従ってください

ステップ 6：各プラットフォーム向けの説明文を作成する（youtube.md と bilibili.md）

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

• 出力形式のテンプレートは templates/youtube.md と templates/bilibili.md を参照してください
• プラットフォームごとのルールとガイドラインは references/platform-differences.md を参照してください

ステップ 7：X／Twitter 向けの宣伝文を作成する（x.md）

動画とあわせてユーザーが投稿できる、視聴につながる短い宣伝ツイートを作成します。要約ではなく、動画を見たくなるフックにしてください。

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

ステップ 8：事実確認（技術的事実の監査）

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

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

Step 9: personal-writing-style を適用する（統一スタイルの校正）

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

• personal-writing-style スキルを必ず呼び出し、生成したすべてのファイル（script.md、blog.md、youtube.md、bilibili.md、x.md）に適用します
• 口播稿も例外ではありません：script.md は「話す」ための原稿ですが、句読点とスタイルのルールを完全に適用します。中国語の湾曲引用符、半角ダッシュ「 - 」、ASCII 省略記号「......」、見出し番号なし、簡潔な見出しとし、全角または英語の句読点は残しません
• 口語調と自然な話し言葉の流れを維持します：personal-writing-style では句読点と語調を統一するだけにとどめ、定型的な構成を強制しません（script.md を Hook／導入／本文／CTA のような構成に変更しないでください）
• x.md には引き続き personal-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）。次回以降は、メモリーディレクトリにこのファイルがあるか確認し、直接読み込みます。再度尋ねる必要はありません。

例

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

重要なルール

1. 書く前に必ず尋ねる — 情報が不足している場合は必ず追加で質問し、ユーザーの意図を推測しないでください
2. 口語調のスクリプト — スクリプトは話すためのものであり、読むためのものではありません
3. タイムスタンプを追加しない — スクリプトの章見出しにも YouTube の説明文にも、推定タイムスタンプを追加しないでください。ペースは作者自身が決めます
4. 自動で公開しない — ファイルの生成のみ行い、公開操作は一切実行しません
5. ユーザーのスタイルを維持する — ユーザーが過去の動画のスタイルを参考として提示した場合は、できる限りそれに合わせます
6. プロモーション情報を再利用する — 初回に尋ねた後は自動メモリーに保存し、次回以降は自動で入力します
7. 日付ごとのディレクトリ — 各動画について、当日の日付で個別のディレクトリを作成します
8. 技術的な内容は公開前に確認する — 技術解説やレビューなど、技術的な事実を含む動画は、公開前に事実を項目ごとに確認する必要があります（Step 8 を参照）。公式の情報源がない点は削除するか、画面上に参照元を表示します。モデルの推測や幻覚を原稿に含めてはならず、記録として fact-check.md を作成します
9. 仕上げにスタイルを統一する — 生成した中国語の原稿（口播稿を含む）はすべて、仕上げの際に personal-writing-style を適用します。Step 9 を参照し、省略しないでください
10. 必要に応じてカバーを生成する — カバーはデフォルトでは作成せず、まずユーザーに確認します。サムネイルには cover-design、記事のヘッダー画像には cover-image を使用します（Step 10 を参照）