mirror of
https://gitee.com/ulthon/ulthon_admin.git
synced 2026-07-01 15:32:48 +08:00
docs: 将智能体目录名从 .agent 更新为 .agents
更新 AGENTS.md 文档中所有对智能体目录的引用，确保一致性。此次变更为纯文档更新，不影响任何代码功能。
This commit is contained in:
augushong
44
AGENTS.md
44
AGENTS.md
@@ -1,7 +1,7 @@
|
||||
# 智能体协作规范（Ulthon Admin）
|
||||
|
||||
- `AGENTS.md`（本文件）：协作规则入口与导航
|
||||
- `.agent/`：工作流（skills）与补充文档（含业务侧规则：`.agent/AGENTS.md`）
|
||||
- `.agents/`：工作流（skills）与补充文档（含业务侧规则：`.agents/AGENTS.md`）
|
||||
- 开发规范与标准流程：已整合到本文件「项目级规则」中
|
||||
|
||||
## 项目级规则（最高优先级 / 唯一权威）
|
||||
@@ -86,8 +86,8 @@
|
||||
- 配套资源与多端代码：统一放在 `source/`；不影响现有 PHP/ThinkPHP 主工程运行与发布；目录约定与安全要求见 `source/README.md`（禁止提交构建产物、依赖目录等）
|
||||
- 接口：如果需要实现接口能力，需要利用框架的“页面接口同体机制”，框架支持直接所有“页面输出”改为“json输出”。
|
||||
- 风格：遵循项目命名规范与 PSR；格式化以仓库根目录 `.php-cs-fixer.php` 配置为准（不假设本机已安装工具）
|
||||
- 权限：基于 `auth` 注解生成节点与鉴权；以角色为中心管理（角色、角色权限、用户角色）；命令行使用见技能：[ulthon-permission-cli](./.agent/skills/ulthon-permission-cli/SKILL.md)
|
||||
- 临时文件：智能体在任务中产生的临时文件（脚本、日志、缓存、产物等）统一输出到 `runtime/agent/`（可按智能体/任务再分子目录），不要放在仓库根目录；除非任务明确要求或框架约定位置属于根目录
|
||||
- 权限：基于 `auth` 注解生成节点与鉴权；以角色为中心管理（角色、角色权限、用户角色）；命令行使用见技能：[ulthon-permission-cli](./.agents/skills/ulthon-permission-cli/SKILL.md)
|
||||
- 临时文件：智能体在任务中产生的临时文件（脚本、日志、缓存、产物等）统一输出到 `runtime/agents/`（可按智能体/任务再分子目录），不要放在仓库根目录；除非任务明确要求或框架约定位置属于根目录
|
||||
- 调试与验证：框架内置了完善的功能验证能力，可以通过命令行实现数据库操作、控制器的请求（页面接口同体机制）、模拟用户请求（直接获得用户登录状态）、日志管理、菜单管理、权限管理等等，具体查看命令说明和agents技能。你可以利用这些机制直接实现功能的测试和验证，无需借助各类数据库MCP、命令行脚本等方式。
|
||||
|
||||
### 标准开发流程（Scheme + CURD，默认必须执行）
|
||||
@@ -129,35 +129,35 @@
|
||||
本仓库的规则分两类：
|
||||
|
||||
- **框架基础规则（稳定）**：根目录 `AGENTS.md`（本文件）中的「项目级规则」为唯一权威；默认不随任务动态增长。
|
||||
- **使用者补充规则（业务侧）**：开发中用户/开发者补充的“项目规则/团队偏好/临时约束”，统一记录到 [.agent/AGENTS.md](./.agent/AGENTS.md)。
|
||||
- **使用者补充规则（业务侧）**：开发中用户/开发者补充的“项目规则/团队偏好/临时约束”，统一记录到 [.agents/AGENTS.md](./.agents/AGENTS.md)。
|
||||
|
||||
维护约束（必须遵守）：
|
||||
|
||||
- 智能体以“框架作者”身份开发时，如需新增/调整规则，必须先与开发者确认是否记录、记录位置与具体写法，并按确认结果落到对应规则文件。
|
||||
- 智能体以“使用框架的开发者”身份执行任务时，如发现需要记录或调整的项目约束，应更新到对应规则文件（业务侧约束优先记录到 `.agent/AGENTS.md`），并可按开发者要求随时调整。
|
||||
- 智能体以“使用框架的开发者”身份执行任务时，如发现需要记录或调整的项目约束，应更新到对应规则文件（业务侧约束优先记录到 `.agents/AGENTS.md`），并可按开发者要求随时调整。
|
||||
|
||||
## 工作流（Skills）
|
||||
|
||||
Skills 是“按场景调用的工作流说明”，统一以 `.agent/skills/*/SKILL.md` 为准；`.trae/skills/` 为 Trae 集成的镜像目录（内容保持同步）。
|
||||
Skills 是“按场景调用的工作流说明”，统一以 `.agents/skills/*/SKILL.md` 为准；`.trae/skills/` 为 Trae 集成的镜像目录（内容保持同步）。
|
||||
|
||||
- 扩展内置能力（继承与重写）：[ulthon-core-extend-pattern](./.agent/skills/ulthon-core-extend-pattern/SKILL.md)
|
||||
- Base/App 架构指南：[ulthon-base-app-architecture](./.agent/skills/ulthon-base-app-architecture/SKILL.md)
|
||||
- CLI 命令参考文档：[ulthon-cli-reference](./.agent/skills/ulthon-cli-reference/SKILL.md)
|
||||
- Scheme + CURD 工作流：[ulthon-scheme-curd-workflow](./.agent/skills/ulthon-scheme-curd-workflow/SKILL.md)
|
||||
- Scheme 定义指南：[ulthon-scheme-definition](./.agent/skills/ulthon-scheme-definition/SKILL.md)
|
||||
- 数据库调试命令（tools:db）：[ulthon-db-tools-debug](./.agent/skills/ulthon-db-tools-debug/SKILL.md)
|
||||
- HTTP 调用工具（tools:http:call）：[ulthon-tools-http-call](./.agent/skills/ulthon-tools-http-call/SKILL.md)
|
||||
- 日志命令（tools:log）：[ulthon-tools-log](./.agent/skills/ulthon-tools-log/SKILL.md)
|
||||
- 内置定时器与定时任务扩展：[ulthon-timer](./.agent/skills/ulthon-timer/SKILL.md)
|
||||
- 页面 / 接口同体：[ulthon-page-api-dual-mode](./.agent/skills/ulthon-page-api-dual-mode/SKILL.md)
|
||||
- 登录认证（Session + Token）：[ulthon-auth-session-token](./.agent/skills/ulthon-auth-session-token/SKILL.md)
|
||||
- 权限与角色管理（RBAC CLI）：[ulthon-permission-cli](./.agent/skills/ulthon-permission-cli/SKILL.md)
|
||||
- 菜单管理（admin:menu:\* CLI）：[ulthon-admin-menu-cli](./.agent/skills/ulthon-admin-menu-cli/SKILL.md)
|
||||
- ThinkPHP 控制器 URL 规则：[tp-controller-url-rules](./.agent/skills/tp-controller-url-rules/SKILL.md)
|
||||
- 扩展内置能力（继承与重写）：[ulthon-core-extend-pattern](./.agents/skills/ulthon-core-extend-pattern/SKILL.md)
|
||||
- Base/App 架构指南：[ulthon-base-app-architecture](./.agents/skills/ulthon-base-app-architecture/SKILL.md)
|
||||
- CLI 命令参考文档：[ulthon-cli-reference](./.agents/skills/ulthon-cli-reference/SKILL.md)
|
||||
- Scheme + CURD 工作流：[ulthon-scheme-curd-workflow](./.agents/skills/ulthon-scheme-curd-workflow/SKILL.md)
|
||||
- Scheme 定义指南：[ulthon-scheme-definition](./.agents/skills/ulthon-scheme-definition/SKILL.md)
|
||||
- 数据库调试命令（tools:db）：[ulthon-db-tools-debug](./.agents/skills/ulthon-db-tools-debug/SKILL.md)
|
||||
- HTTP 调用工具（tools:http:call）：[ulthon-tools-http-call](./.agents/skills/ulthon-tools-http-call/SKILL.md)
|
||||
- 日志命令（tools:log）：[ulthon-tools-log](./.agents/skills/ulthon-tools-log/SKILL.md)
|
||||
- 内置定时器与定时任务扩展：[ulthon-timer](./.agents/skills/ulthon-timer/SKILL.md)
|
||||
- 页面 / 接口同体：[ulthon-page-api-dual-mode](./.agents/skills/ulthon-page-api-dual-mode/SKILL.md)
|
||||
- 登录认证（Session + Token）：[ulthon-auth-session-token](./.agents/skills/ulthon-auth-session-token/SKILL.md)
|
||||
- 权限与角色管理（RBAC CLI）：[ulthon-permission-cli](./.agents/skills/ulthon-permission-cli/SKILL.md)
|
||||
- 菜单管理（admin:menu:\* CLI）：[ulthon-admin-menu-cli](./.agents/skills/ulthon-admin-menu-cli/SKILL.md)
|
||||
- ThinkPHP 控制器 URL 规则：[tp-controller-url-rules](./.agents/skills/tp-controller-url-rules/SKILL.md)
|
||||
|
||||
## 智能体指导
|
||||
|
||||
使用命令可以将内置智能体规则应用到各类智能体中。设计规则时以 AGENTS.md 和 `.agent/` 目录为主。
|
||||
使用命令可以将内置智能体规则应用到各类智能体中。设计规则时以 AGENTS.md 和 `.agents/` 目录为主。
|
||||
|
||||
php think tools:agent:publish
|
||||
|
||||
@@ -179,7 +179,7 @@ ulthon_admin/
|
||||
├── database/ # 数据库迁移与种子
|
||||
├── source/ # 多端客户端代码（uni-app、Vue）
|
||||
│ └── clients/uniapp/ # uni-app 前端工程
|
||||
└── .agent/ # 智能体技能与规则
|
||||
└── .agents/ # 智能体技能与规则
|
||||
```
|
||||
|
||||
## 快速命令参考
|
||||
|
||||
Reference in New Issue
Block a user