# AGENTS.md

## 项目规则

1. 不要盲目顺从用户观点；如果用户判断和源码证据不一致，以源码证据为准并直接说明。
2. 不要猜测。任何组件、布局、资源、相机、坐标、交互、状态、业务逻辑，都优先查原 Cocos 源码。
3. 本项目目标是把 QQ 农场小游戏按原 Cocos 源码重构到 Cocos Creator 3.8，不做重新设计，不做近似实现。
4. 所有组件和逻辑都参考原 Cocos 源码：scene、prefab、compact json、配置表、资源 manifest、SpriteFrame 元数据、Spine 元数据、序列化组件字段、运行时代码。
5. 不用 Godot 输出、截图、旧生成数据、视觉猜测来决定位置、大小、锚点、缩放、相机、层级、active 状态或交互逻辑。截图只用于观察问题，不作为改动依据。
6. 能直接复用原 Cocos 组件结构和运行逻辑时，直接复用；不要为了方便重写成另一套坐标系或交互模型。
7. 修改完成后默认不做构建、截图、ROI 或自动化验证，以节省开发效率。只有用户明确要求验证、准备发布、或需要排查具体运行问题时才执行验证。
8. 现有本地改动无需询问，继续基于当前工作区修改；不要回滚用户或其他流程留下的改动。
9. mock 数据必须和源码布局分离。mock 只能改变运行状态，不能改变原始组件布局规则。

## 源码位置

- 原始提取包：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616`
- 原小游戏源码：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/source_raw/6A3BB7D3D4349E2050E7B701AAD51600_726750140f8084ebcbe5190fe9c198c9`
- 原始远程资源：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/raw`
- 转换 PNG 资源：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/converted_png`
- SpriteFrame 提取数据：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/spriteframes`
- Spine 区域图：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/spine_regions`

## 当前项目方向

- Cocos Creator 项目在 `CocosFarm/`。
- 当前重构以 Cocos Creator 3.8 为目标。
- 当前阶段不再用脚本覆盖生成整个场景；优先在 `CocosFarm/assets` 内按原 Cocos 源码证据直接调整组件、层级、资源和逻辑。