From 885b00e2d2a83c383f6ec82b4835c14d136be01d Mon Sep 17 00:00:00 2001 From: augushong Date: Mon, 14 Sep 2026 12:28:59 +0000 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E4=BF=AE=E6=AD=A3=E5=AF=B9?= =?UTF-8?q?=E5=B7=B2=E9=80=80=E5=BD=B9=20AdminInitServiceBase=20=E4=B8=8E?= =?UTF-8?q?=20AGENTS.md=20=E6=97=A7=E7=AB=A0=E8=8A=82=E5=90=8D=E7=9A=84?= =?UTF-8?q?=E5=A4=B1=E6=95=88=E5=BC=95=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/rules/ulthon-file-override-mechanism.md | 2 +- .agents/skills/ulthon-base-app-architecture/SKILL.md | 2 +- .agents/skills/ulthon-rules-manager/SKILL.md | 8 ++++---- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/.agents/rules/ulthon-file-override-mechanism.md b/.agents/rules/ulthon-file-override-mechanism.md index f42806f..380150d 100644 --- a/.agents/rules/ulthon-file-override-mechanism.md +++ b/.agents/rules/ulthon-file-override-mechanism.md @@ -63,7 +63,7 @@ Ulthon Admin 在"类继承覆盖"之外，还提供"文件级覆盖"能力：业 下列路径与机制都不走 app/base 覆盖，业务侧在 `app/` 下放同名文件**不会**生效： -- `AdminInitServiceBase::requireData()`（`extend/base/admin/service/AdminInitServiceBase.php:139`）：用 `__DIR__` 直接定位 `extend/base/admin/service/adminInitData/`，不支持 app 覆盖 +- `InitDataAlignServiceBase` / `MenuAlignServiceBase` 的快照定位：用 `__DIR__` 直接定位 `extend/base/admin/service/adminInitData/`，不支持 app 覆盖 - 命令注册（`config/console.php`）：空 `commands` 数组，命令通过 SPI 自动扫描 `app/common/command/`，不走覆盖 - 语言包（`config/lang.php`）：标准 ThinkPHP 机制，不支持 app/base 覆盖 - 路由（`route/app.php`）：空文件，无覆盖机制 diff --git a/.agents/skills/ulthon-base-app-architecture/SKILL.md b/.agents/skills/ulthon-base-app-architecture/SKILL.md index 6e8c17d..f6f8204 100644 --- a/.agents/skills/ulthon-base-app-architecture/SKILL.md +++ b/.agents/skills/ulthon-base-app-architecture/SKILL.md @@ -101,7 +101,7 @@ description: "详细说明了 Base/App 双层架构的设计理念、三层结 - 模板内 `{include}` 标签（与视图同源的三级查找） - `app_file_path()` 辅助函数显式加载的文件（两级回退：`app/<相对路径>` → `extend/base/<相对路径>`） -注意：文件级覆盖只对**特定类型**的文件生效。命令、语言包、路由、`config/*`、`public/static/*`、`AdminInitServiceBase::requireData()` 等均**不支持**——业务侧在 `app/` 下放同名文件不会生效。 +注意：文件级覆盖只对**特定类型**的文件生效。命令、语言包、路由、`config/*`、`public/static/*`、初始化数据快照对齐服务的 `__DIR__` 定位（`InitDataAlignServiceBase`、`MenuAlignServiceBase`）等均**不支持**——业务侧在 `app/` 下放同名文件不会生效。 完整的机制说明、7 处已知调用点清单与反例，见规则：[ulthon-file-override-mechanism](../../rules/ulthon-file-override-mechanism.md)。 diff --git a/.agents/skills/ulthon-rules-manager/SKILL.md b/.agents/skills/ulthon-rules-manager/SKILL.md index 3c1b23c..cd45cbd 100644 --- a/.agents/skills/ulthon-rules-manager/SKILL.md +++ b/.agents/skills/ulthon-rules-manager/SKILL.md @@ -131,7 +131,7 @@ Rules 可包含以下类型的内容： 新增规则后，更新一处索引（根 `AGENTS.md`）： -- `ulthon-` 前缀的规则：在「零散规则」章节的「框架内置规则索引」表中新增一行。 +- `ulthon-` 前缀的规则：在「规则与技能」章节的「框架规则速览」表中新增一行。 - `project-` 前缀的规则：在「项目信息」节的规则索引清单中新增一行。 若「项目信息」节尚无规则索引清单，提醒开发者建立（索引是建议项，非硬性要求）。索引缺失时，`.agents/rules/` 目录的 `project-` 前缀约定仍可被发现，作为兜底。 @@ -144,7 +144,7 @@ Rules 可包含以下类型的内容： 智能体在以下场景应主动查阅 `.agents/rules/`： -1. 首次接触项目时，先看 `AGENTS.md` 的「框架内置规则索引」了解框架规则，再看根 `AGENTS.md` 的「项目信息」节中的规则索引（如有）了解项目业务规则 +1. 首次接触项目时，先看 `AGENTS.md` 「规则与技能」章节的「框架规则速览」表了解框架规则，再看根 `AGENTS.md` 的「项目信息」节中的规则索引（如有）了解项目业务规则 2. 涉及特定模块开发时，查找该模块是否有对应的规则文件 3. 用户提到某个模块有特殊约束时，查找对应规则 @@ -152,8 +152,8 @@ Rules 可包含以下类型的内容： - 规则内容变更时，同步更新文件内容和索引中的说明列 - 规则过期时，标记为"已废弃"或直接删除，并从索引中移除 -- 框架更新时，只操作 `ulthon-` 前缀的规则文件与 AGENTS.md 的「框架内置规则索引」，不动 `project-` 前缀的文件 -- 项目业务规则维护时，只操作 `project-` 前缀的规则文件与 AGENTS.md 项目信息节的规则索引，不动 `ulthon-` 前缀的文件与「框架内置规则索引」 +- 框架更新时，只操作 `ulthon-` 前缀的规则文件与 AGENTS.md 的「框架规则速览」表，不动 `project-` 前缀的文件 +- 项目业务规则维护时，只操作 `project-` 前缀的规则文件与 AGENTS.md 项目信息节的规则索引，不动 `ulthon-` 前缀的文件与「框架规则速览」表 ## 索引格式