diff --git a/.ai/protocols/no-meta-files.md b/.ai/protocols/no-meta-files.md index 21dacd3d369..c5fe233c545 100644 --- a/.ai/protocols/no-meta-files.md +++ b/.ai/protocols/no-meta-files.md @@ -1,12 +1,13 @@ --- scope: always -description: 不生成 Unity meta 文件,不主动编译项目 +description: 默认不生成 Unity meta 文件;功能依赖时可生成;不主动编译项目 version: "1.0" updated: "2026-05-08" --- # Unity 项目约定 -- 不要生成 Unity 的 .meta 文件,留给 Unity 自己生成 +- 默认不要手动生成 Unity 的 .meta 文件,留给 Unity 自己生成 +- 如果新建场景、Prefab、脚本等资产需要稳定 GUID 引用,可以同步生成对应 .meta,并确保 GUID 唯一 - 不要主动编译项目,这是一个 Unity 项目,Unity 会自动进行编译 - 如果有编译错误用户会自主拷贝给你,但你可以做自己的静态代码检查 diff --git a/.ai/skills/compile-gameplay-dll/SKILL.md b/.ai/skills/compile-gameplay-dll/SKILL.md index e93febc79b7..8cbe670a323 100644 --- a/.ai/skills/compile-gameplay-dll/SKILL.md +++ b/.ai/skills/compile-gameplay-dll/SKILL.md @@ -7,6 +7,12 @@ updated: "2026-05-08" # Compile GamePlay DLL +## 触发规则 + +- 不要主动编译 GamePlay DLL。 +- 修改 `GamePlay/` 下代码后,只提醒用户需要编译 DLL。 +- 只有用户明确要求“编译 DLL / build DLL / 转换为 DLL / 执行 GamePlay.dll 编译”时,才执行本技能里的编译流程。 + 将 GamePlay 源码编译为 `GamePlay.dll`。 ## 前置知识 diff --git a/AGENTS.md b/AGENTS.md index 3b0991bff0c..1db7d3d3592 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -40,7 +40,7 @@ ProjectNLD/Assets/ 行为规则以 `.ai/protocols/` 为权威定义,包括: - `confirm-before-act.md` — 大量修改前确认 - `git-safety.md` — Git 操作安全规范 -- `no-meta-files.md` — Unity 项目约定(不生成 .meta、不主动编译) +- `no-meta-files.md` — Unity 项目约定(默认不生成 .meta;功能依赖时可生成;不主动编译) ## 技能系统与同步 - 技能定义唯一源位于 `.ai/skills/`,协议源位于 `.ai/protocols/`,Agent 定义源位于 `.ai/agents/` @@ -52,7 +52,7 @@ ProjectNLD/Assets/ | 技能 | 何时使用 | |------|---------| | `batch-git-ops` | 任何 Git 操作(pull/push/commit/checkout),必须读取并按流程执行 | -| `compile-gameplay-dll` | 修改了 `GamePlay/` 下任何代码后,需要编译 DLL | +| `compile-gameplay-dll` | 用户明确要求编译 DLL 时使用;修改 `GamePlay/` 后只提醒用户需要编译 | | `luban-config` | 涉及配置表的新增/修改,或需要理解 Luban 配置结构 | | `ui-prefab-dev` | 开发 UI 预制体、UI 界面相关功能 | | `knowledge-base` | 查询已知的最佳实践、性能优化案例、架构决策记录 | @@ -105,7 +105,7 @@ ProjectNLD/Assets/ - 遵循 C# 标准命名:类/方法 PascalCase,私有字段 `_camelCase`,常量 UPPER_SNAKE ### 行为约束 -- 不要生成 Unity `.meta` 文件,留给 Unity 自己生成 +- 默认不要手动生成 Unity `.meta` 文件;若新建场景/Prefab/脚本等资产需要稳定 GUID 引用,可以同步生成对应 `.meta`,并确保 GUID 唯一 - 不要主动编译项目(Unity 自动编译;可以做静态代码检查) - 图片资源处理时可自主决定是否查看图片内容,以获取尺寸、颜色、布局等信息 @@ -166,7 +166,7 @@ GamePlay 代码编译为独立 DLL,受以下限制: - 新增外部库需检查 AOT 兼容性 - 不要在 GamePlay 代码中引用 `Assembly-CSharp` 中的类型(除非已做 AOT 预留) - 使用 `ForceAOT.csproj` / `ScriptsAOT.csproj` 做 AOT 预留注册 -- 修改 GamePlay 代码后必须通过 Unity 菜单编译生成 DLL → 读取 `compile-gameplay-dll` 技能 +- 修改 GamePlay 代码后提醒用户需要通过 Unity 菜单编译生成 DLL;不要主动编译,除非用户明确要求 → 用户要求编译时读取 `compile-gameplay-dll` 技能 ## Git 操作 - 除非用户要求,AI 不做任何 git 提交相关操作 @@ -200,4 +200,4 @@ GamePlay 代码编译为独立 DLL,受以下限制: | AI | `GamePlay/AI/` | AI 行为树/军团/目标选择 | | Level | `GamePlay/Level/` | 关卡管理/状态/事件/引导 | | Net | `GamePlay/Net/` | 网络消息/Proto/Actor | -| Team | `GamePlay/Team/` | 队伍编辑/派遣/战斗编队 | \ No newline at end of file +| Team | `GamePlay/Team/` | 队伍编辑/派遣/战斗编队 |