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）

为每个平台分别生成发布素材。两个平台的核心内容相同，但结构和宣传内容的位置有所不同。

• 查看 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
• 结论分三档：✅ 成立（有官方来源，可直接讲）/ ⚠️ 需在屏幕上引用（非官方来源，保留但录制时需在屏幕上展示可见证据）/ ❌ 删除（没有来源或属于推断，从脚本和博客中移除）
• 绝不让模型的猜测/幻觉进入稿件：没有来源支持的推断一律删除，或改为「官方未披露，不做猜测」
• 闭源/research preview 内容：脚本中必须包含披露句（「研究预览，部分细节未公开」）和边界句（「不猜测未披露的实现」）；启用机制（环境变量/命令/菜单）须对照当前官方文档核实；有争议的数字默认采用官方数据
• 产物：将核验结果写入视频目录中的 fact-check.md，以便复核追溯。格式见 templates/fact-check.md

Step 9: Apply personal-writing-style (统一风格校对)

After every file is written and fact-audited, run a dedicated polish pass over all generated Chinese text files. This is a required finishing step, not optional.

• Invoke the personal-writing-style skill and apply it to every generated file: 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 为准（链接位置、bullet vs prose、语气）

Step 10: Generate Cover (封面，可选)

封面不是默认产物 - 先问用户要不要做封面，需要时再生成。

询问：

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

• 缩略图类需求 → 调用 cover-design skill
• 文章头图类需求 → 调用 cover-image skill
• 产物存进视频目录（如 cover.html / cover.png）

Step 11: Review & Iterate

完成后提示用户：

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

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

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

Personal Promotion Info

Users should configure their promotion block. On first use, ask the user for their promotion links and save to auto memory for cross-session persistence.

When asking:

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

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

Save to auto memory directory as video-promo.md (e.g. ~/.claude/projects/.../memory/video-promo.md). On subsequent uses, check if this file exists in the memory directory and read it directly — no need to ask again.

Examples

See references/examples.md for detailed examples of different usage scenarios.

Critical Rules

1. 先问后写 — 信息不足时必须追问，不要猜测用户意图
2. 口语化脚本 — 脚本是用来说的，不是用来读的
3. 不要加时间戳 — 脚本章节标题和 YouTube 描述里都不要估算时间戳，节奏由作者自己掌控
4. 不要自动发布 — 只生成文件，不执行任何发布操作
5. 保留用户风格 — 如果用户提供了之前的视频风格参考，尽量保持一致
6. 推广信息复用 — 首次询问后保存到 auto memory，后续自动填充
7. 日期目录 — 每期视频按当天日期创建独立目录
8. 技术内容先审后发 — 技术解读/评测等含技术事实的视频，发布前必须逐条事实审核（见 Step 8），无官方来源的点要么删、要么屏上给可见引用，绝不让模型的猜测/幻觉进稿，并出 fact-check.md 留档
9. 统一风格收尾 — 所有生成的中文文稿（含口播稿）在收尾时必须用 personal-writing-style 过一遍，见 Step 9，不可跳过
10. 封面按需生成 — 封面不是默认产物，先问用户；缩略图用 cover-design，文章头图用 cover-image（见 Step 10）