majiayu000/spellbook / skills/code-film
code-film
Verified用纯代码(three.js 离线渲染 + 合成音频)做有故事、有电影质感的动画短片并导出 MP4。当用户想做短片、动画片、宣传片、角色动画、循环视频、片头、产品故事片,或者说“用代码做个视频”“做一个有趣的短片”“帮我设计个小动画”“make a short film / animated video / motion piece with code”时使用,即使没提 three.js。也用于继续修改这类片子。写实真人、实拍感、AI 视频生成、普通视频剪辑不适用。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.9 KB |
| assets/character-sheet.tpl.html | other | 27.8 KB |
| assets/characters/clawd-sheets/expressions.jpg | binary | 257.4 KB |
| assets/characters/clawd-sheets/turnaround.jpg | binary | 107.4 KB |
| assets/characters/clawd.js | script | 4.4 KB |
| assets/characters/sprout.js | script | 9.8 KB |
| assets/film-template.html | other | 34.5 KB |
| examples/last-bug/last-bug-demo.js | script | 991 B |
| examples/last-bug/last-bug.html | other | 71.0 KB |
| references/character.md | markdown | 3.4 KB |
| references/craft.md | markdown | 4.6 KB |
| references/story.md | markdown | 2.5 KB |
| scripts/character_sheet.py | script | 1.9 KB |
| scripts/check.pyexecutable | script | 3.2 KB |
| scripts/render.pyexecutable | script | 2.8 KB |
| scripts/stills.pyexecutable | script | 2.7 KB |
| scripts/use_character.pyexecutable | script | 479 B |
references/story.md
View on GitHub# 故事
短片靠一个清楚的因果撑住。视觉再好,观众看不懂为什么发生,就会觉得奇怪。
## 结构
一个想要东西的角色,一个阻碍,一次反转,一个收尾。40 到 90 秒里 3 到 5 个场景足够。场景越多,每个越薄:同样的精度下,把时间花在少数场景上更好看。
方案用这张表:
| 时间 | 场景 | 发生什么 |
|---|---|---|
再写清楚:标题、片长、主角、保留什么、去掉什么。
## 逻辑检查
给方案前逐条问:
- 这个角色为什么做这件事?换成观众会这么做吗?
- 每个道具从哪来,为什么在这里?
- 这个象征在观众心里本来是什么意思?故事有没有违背它?
- 没看过方案的人,只看画面能说出发生了什么吗?
反例:片子里 bug 背着分号交给主角。观众的第一反应是“bug 不是要消灭的吗,为什么它在帮忙?”改成 bug 偷走分号、主角用 `catch (bug)` 抓住它之后,同样的道具就通了。
## 让它有趣的手法
**一条藏在背景里的线索。** 让观众比主角先知道一件事。主角到处找的东西一直跟在身后,第一遍看主角,第二遍看线索。
**重复三次。** 第一次建立,第二次起疑,第三次爆发。三次经过写着 `// 快到了` 的路牌,比任何台词都好笑。
**一张无语的脸。** 喜剧靠停顿。让角色停下来,慢慢转头看镜头,留足时间。
**差一点的回头。** 主角突然回头,线索及时躲开。这让后面真正发现时更有分量。
**概念变成实物。** 找到抽象概念的字面含义:`break` 是一块能踩的键,`catch` 是一个扣下来的盒子,调用栈是一段台阶。这是代码片最大的乐趣来源,也适用于其他领域。
**用真实的东西。** 堆栈、报错、数据都用真的。懂行的人会看出来,不懂的人也不受影响。
**循环要有含义。** 首尾相接不只是技术:修完一个 bug 又来一个,两个玩具每晚轮流上弦。结尾状态接回开头时,故事也跟着说得通。
**情绪落点。** 全片要有一个让人心软的地方。一句 `thanks` 加一滴眼泪,比一场大爆炸更让人记住。
## 怎么和用户讨论
用户说“太简单”“不够有趣”,先改内容,别急着换风格或换角色。给一个明确的推荐,不要列一堆选项。用户指出逻辑问题时,先想通为什么观众会困惑,再改设定,而不是只改那一个镜头。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |