diff --git a/.opencode/skills/moviegame.md b/.opencode/skills/moviegame.md
new file mode 100644
index 0000000..bdc1c3e
--- /dev/null
+++ b/.opencode/skills/moviegame.md
@@ -0,0 +1,54 @@
+# Movie Game Engine Skill
+
+你正在编辑一个 JSON 驱动的交互电影游戏配置文件。先读文件、理解现有结构，再精确修改。
+
+## 关键参考文件（需要时自行读取）
+
+| 文件 | 内容 |
+|------|------|
+| `engine/types.ts` | 全部类型定义：SceneNode、Choice、Condition、Effect、QTEDefinition、GameData 等 |
+| `docs/ARCHITECTURE.md` | 架构约束：A/B 双缓冲、JSON 驱动、事件系统 |
+| `AGENTS.md` | 项目开发约定 |
+
+当前编辑的故事配置文件路径由对话上下文提供（如 `public/scenes/demo.json`）。
+
+## 核心操作规则（必须遵守）
+
+1. **key === id**：`scenes` 对象 key 必须等于 `SceneNode.id`，始终一致。新增场景时两者设为相同值
+2. **变量先声明后使用**：新增 effects/conditions 引用新变量名 → 必须先在 `GameData.variables` 中追加声明（初始值建议 0）
+3. **删除清理**：删除场景时，必须清理所有其他场景中对它的引用：`choices[].targetScene`、`nextScene`、`qte.successScene`、`qte.failScene`、`hotspots[].targetScene`
+4. **引用有效**：所有 `targetScene`、`nextScene`（string 形式）、`successScene`、`failScene`、`startScene` 必须指向 `scenes` 中存在的 key
+5. **保持结构**：修改场景时保留所有已有字段，除非明确要求删除
+
+## 变量使用位置（全部）
+
+下列所有位置引用的变量名都必须在 `GameData.variables` 中声明：
+
+| 位置 | 字段 |
+|------|------|
+| `Choice.effects` | `Effect.target` |
+| `Choice.conditions` | `Condition.variable` |
+| `nextScene (Choice[])` 每个路由的 `effects` | `Effect.target` |
+| `nextScene (Choice[])` 每个路由的 `conditions` | `Condition.variable` |
+| `SceneNode.onEnter` | `Effect.target` |
+| `QTEDefinition.effects.success` | `Effect.target` |
+| `QTEDefinition.effects.fail` | `Effect.target` |
+| `Hotspot.effects` | `Effect.target` |
+| `Hotspot.conditions` | `Condition.variable` |
+| `AchievementDef.condition` | `Condition.variable` |
+| `BattleHUDStat` | `variable` |
+| `BattleResultStat` | `variable` |
+| `ChapterInfo.defaultVariables` | keys |
+
+**Effect 格式**：`{ "type": "set", "target": "变量名", "value": 5 }` 或 `{ "type": "add", "target": "变量名", "delta": 1 }`
+**Condition 格式**：`{ "variable": "变量名", "op": ">=", "value": 3 }`（op 支持 > < >= <= == !=）
+
+## 场景引用关系
+
+- `Choice.targetScene` — 选项跳转目标
+- `nextScene` — string = 直接跳转；Choice[] = 条件路由（逐条 evaluate conditions，第一条匹配的生效）
+- `QTEDefinition.successScene` / `failScene` — QTE 成功/失败跳转
+- `Hotspot.targetScene` — 热点跳转
+- `ChapterInfo.startScene` — 章节起始场景
+- `EndingDef.sceneId` — 结局关联场景
+- `GameData.startScene` — 游戏起始场景