把一句中文口播、观点或抽象概念，制作成适合知识讲解视频的“纸上钢笔线稿 + 选择性彩铅填色”动画素材。

这个 Skill 使用三闸门工作流：

1. 先确认视觉命题、构图、动效与音效方案。
2. 再生成并确认动作完成后的静帧。
3. 最后调用 Gemini 生成视频，并进行逐帧和音轨检查。

它支持人物叙事与无人物内容可视化、9:16/16:9 等自定义尺寸、多套语义配色，以及带同步轻量音效或静音输出。

• 固定镜头，保持人物身份、物件设计和纸面构图稳定。
• 使用“主动作 + 接力响应 + 生命微动作 + 短暂强调”的分层动效。
• 允许人物眨眼、呼吸、手部操作，以及图标错峰接力和结构生长。
• 每条箭头或连接线都必须有明确的起点与终点，不生成无来源的杂乱线条。
• 生长动画表示对象从固定起点按自身结构形成，不专指植物。
• 默认生成适合知识讲解的轻量动作音效。
• 严格禁止铅笔、钢笔、马克笔、粉笔书写以及任何笔纸摩擦声。

需要 Python 3.10+、FFmpeg、FFprobe 和可用的 Gemini API Key。

git clone https://github.com/yokel1121/muyang-flat-animation.git
pip install -r muyang-flat-animation/requirements.txt

将 Skill 目录复制到 Codex Skills 目录：

Copy-Item -Recurse .\muyang-flat-animation "$env:USERPROFILE\.codex\skills\muyang-flat-animation"
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的_API_Key", "User")

cp -R ./muyang-flat-animation ~/.codex/skills/muyang-flat-animation
export GEMINI_API_KEY="your_api_key"

检查环境：

python ~/.codex/skills/muyang-flat-animation/scripts/check_setup.py

Windows 可将上面的路径替换为 %USERPROFILE%\.codex\skills\...。

$muyang-flat-animation 16:9，制作：学会用 AI 放大自己的能力

$muyang-flat-animation 无人物，9:16，制作：信息不是越多越好，而是越清楚越好

$muyang-flat-animation 3:4，鼠尾草绿，无声，制作：把复杂流程整理清楚

Skill 会先停在动画方案确认阶段。回复“通过”或“继续”后生成静帧；静帧再次确认后才生成视频。

详细配色、画幅和动作语法位于 muyang-flat-animation/references/。

开源仓库不包含来源不明的参考插画。你可以把自己有权使用的图片放入：

muyang-flat-animation/assets/references/style-reference-01.png

图片只会作为 style-only references，约束纸面、线稿、彩铅颗粒、留白和图解语言。没有图片时，Skill 会使用内置的完整文字画风规范。

不要提交无授权图片；该目录已默认加入 .gitignore。

创建 jobs JSON：

[
  {
    "prompt": "Your complete motion prompt",
    "image": ["final-still.png"],
    "output": "final.mp4",
    "aspect_ratio": "16:9",
    "duration": 6
  }
]

运行：

python muyang-flat-animation/scripts/generate_video.py --batch jobs.json --concurrency 1

默认模型是 gemini-omni-flash-preview。模型名称、可用地区、额度和计费规则可能变化；遇到 429 RESOURCE_EXHAUSTED 时，请检查 Google AI Studio 项目余额或切换到有额度的 API Key。

python muyang-flat-animation/scripts/inspect_video.py final.mp4 \
  --reference final-still.png \
  --output-dir qa

检查项包括镜头漂移、人物和手部一致性、随机线条、画风漂移、音轨存在性和输出规格。是否出现笔纸摩擦声仍需人工试听确认。

.
├── README.md
├── LICENSE
├── requirements.txt
└── muyang-flat-animation/
    ├── SKILL.md
    ├── agents/openai.yaml
    ├── evals/evals.json
    ├── references/
    └── scripts/

工作流参考 pyang5166/gbro-collage-broll。

MIT