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