Git Story Film
让仓库历史成为故事的依据
从真实提交中选择故事,用角色、分镜与手绘动画讲清项目怎样成长。

使用入口
- Claude Code
- 能读取完整 Skill 并操作本地工程的代码助手
- 所在仓库 Star
- 5,916
- 资料核对
第一次只确认故事方向
选一个有清晰里程碑的仓库,先讲清 3–5 个观众应该记住的变化。确认事实与主线后再制作角色,能在投入动画工作前发现“故事很好看,但产品被讲错了”的问题。
选一个任务,开始使用
以下四个任务对应七步流程中的连续阶段。先完成安装和第一条任务,再带着已确认的材料继续;尖括号内容需替换为实际仓库 URL。
从仓库历史开始,本轮只交可核对的故事方案。
将完整 Skill 放进独立工作目录
本站按作者“复制完整目录”方式整理的固定提交示例,适用于 macOS/Linux/WSL shell,需 Git。请在新目录执行;同名目录已存在时先检查。稀疏检出 Skill,再连同根许可文件复制到工作目录;不运行 Raven 主程序安装。原生 Windows 可按作者指南复制整个目录;依赖安装留到制作阶段。
查看作者安装说明git clone --filter=blob:none --sparse https://github.com/EverMind-AI/Raven.git raven-skill-source git -C raven-skill-source sparse-checkout set skills/git-story-film git -C raven-skill-source checkout --detach 9d9bec90bcd76186d2981fd23b3b6280d83e3684 mkdir -p film-workspace/.claude/skills cp -R raven-skill-source/skills/git-story-film film-workspace/.claude/skills/ cp raven-skill-source/LICENSE raven-skill-source/NOTICES.md film-workspace/.claude/skills/git-story-film/ cd film-workspace在 film-workspace 开始第一轮
在 Claude Code 中打开 film-workspace,重新加载并确认 .claude/skills/git-story-film/SKILL.md 已可读取。先检查 Git 与 Python;将下方提示词中的 URL 换成目标仓库,说明要讲述的分支。目标仓库放在工作目录外,例如 ../target-repo。统计脚本可从当前目录使用 python3 .claude/skills/git-story-film/scripts/git_timeline.py ../target-repo --branch HEAD --out timeline.json;HEAD 应是你已选定的目标提交。第一轮只需故事材料,渲染工具留到角色制作前准备。
作者入口与七步流程把这段话发给 AI
本站根据固定源码编写的任务示例;结果栏是应交付与检查的内容。本站未运行这些命令、制作关键帧或渲染影片。
/git-story-film <目标仓库 URL> 为第一次了解产品的人规划约两分钟中文介绍片,16:9。将目标仓库放在当前 film-workspace 之外,读取所选分支的完整历史,不用浅克隆;记录分支和 HEAD 完整哈希。使用完整 Skill 中的 scripts/git_timeline.py,把统计结果写到当前影片工作目录的 timeline.json,并结合目标仓库 README、功能文档和公开发布记录核对候选事件。不要修改目标仓库。本轮提交 timeline.json 与 OUTLINE.md;大纲包含:一句话主线、适合的叙事形式、主角与字幕口吻、起承转合、3–5 个观众应记住的要点,以及事实到画面动作的对应。每个数字、版本和转折附依据,找不到回滚就不编造。列出尚待确认的受众、标志使用或事实问题,等我确认方向后再制作角色;本轮不安装渲染依赖或制作影片。
检查你拿到的结果
- 当前工作目录中的 timeline.json 和 OUTLINE.md;大纲能说明产品为谁解决什么问题,以及为什么选择这些事件。
- 统计标明分支、HEAD 与日期口径;重点功能、发布日和回滚分别有可回查的提交或文档依据,待核事实单列。
- 确认故事方向、语言、比例与标志处理后,再进入角色阶段;本轮的交付是方案。
进一步了解这个 Skill
Git Story Film 适合项目发布、周年回顾和面向新人的产品介绍。助手从提交、版本与回滚中挑出有意义的变化,把功能写成观众看得懂的动作,再组织成约两分钟动画。它交付的不只是统计图:角色为何行动、遇到什么挫折、最终能替用户做什么,都是故事的一部分。
它是 Raven 仓库里的一个独立 Skill 目录,附带 Canvas 绘图引擎、HTML 审片 Studio、Git 统计与本地渲染脚本。代码助手负责研究和改写影片代码;浏览器绘制画面,FFmpeg 编码成片。使用这份 Skill 无需先安装 Raven 主程序,也不需要另接文生视频服务。
作者把制作分成七次确认:故事方向、角色、完整提纲、前 30 秒分镜、整片制作、Studio 审片和最终交付。字幕承担叙述,Web Audio 合成配乐。先确定短段落的语气与节奏,再扩展到全片,最后才做高分辨率输出。
来源与核验
资料核对