From a8b1518b7a6bb3e2f3af2c7f866373957062c1d7 Mon Sep 17 00:00:00 2001 From: liutao <821580467@qq.com> Date: Tue, 31 Mar 2026 19:05:25 +0800 Subject: [PATCH] =?UTF-8?q?=E3=80=90copilot=E3=80=91=E5=A2=9E=E5=8A=A0copi?= =?UTF-8?q?lot=E4=BD=BF=E7=94=A8=E7=9A=84Agents.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ProjectNLD/AGENTS.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 ProjectNLD/AGENTS.md diff --git a/ProjectNLD/AGENTS.md b/ProjectNLD/AGENTS.md new file mode 100644 index 00000000000..3b9cd47d3db --- /dev/null +++ b/ProjectNLD/AGENTS.md @@ -0,0 +1,42 @@ +# AGENTS.md + +# 在执行大量代码修改之前,先和用户确认设计思路再继续执行 + +# 编码要求 +使用面向对象的设计思路 +单个文件/模块尽可能小且功能单一 + +## 一般准则 +- 按要求去做,不扩展额外的功能 +- 不要生成unity的meta文件,留给unity自己生成 +- 不要主动编译项目, 这是一个unity项目, unity会自动进行编译, 如果有编译错误用户会自主拷贝给你, 但是你可以做自己的静态代码检查 +- 如果有疑问主动向用户确认 +- 除非用户要求特别清晰,开始编码行为之前,将你的计划描述给用户并获得用户确认后才开始行动(收集信息等操作或者编写plan不用) + +## 图片资源处理 +- 当任务涉及设计图片资源(如 UI 贴图、图标、背景图等)时,AI 可以自主决定是否查看图片内容,以获取更多有用信息(如尺寸、颜色、布局、风格等),从而更好地完成任务 + +## 编辑器开发 +- 使用Odin工具开发编辑器 + +## git操作 +- 除非用户要求,AI不做任何git提交相关操作 +- 当用户让AI操作git时提醒用户git操作有风险 +- **重要**:本项目有三个关联的 Git 仓库(见下方"项目仓库结构"),任何 git 操作(pull/push/commit/checkout 等)都必须同时考虑三个仓库的同步对齐,务必读取 `batch-git-ops` skill 后按其流程执行 + +## 项目仓库结构 + +本项目包含三个独立的 Git 仓库,路径相对于 workspace 根目录(ProjectNLD): + +| 仓库 | 相对路径 | 定位 | +|------|---------|------| +| **NLDClient** | `../../` | 游戏客户端主仓库,包含 Unity 项目配置、资源、框架代码等 | +| **NLDMisc** | `../../../NLDMisc` | 配置表相关仓库,存放游戏参数、数值配置等数据 | +| **GamePlay** | `Assets/Code/Scripts/GamePlay` | 核心游戏逻辑代码仓库,编译产物为 `GamePlay_Dll/GamePlay.dll` | + +- 执行 git 操作时必须明确区分当前操作的是哪个仓库,不要混淆仓库边界 +- 查找或修改代码时注意文件属于哪个仓库,避免在错误的仓库中操作 + +# 其他 +- `Assets/Code/Scripts/GamePlay_Dll/GamePlay.dll` 对应的源码仓库在 `Assets/Code/Scripts/GamePlay` 中(独立 Git 仓库) +- 不要主动编译项目, 这是一个unity项目, unity会自动进行编译, 如果有编译错误用户会自主拷贝给你, 但是你可以做自己的静态代码检查 \ No newline at end of file