1仕組みと動作原理
「知識型スキル」としての位置づけ:AE は GUI ソフトウェアであり、成果物はレンダリングされた動画ではなく、貼り付け可能なアセット(エクスプレッション、リグ設計案、書き出しレシピ、診断フロー、命名規則、ExtendScript)です。
After Effects is GUI software, so this skill delivers knowledge and ready-to-paste assets — expressions, rig setups, export checklists, diagnostic flows, naming schemes, and ExtendScript — rather than a rendered file.
SKILL.md は4つの領域のルーティング拠点:エクスプレッション/リグ/MOGRT、書き出しレシピ、パフォーマンス診断、プロジェクト整理がそれぞれ独立した reference を参照し、ルートファイルには最小限の実用的な結論のみを残しています。
| Write/debug an expression, rig sliders & nulls, build a MOGRT, export to Lottie | `references/expressions.md` (deep cookbook in `references/expression-library.md`) |
エクスプレッションがそのまま貼り付けて動作する理由は AE の評価セマンティクスに準拠しているため:対象プロパティ上で JS が評価され、スコープ内に value/time/index/thisLayer/thisComp が存在し、デフォルトでキーフレームを上書きします。
Expressions are JavaScript evaluated on the property they are pasted on; `value` is that property's value, `time` is comp time in seconds, and `index`, `thisLayer`, `thisComp` are in scope.
書き出しの混乱は「エンジンの選定ミス」(レンダーキュー = マスター/中間コーデック、AME = 納品用)に起因するものとし、H.264 がアルファ非対応で「背景が黒くなる」現象をバグではなく仕様上の結論として定義しています。
Two engines, and choosing wrong is the root of most export confusion:
透明度を保持した書き出しには、マット設定の調整ではなくコーデックの変更(ProRes 4444 / PNG-TIFF 連番 / HEVC-alpha + VP9-alpha)が必須です。
**H.264/MP4 cannot store alpha**, so a transparent comp exported to H.264 always fills with black; that is the classic "black background" complaint and not a bug.
パフォーマンス診断は症状別に3つの順序立てられたフローに整理され、低負荷な対処から順に試し、解決した時点で完了とする設計になっています(無作為な設定リストの羅列ではありません)。
Work top-down by symptom, cheapest fix first, and stop when it clears.
プロジェクト整理では、「納品プロジェクトは Collect Files 必須」「.jsx によるバッチ処理は UndoGroup で囲み、matchName でエフェクトを適用する」ことを必須ルールとして定めています。
**Always hand off projects via `File > Dependencies > Collect Files`**, never a bare `.aep`.
同梱の3つの .jsx は「上部の定数を書き換えて AE 内で手動実行(Run Script)する」ためのボイラープレートであり、エージェントが自動実行するための入口ではありません。
select layers in a comp, then File > Scripts > Run Script File...
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | ffmpeg(透明 WebM/VP9 转码示例) |
| package | Adobe After Effects 的两个导出引擎(Render Queue / Adobe Media Encoder) |
| package | Bodymovin / Lottie 导出链(AE 扩展 + lottie-web;示例代码,产物期引入) |
| cli | Creative Cloud 的 Other Versions 回滚流程(崩溃/回归时的用户侧动作) |
4推奨統制措置と判定根拠
- scripts/: ローカルスクリプトまたはコマンドの実行: skills/after-effects/scripts/batch-rename.jsx(アクティブコンポジション内で選択したレイヤーの name を変更)
- 本地工作目录: ファイルの読み書きと成果物の出力: .jsx スクリプトはメモリ上の AE プロジェクトオブジェクト(レイヤー名、インポイント、エフェクトスタックなど)のみを変更します。ストレージへの保存はユーザー自身が AE 内で保存するかどうかに委ねられており、スクリプト単体でファイル書き込みは行いません。
5二重目の独立検証
- [ok] 三个 .jsx 是否含网络/文件系统/动态执行调用 — 逐行读完:只有 app.project.activeItem 类型守卫(CompItem/AVLayer)、sel[i].name、layers[j].startTime、layer.property("ADBE Effect Parade").canAddProperty/addProperty,以及 beginUndoGroup/endUndoGroup;无 XMLHttpRequest/fetch/File/socket/eval/Function。
- [ok] SKILL.md 或 reference 里是否藏着会被 agent 执行的 shell/CLI 指令 — 全目录搜 npx/curl/wget/brew/npm:均无。本 skill 与同仓 color-motion 的关键差异正在这里——color-motion 的验收回路含 npx playwright screenshot,after-effects 没有任何需要跑的命令。
- [ok] ffmpeg 示例是否构成「执行期外发」 — `ffmpeg -i master.mov … out.webm` 是纯本地转码,输入输出都在本机,不涉端点;列在 external_deps 只为交代工具链,不代表网络行为。
- [ok] 「Allow Scripts to Write Files and Access Network」是否被本 skill 用来做事(是否该升档) — 该句出现在 references/project-hygiene.md 的 Scripting setup 段,是 AE 脚本能力的通用说明(AE 需开此开关脚本才能保存/渲染)。本 skill 的三个 .jsx 都不使用文件或网络 API;按判级口径(对象=skill 自身目录的程序行为),档位仍为蓝,该点只写入 risks。
- [unlocatable] AE 行为类结论(QuickTime gamma、MFR 需每核数 GB、H.264 无 alpha)是否可在源码内验证 — 均为领域知识声明,pin 仓库内没有复现脚本、也没有引用来源(无外链、无数据集)。本次为只读侦查且不运行 AE,故不验证其数值正确性,只作为「文档声明」记录,不在结论里当作已核事实。
6結論
7cd8155a90d8ab34…