代码变更讲解视频助手

代码变更讲解视频助手

这个 Skill 能做什么

把 GitHub Pull Request 或本地代码差异制作成面向开发者的变更讲解视频。

完成任务时重点处理：

• Diff、提交和文件变化的准确读取
• 用户影响、技术机制和关键代码证据
• 代码可读性、旁白与场景节奏

最终目标不是堆出一份看似完整的内容，而是交付能够直接使用、继续修改并清楚验收的结果。

什么时候使用

• 需要用视频说明新功能、修复、重构或重要代码审查内容。
• 用户需要把 GitHub Pull Request 或本地代码差异制作成面向开发者的变更讲解视频。
• 任务需要同时控制Diff、提交和文件变化的准确读取、用户影响、技术机制和关键代码证据。

如果无法访问 PR 时请求 Diff 或本地仓库，不根据标题猜测实现，先处理前置条件，不要直接假装任务已经完成。

开始前需要什么

优先收集：

1. 视频目标、受众与核心信息
2. 时长、比例、帧率和发布位置
3. 脚本、音频、图片、视频和品牌素材
4. 旁白、字幕、音乐、授权与截止时间要求
5. PR URL、仓库与访问权限
6. 目标观众、时长和重点关注的文件或行为

信息不必一次问完。先检查用户已经提供的材料，只追问会明显改变结果的问题。

执行步骤

1. 获取完整变更

读取 PR 元数据、提交、文件列表、Diff 和讨论。

2. 理解变更目的

结合代码与测试区分新功能、修复、重构和迁移。

3. 选择讲述证据

只展示能解释机制、前后差异和用户影响的代码。

4. 编写视频脚本

按问题、变化、实现、验证和影响组织。

5. 制作代码场景

确保字号、行宽、高亮和滚动适合视频。

6. 事实验收

对照 PR、测试和最终文件复核每个技术说法。

输出格式

至少交付以下内容：

• 变更摘要：目的、范围、关键文件、测试和风险
• 脚本与分镜：旁白、代码片段、画面和时长
• 讲解视频：适合团队同步或发布的最终文件

所有文件使用能说明内容和版本的名称。若任务包含执行动作，还要记录执行状态、验证结果和可继续处理的材料。

完整示例

一个 PR 修复缓存失效问题；视频先展示错误行为，再解释缓存键变化和新增测试，最后说明影响范围。

合理处理顺序：

1. 获取完整变更
2. 理解变更目的
3. 选择讲述证据
4. 编写视频脚本
5. 制作代码场景
6. 事实验收

交付时应重点展示变更摘要、脚本与分镜、讲解视频，并说明尚未验证的部分。

质量检查清单

• [ ] 开场快速建立观看理由，叙事有明确收束
• [ ] 字幕在目标尺寸下可读，声音层级清楚
• [ ] 画面、旁白、节奏和关键动作同步
• [ ] 完整播放无黑帧、跳帧、截断和导出错误
• [ ] 所有代码与结论来自目标 PR 的实际版本
• [ ] 屏幕代码在正常播放速度下可以阅读

信息不足时怎么处理

• 素材不足时先完成可验证的分镜和风格样片。
• 环境不能渲染时交付工具无关的时间线、资产清单和制作说明。
• 无法访问 PR 时请求 Diff 或本地仓库，不根据标题猜测实现。