60 lines
2.9 KiB
Markdown
60 lines
2.9 KiB
Markdown
---
|
||
name: moviegame
|
||
description: Edit JSON-driven interactive movie game config files. Validates scene references, variables, and structure.
|
||
---
|
||
|
||
# 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` — 游戏起始场景
|