Motion Agent 最佳实践 是做什么的？
将此作为 Motion Agent 工作的路由层。深层的 AE 执行合约仍位于仓库的 skill/SKILL.md 中；在触及 After Effects 之前，请先阅读它。
核心原则
不要将 Motion Agent 视为“生成一个 JSX 然后碰运气”。将其视为一个生产工作流：
- 理解简报、参考、产品和交付上下文。
- 选择合适的工作流技能。
- 构建可编辑的 AE 结构，而非一次性图层。
- 使用捕捉的帧、采样值和具体证据进行验证。
- 将可复用的模式提升为案例或技能。
技能路由
| 用户需求 | 加载技能 |
|---|---|
| 新的视频、镜头、动画或合成 | motion-create |
| 发布视频、宣传片、产品公告、社交媒体推广 | motion-promo-video |
| UI 动画、产品演示、仪表盘流程、卡片/滑块/屏幕动效 | motion-ui-demo |
| 可复用的 AE 控件、表达式、骨架、预设、组件化动效 | motion-ae-rig |
| 审阅、打磨、比较、调试、验证、匹配参考 | motion-qa |
| 渲染、导出、捕捉预览、交付文件打包 | motion-render |
| 查找仓库文档、示例、案例配方、AE 基础知识 | motion-docs |
如果任务跨越多个领域，加载最小有效集合。例如，产品发布演示通常需要 motion-promo-video、motion-ui-demo、motion-ae-rig 和 motion-qa。
编辑 AE 之前
阅读仓库原始的 skill/SKILL.md，然后执行其预检清单。特别要注意：
- 使用
ae_scripts/tools/run_jsx.sh运行 JSX。 - 尊重 AE 的 ES3 ExtendScript 限制。
- 查找效果
matchName，而不是猜测显示名称。 - 每次脚本批处理只做一次逻辑变更。
- 保留用户的更改和现有的控制器值。
生产合约
每项 Motion Agent 工作都应留下：
- 一个可编辑的 AE 项目结构
- 用于重复调整的命名控件
- 预览证据
- 一份简短说明，解释更改了什么以及验证了什么
- 如果模式可能重复，则提供可复用的脚本或案例笔记
可编辑输出规则
- 为图层、预合成、控件、标记和输出文件命名以便人类理解。
- 将面向用户的控件放在清晰的
AI_Controls或特定任务的控件图层中。 - 保持表达式的可读性和本地化；倾向于精确的局部编辑而非完全重写。
- 避免隐藏的魔法：如果时间或布局是生成的，请暴露重要的调节参数。
- 除非用户明确要求仅最终输出，否则不要将所有内容烘焙成关键帧。
验证规则
在说“完成”之前，收集证据：
- 捕捉代表性帧
- 检查更改的图层、表达式或控制器值
- 当动效质量重要时，采样时间和缓动
- 检查文本边界、Logo 可读性和合成安全区域
- 记录任何未经验证的假设
模式推广
当工作流重复出现时，不要将其埋没在对话中：
- 在
cases/<category>/<case>/下添加或更新一个案例。 - 保存
RECIPE.md、可复用的 JSX 和前后对比证据。 - 如果该规则具有广泛适用性，将其精简版本推广到
skill/SKILL.md或这些代理技能中。 - 根据仓库工作流进行同步和提交。