这是什么
code-poem-film 是一个专为 Claude Code 设计的 Agent Skill，它能把一首古诗或词（也可以是一句诗或短文）自动转化为一段 20–80 秒的水墨手绘风 2D 动画。
动画中，一个红点小角色在宣纸上行走，每句诗随着朗诵在题签上逐字写出，最后一句由红点自己提笔书写，并落成一枚红印章。整个动画的每一帧都由代码绘制，配乐和音效使用 numpy 合成，不需要任何图片、视频素材或现成音乐。
适合谁
这个技能适合以下人群：
- 内容创作者：希望快速生成具有中国传统文化特色的短视频，用于自媒体发布。
- 教育工作者：制作古诗教学辅助动画，帮助学生理解诗词意境。
- 技术爱好者：对 AI 生成视频、代码艺术感兴趣，愿意尝试新的创作方式。
- 一人公司创业者：需要低成本、高效率地制作个性化视频内容。
能做什么
使用这个技能，你可以：
- 输入一首诗或词，自动生成完整的动画视频，包括画面、朗诵、配乐和字幕。
- 自定义题材：如果没有指定诗，助手会提供候选；可以选择是否添加朗诵。
- 自动排版：根据朗诵的实际长度调整画面节奏，确保每句诗与声音同步。
- 生成多种交付物：成片、上传版（短片压缩到 10MB 以内）、封面、每秒一帧的总览图，以及带实测数据的帖子草稿。
- 支持自定义语音：可以使用系统语音，也可以接入自己的 TTS 服务。
使用前准备
在安装之前，请确保你的环境满足以下要求：
- Claude Code 或其他支持 SKILL.md 格式的编程助手（如 Codex 等，但未实测）。
- Node.js 20+：用于渲染（通过 npx 调用 HyperFrames）。
- Python 3.10+：需要安装 numpy 和 Pillow。
- ffmpeg：用于视频处理。
安装方法
按照以下步骤安装：
git clone https://github.com/bangbuilds/code-poem-film ~/.claude/skills/code-poem-film
pip install numpy pillow
安装完成后，直接在 Claude Code 中说：“把《登鹳雀楼》做成动画”即可开始创作。
如果你使用其他工具（如 Codex），可以将 skill 克隆到对应目录，例如：
git clone https://github.com/bangbuilds/code-poem-film ~/.agents/skills/code-poem-film
注意：此路径未经过实测，且 film.py stats 功能仅支持 Claude Code 的会话记录。
使用示例
以下是不经过 AI，手动运行范例的步骤：
SK=~/.claude/skills/code-poem-film # 你克隆到的位置
python3 $SK/scripts/new_project.py qingzhou-demo --example qingzhou
cd qingzhou-demo
python3 tools/film.py voice # 朗诵（默认用系统语音），切成标题、作者、四句
python3 tools/film.py build # 笔画数据 + 时间表 + 配乐混音
python3 tools/film.py qa # 抓帧检查，总览图在 build/qa/
python3 tools/film.py render # 渲染 + 核对 + 打包，约 1 分钟
如果不想要朗诵，将第一步改为 python3 tools/film.py voice --dry。
不带 --example 新建的工程会生成一条“起步片子”，适用于任何诗，可先跑通完整流程。
风险与注意事项
这是一个早期版本，存在以下限制和风险：
- 平台兼容性：目前仅在 macOS（Apple Silicon）上测试过，Linux 和 Windows 未验证。
- 配音质量：系统语音机器味较重，适合验证流程；如需更好音质，需自行接入 TTS 服务。
- 声音验证：脚本只能测量响度、频段等客观指标，无法判断声音是否好听或有感情，需要人工试听。
- 画面限制：只支持横版 16:9，竖版未实现；人物只有远景剪影，无法表演。
- 逐字对时：末句“边念边写”的逐字时间需要手动标注，没有自动对齐。
- 生僻字：可能缺少笔画数据，脚本会报错。
- 性能：生成时间取决于诗的长度和画面复杂度，目前实测《赤壁怀古》耗时 63 分钟。
请在使用前仔细阅读 README 中的“现在的状态”部分，了解详细限制。