ae-agent-skills 0.2.3 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ae-agent-skills",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
4
  "description": "One-command installer for the ae-agent-skill After Effects extension and CLI.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -66,6 +66,18 @@ description: Command-by-command After Effects editing via ae-cli. Best for surgi
66
66
  - `ae-cli move-layer-order ...`
67
67
  - `ae-cli delete-layer ...`
68
68
 
69
+ ## 最小手順(このまま使える)
70
+
71
+ リポジトリのファイルに依存せず、命令型だけで comp と text レイヤーを作る最小例。
72
+
73
+ ```bash
74
+ ae-cli health
75
+ ae-cli create-comp --name "Skill_CLI_Minimal_Test" --width 1280 --height 720 --duration 3 --frame-rate 30
76
+ ae-cli set-active-comp --comp-name "Skill_CLI_Minimal_Test"
77
+ ae-cli add-layer --type text --name "Hello" --text "CLI skill test"
78
+ ae-cli layers
79
+ ```
80
+
69
81
  ## 注意
70
82
 
71
83
  - 既存シーンへの単発・部分修正は命令型の方が安全な場合が多い(影響範囲を局所化しやすい)。
@@ -66,7 +66,6 @@ ae-cli expression-errors
66
66
 
67
67
  ## scene 設計ルール
68
68
 
69
- - 正式スキーマは `schemas/scene.schema.json` を参照
70
69
  - `layers[].id` は必須推奨(upsert の安定キー)
71
70
  - `layers[].parentId` は scene id を参照
72
71
  - アニメーション対象プロパティは `animations` で管理
@@ -77,6 +76,42 @@ ae-cli expression-errors
77
76
  - Essential Graphics は `layers[].essentialProperties[]`
78
77
  - expression 内の effect 参照は表示名ではなく matchName を推奨(例: `ADBE Slider Control-0001`)
79
78
 
79
+ ## 最小テンプレート(このまま使える)
80
+
81
+ 以下を `work/min.scene.json` として保存して、そのまま `validate/apply` できる。
82
+
83
+ ```json
84
+ {
85
+ "composition": {
86
+ "name": "Skill_Minimal_Test",
87
+ "width": 1280,
88
+ "height": 720,
89
+ "duration": 3,
90
+ "frameRate": 30,
91
+ "pixelAspect": 1,
92
+ "createIfMissing": true,
93
+ "setActive": true
94
+ },
95
+ "layers": [
96
+ {
97
+ "id": "t1",
98
+ "type": "text",
99
+ "name": "Hello",
100
+ "text": "Skill only test",
101
+ "transform": {
102
+ "position": [640, 360],
103
+ "opacity": 100
104
+ }
105
+ }
106
+ ]
107
+ }
108
+ ```
109
+
110
+ ```bash
111
+ ae-cli apply-scene --scene-file work/min.scene.json --validate-only
112
+ ae-cli apply-scene --scene-file work/min.scene.json
113
+ ```
114
+
80
115
  ## propertyPath 運用ルール(汎用)
81
116
 
82
117
  - 目的: 実装コードを読まずに `propertyPath` を安定して決める。