用途
video-script 用于把代码仓库、产品页面或更新内容转化为一份可直接录制的视频脚本。它采用“凭证优先”（receipts-first）格式：脚本中的每个数字、地址和日期都必须在本次运行中对照实时来源核实，而不是凭记忆写入。
主要能力
- 来源选择：支持三种输入形式。
repo:<owner/repo>生成关于该仓库最新更新波次的脚本（由 README 与近期发布/提交决定“更新”是什么）；<url>生成关于该产品页、文档或公告的脚本；<topic>（任何其他非空内容）生成关于该主题的脚本，并先做研究。若输入为空，则从最近 7 天的记忆/日志中挑选最值得成片的更新（已发布功能、版本发布、带凭证的里程碑）；若没有符合条件的，记录 VIDEO_SCRIPT_NO_SOURCE，不发送通知并干净退出。 - 时长控制：
--minutes N可出现在任意位置，指定目标时长（默认 4 分钟，约每分钟 150 个口语词）。 - 研究与核实：实时抓取来源（仓库使用 WebFetch / gh api，读取 README 与近期发布/提交），收集可验证的具体凭证（合约地址、实时仪表盘、版本号、金额、日期），无法核实的声明要么删除，要么变成“录制前核实”中的复选框。
- 角度选择：冷开场不是推销，而是最具体、可验证、令人意外的事实——展示而非声称（实时仪表盘、链上地址列表、终端）。检验标准：怀疑者能否在 30 秒内查证？可信度机制（不可篡改性、安全门、审计轨迹、可复现测试）通常比功能列表更值得展示。
- 脚本结构：包含头部信息块（项目名、工作标题、目标时长、框架、署名、一句话推介、版本与日期），以及带时间范围的章节。典型叙事弧线为：冷开场（凭证，无问候）→ 背景/问题（用一句通俗语言解释底层技术）→ 工作原理（机制，可信度故事优先）→ 新内容或演示 → 直白说明（限制，平实表达；每个脚本都有此节，这是特性而非让步）→ 结尾与行动号召（一个动作）。
- 附加清单：脚本后始终附有通俗术语表（术语 → 屏幕上使用的措辞，以及刻意删去的术语）、素材清单（需拍摄或构建的内容，标注哪些必须当天拍摄）、反套路检查表（语音规则及本视频特定注意事项）、录制前核实清单（每个易变事实的带日期复选框及复查位置）、凭证（已核实事实及其来源与核实日期；当视频涉及链上或事实性声明时必填）。
使用方式
调用时传入选择器与可选时长，例如：repo:aeonfun/aeon --minutes 6、https://example.com/launch、our new payments integration --minutes 3。
运行流程：读取 memory/MEMORY.md 与最近 7 天的 memory/logs/，避免重复已覆盖的故事；若存在 soul/ 目录，读取 soul/SOUL.md 与 soul/STYLE.md 进行语气校准（脚本是操作者与聪明朋友的对话；若 soul/ 为空，默认简洁、直接、第一人称）。随后解析输入为来源与时长，执行研究核实、寻找角度、撰写脚本，最后交付。
交付时把脚本写入 output/video-scripts/${today}-<slug>.md（先 mkdir -p，再用 shell 重定向），通过 ./notify -f /tmp/video-script-notify.md 发送通知（正文写在 /tmp/ 下，绝不写入 memory/ 或 output/），通知内容包括工作标题、时长、一句话角度、刻意省略的一项，以及基于运行环境构建的可点击脚本链接：SCRIPT_URL="${GITHUB_SERVER_URL:-https://github.com}/${GITHUB_REPOSITORY}/blob/main/output/video-scripts/<file>.md"。同时记录到 memory/logs/${today}.md 的 ### video-script 标题下：来源、角度、时长、输出路径及推迟到当天核实的声明。状态码：成功为 VIDEO_SCRIPT_OK，输入为空且日志无可成片内容时为 VIDEO_SCRIPT_NO_SOURCE。
适用场景
适合需要把仓库更新、产品发布或公告快速转化为录制脚本的场景，尤其强调事实可核实、语气平实、避免营销套话。
限制
- 只写脚本，不录制、剪辑或生成画面；素材清单是给人类（或其他技能）的待办列表。
- 核实仅限本次运行的新鲜度；易变事实仍须当天复查，这正是“录制前核实”一节的作用。
- 若来源为私有或无法访问，应说明并停止——基于无法核实声明的脚本违背该格式。
- 语音规则禁用词包括：“In this video”“Let's dive in”“game-changer”“insane”“mind-blowing”“revolutionary”“trustless”（应改为说明由什么机制保障）。数字保持保守，向下取整；事件与竞争对手是背景而非反派，平实表达，不嘲讽；安全/核实故事优先于功能列表；每个技术术语要么配一句通俗解释，要么删除；屏幕文字不得与旁白逐字相同；不得引用私有分支或内部账号，应指向上游/公开仓库。