pr-to-video 是一个面向 GitHub Pull Request 的技能,目标是把一项代码变更做成可观看的讲解视频。输入是一个 PR 引用(完整 URL、owner/repo#N 形式,或已检出仓库中的 "this PR"),而不是网站,因此流程中没有网页抓取步骤。
主要能力:
- 读取 PR 信息:通过 gh 获取 PR 事实,分页补全文件列表,并写入 capture/pr.json 与 capture/diff.patch;对已合并的 PR 还会尽力解析发布的版本号。
- 整理素材:离线转换成 tokens.json、visible-text.txt、people.json,并尽力下载贡献者头像到 assets/<login>.png。
- 视觉风格:固定采用 code-editorial(偏编辑设计、适合代码 diff 的深色代码界面)预设,由脚本生成 frame.md 与字幕皮肤。
- 故事板与脚本:挑选一种 PR 叙事类型(更新日志、功能展示、修复讲解、重构讲解),编写 STORYBOARD.md,需要旁白时编写 SCRIPT.md,并嵌入真实 diff 片段。
- 音频:按脚本生成旁白、词级时间戳、BGM 与音频元数据,支持 HeyGen 或离线 Kokoro 等提供方;也可完全静音。
- 帧构建与渲染:按故事板逐帧生成 compositions/frames/NN-*.html 与 index.html,最终渲染 renders/video.mp4。
使用方式:在 HyperFrames 技能环境中运行。先解析项目目录并执行 preflight,然后用 init 初始化项目、写 BRIEF.md,显示登录状态;接着依次执行抓取、设计系统、故事板与脚本、音频、帧视觉设计、最终渲染。脚本均以 node 调用,例如 fetch-pr.mjs、ingest.mjs、build-frame.mjs、audio.mjs。步骤 0、3、6 为用户确认关卡;自主模式下则发布摘要后继续。
适用场景:需要向团队或受众解释某个 PR 变更的内容、动机与影响,制作更新日志或功能发布视频、修复或重构讲解视频时使用。
限制与注意事项:仅处理 GitHub PR 类代码变更;gh 认证、私有仓库或不存在等错误会直接退出,不得伪造 PR 内容;视频风格固定为 code-editorial,不询问其他风格;默认不在调用仓库中创建视频文件;旁白未指定时使用管道默认声音(HeyGen 上为 Marcia,Kokoro 上为 am_michael),需显式传 --voice 才能改变;音频依赖凭证,离线时能力受限。