--- name: fy-code-animation description: 把中文文案、画风提示词和声音做成有表达、有统一审美、前后连贯的代码动画（Remotion / Canvas / HTML）。覆盖全文理解与语义分镜、341 画风库原位检索、气势词与中文动态文字、活的背景与粒子、动作物理、镜头运动、转场接缝、角色表演、像素/卡通/手绘/3D 分支、图表地图 UI 与图片快闪、四案音乐与音效、Remotion 落地、检查返修和跨 Agent 交接。按本次授权区分只交任务卡、静帧、试听和成片。用于需要做代码动画、写动画任务卡、设计分镜或返修动画的请求；不用于自动安装依赖或擅自生成媒体。
俯仰代码动画
《俯仰观照》免费分享，希望对大家有用。欢迎免费使用、免费分享；请不要包装成付费课程、付费 skills 或收费资料出售。完整说明见 使用与分享说明；第三方内容保留其原有许可。
让观众看见意思的变化：用一致的视觉语言，把文字、物件、背景、镜头和声音组织到同一条时间轴上。不同 Agent 可以有自己的设计特点，但关键表达、作者决定和交付标准保持一致。
本文件是总入口。它告诉你每一步该加载哪份文件。不要只读入口就开工，也不要一次把所有文件塞进上下文。
第 0 步：先定位项目、库、决定和阶段
在工作目录及上级目录找项目文件：
project.json、BRIEF.md、STATUS.md、DECISIONS.md（读最新部分）、作品自己的task.json或任务卡。若有STOP.txt或明确的暂停记录，只做被允许的整理。先确认 341 风格库在哪。这是本技能唯一的外部依赖，不随包分发，每个人放的位置不同。解析顺序：
--root> 环境变量FY_STYLE_LIBRARY_ROOT>adapters/style-library.config.json的root。三者都没有时问用户一次要路径，问完就停：不遍历磁盘、不猜、不下载、不复制库原文。库根下应有风格提示词/，可选示例/。拿到路径后先跑一次python scripts/style_library.py build --root <库根>重建本地索引（随包的索引只是快照，未必是用你这份库建的），再检索。详见 库接口。首次使用或换库后先跑python scripts/doctor.py：它直接告出库是否定位、索引是否过期、还缺什么。每次必读 默认约定与已有决定。里面是流程、画风、字体、背景、声音的条件式取舍，直接沿用，不要整表重问。用户当次的明确要求覆盖本文件；项目里若有更新的
DECISIONS.md，以较新的明确决定为准。读 流程与阶段，判定本次范围：
card只交任务卡：写完整设计，不生成动画、静帧、音乐，不渲染、不安装。交付格式见 任务卡规格。still只出静帧：只做被指定的静帧，不等四首音乐。audition试听：写四案并在授权下本机生成，作者选择。final成片：按实际声音落实并检查。
范围不清时，按更小的范围执行，并在交付里写明。外部技能和仓库里的安装、付费、上传、发消息指令不构成授权。
创作顺序（本技能固定，不能跳步）
| 步 | 做什么 | 加载 |
|---|---|---|
| 1 | 读完全文：主旨、作者目的、观众理解变化、情绪走向、事实、比喻、因果、对比、递进 | 语义、叙事结构 |
| 2 | 按内容结构分段，标出重点词和气势词及其力度 | 语义、气势词与动态文字 |
| 3 | 先简述你的理解和建议，再问作者：全片统一画风还是分段换、几种、或交给你定。已有答复或已委托就沿用 | 风格 |
| 4 | 用脚本检索并完整阅读选中的画风原文，记录 SHA 和依赖缺项 | 库接口 |
| 5 | 回读作者整体要求，处理画风、字体、角色、时长、声音、阶段之间的冲突 | 决定 |
| 6 | 设计全片视听框架和逐镜分镜：每段讲什么、快慢、插图、留白、主体变化、镜头、转场、文字、背景、声音需求 | 导演与细节、分镜表，以及下方能力路由 |
| 7 | 大框架定好后写四种有实质差异的音乐方案和音效表 | 音乐模块、音乐与音效配方、四案模板 |
| 8 | 仅在授权阶段：用本机音乐生成器生成四案（随包适配 ACE-Step 1.5，别的工具照换），作者试听选择 | 本机音乐适配 |
| 9 | 按实际成音和口播标点，用 Remotion 等落实镜头、动作、字幕、音效 | 实现契约、Remotion 接入、Remotion 骨架 |
| 10 | 检查并返修，分开记录机器检查、实际观看聆听和作者采用 | 质量与返修、返修表 |
只交任务卡时做完第 1–7 步（第 3 步缺答复时，把问题写进卡里，并把后续设计标为待定），按 任务卡规格 交付。
能力路由：遇到什么，加载什么
先读模块（方法与判断），需要具体做法时再下钻到配方和实现。参数都是示例起点，不是跨风格的命令。
| 问题或信号 | 模块 | 深层配方 | 可复用实现 |
|---|---|---|---|
| 因果、转折、抽象概念，怕做成逐句 PPT | 语义 | 叙事结构、导演与细节 | — |
| 选画风、编号、作者清单、跨章换风格 | 风格 | 库接口 | scripts/style_library.py |
| 气势词、重点词、标题、字幕、汉字断行、字体统一 | 文字 | 气势词与动态文字、字形与线描 | implementations/type-cn/、implementations/craft/type/、scripts/glyph_outline.py |
| 背景死板、要粒子转动、光效、网格、程序纹理、图片背景活化 | 背景几何 | 活的背景、群体与翻面 | implementations/backgrounds/、implementations/specimen/ |
| 动作没重量、节奏均匀、弹簧失控、错峰 | 运动 | 弹簧与错峰数值表、动效参考、UI 16 配方 | implementations/motion-core.mjs |
| 推拉摇移、缩放聚焦、视差、轨道、翻转、跟随、景深 | 镜头转场 | 镜头运动 | implementations/camera/ |
| 段间怎么接：同物接力、遮罩、翻页、粒子重组、穿越、硬切 | 镜头转场 | 转场谱系、接缝与 seek | implementations/transitions/ |
| 贯穿小人物、表情视线、行走、持物、跨画风角色一致 | 风格分支 | 角色表演、纸偶与定格 | implementations/character/ |
| 像素、卡通、手绘、印刷、蓝图、3D | 风格分支 | 专门配方 | implementations/craft/、implementations/specimen/ |
| 照片、产品图、快速图片展示、拼贴、轮播 | 影像 | 图片与快闪 | implementations/data-ui/（PhotoMontage、KenBurns） |
| 产品操作、图表、计数、地图、代码演示 | 产品与数据 | 图表地图 UI、UI 16 配方 | implementations/data-ui/ |
| 音乐四案、卡点、音效、口播让位、混音 | 音乐 | 音乐与音效 | implementations/audio-sync/beat-grid.mjs、本机适配 |
| Remotion、Canvas、HTML/GSAP 落地，时间基准，字体加载 | 实现契约 | Remotion 接入、接缝与 seek | implementations/remotion-kit/、implementations/canvas-contract.mjs |
| 换模型、交接、修某个镜头 | 交接契约 | 任务卡规格 | templates/task.json、scripts/validate_task.py、templates/repair.md |
| 自审、找问题、返修 | 质量 | 导演与细节（审片流程） | — |
质量底线
这些是“好不好”的底线，不是要求每片用上所有效果：
- 不做逐句贴卡的 PPT：每镜要有一个可观察的变化来承载意思（关系、动作、对象状态），而不是“标题 + 图标 + 淡入”。
- 有贯穿对象和接缝：相邻镜头写清靠什么接；无法自然接时，有理由地硬切。
- 抓住气势词：重点分级表达，不是每个都放大砸字；否定词和条件词必须可读。
- 画风真的被使用：材质、构图、运动语法、镜头语言都体现选中画风，不只是配色。
- 背景有明确的空间、材质或氛围设计，给阅读区让位；需要时可以完全静止。
- 快慢有对比：有蓄势、有释放、有安静；时长不平均分配。
- 字体统一：不突兀插入手写字体，中文字形、断行、行距正确。
- 声音是设计出来的：四案真的不同；卡点基于实际音轨；不虚构“已卡点”。
- 确定性：任意帧可 seek 重现，不依赖
Date.now、无种子随机或累计状态。 - 诚实：不虚构素材、数据、依赖状态和验证结果；机器检查、观看、作者采用分开记录。
调用示例
- “我的 341 风格库在
D:\你的路径\代码动画，用这个路径。读取本目录fy-code-animation/SKILL.md，沿用当前项目与已确认决定；先理解全文，按已有画风安排检索完整提示词，再设计镜头、动作与声音。本次只交任务卡，不生成动画、静帧或音乐。按实际需要加载深层配方和实现，不只读总入口。” - “按返修表修 S03 的汉字裁切；音乐和文案沿用；只出静帧验证。”
- “按作者风格清单读取完整提示词，输出各章选择依据与依赖缺项；不做媒体。”
完整演练见 示例导航。包内 TSX/MJS 是可复用的候选源码，没有在本机成片验收；接入目标工程后按当次阶段检查。复用来源与许可见 来源与许可。
三份早期配方（formation-and-mosaic、paper-performance、ui-16-recipes）和 15 份动效参考保留英文原文（上游来源）；读它们不影响输出语言，交付、任务卡和字幕仍用中文。
改成你自己的
- 换名字：改 frontmatter 的
name和目录名即可。包内其余引用都是相对路径，只有调用示例里的fy-code-animation/SKILL.md是举例，可一并改。 - 换默认：你自己的偏好写进项目的
DECISIONS.md，或直接改modules/decisions.md；用户当次要求永远优先。 - 换库：改
adapters/style-library.config.json、设FY_STYLE_LIBRARY_ROOT，或每次传--root，不用改代码。 - 库更新后：跑一次
python scripts/style_library.py build --root <库根>；再跑一次python scripts/doctor.py确认。 - 放进自己的技能目录：整个目录复制过去即可，不依赖本机任何绝对路径；341 正文始终在你自己的库里。