Project To Video — AI skill for Claude Code

project-to-video

把项目主线做成一个动画，帮助你快速理解。

你有没有把一个项目写进简历，却在面试前不太敢让面试官继续追问？几个月后重新打开仓库，入口在这里，状态在另一个包，事件又绕到第三个模块。花了一晚上拼回调用链，第二天仍然担心一句“为什么这样设计？”就把整段讲解打乱。

代码和文档往往只给出局部线索。真正耗时的是把入口、模块、状态、数据流和设计取舍重新连成一张图。

`project-to-video` 帮你完成这件事。它从 README、源码和测试中梳理核心链路，用 Remotion 做成一段连续动画：先看全景，再跟着真实任务进入局部，看到对象怎样移动、等待、分支和恢复。看完后，你能沿着同一条主线讲清项目如何运行，再回到笔记和源码查原因与细节。它适合面试前快速回顾，也适合接手或研究陌生项目。

[先看效果](#先看效果) · [快速开始](#快速开始) · [可复用组件](references/visual-components.md) · [Remotion 模板](assets/remotion-template/README.md)

---

先看效果

下面的预览来自 Skill 自带的通用演示工程。

预览	展示什么
递进因果	步骤、决策分支和上下文变化如何逐步出现
组合场景	多实例选择、全景进入局部、并行推进与汇合
视觉组件	Agent、存储、终端、模型、工具，以及等待恢复和循环
逐层聚焦	从系统全景进入子流程时，怎样保留当前位置

如果当前页面不直接显示播放器，点击表格中的视频文件即可播放。

你可能正需要它，如果

• 简历上有项目，却只能讲功能，讲不清一次请求怎样穿过系统；
• 代码和文档都能找到，但读完之后仍然没有一张整体地图；
• 面试前需要快速找回状态、数据流和设计取舍；
• 接手一个新项目，需要先理解主线，再决定哪些细节值得深入。

它会帮你看清什么

动画把代码里分散的关系放回同一条时间线上：

• 一个请求或任务从哪里进入，经过哪些边界，最后把结果交给谁；
• 哪个对象持有状态，什么时候等待，什么事件让它继续；
• 哪些步骤真的并行，哪些只是先后发生；
• 一个分支为什么出现，选择之后对后续流程有什么影响；
• 省略的实现细节应该回到哪段源码、测试或复习笔记。

画面通常先给出全景，再放大关键子流程；同一条消息、任务或关联 ID 会在镜头切换后继续保持身份。看完视频，脑中留下的是一条可以复述的链路。

从项目到视频

Skill 的工作过程如下，成片只呈现理解最有帮助的部分：

1. 先摸清项目。 先读 README；如果没有 README，会询问是否先调研并补建。随后从真实入口、触发点和测试出发，跟到状态变化、结果去向和重要分支。
2. 整理理解重点。 写出项目名、一句总述和 3–4 条有依据的项目要点，再从面试官视角列出可能的追问，找出最容易混淆、也最值得展开的部分。
3. 选一条主线。 以任务或数据生命周期为单位比较候选流程，确定一条锚点主线和必要的支撑机制。通常制作一条视频，确实存在独立生命周期时最多拆成三条。
4. 设计连续画面。 依据机制选择全景聚焦、递进因果、前后对照、并行泳道或横切回挂。文字只承担名称、状态、条件和必要提示，动作负责说明因果。
5. 补上视频没有展开的部分。 按章节写短笔记，补充实现取舍、边界条件和源码入口，并把面试问题关联到视频时间或笔记段落。

目标项目里的产物

Skill 会在目标项目根目录创建独立的 `.project-to-video/`。目录按实际需要生成，不要求每个项目都填满：

.project-to-video/
├── README.md                 观看顺序、视频链接、章节时间和运行命令
├── research/                 项目全景、候选流程和源码证据
├── planning/