From 8ed88c99b5cfffe2870f368f041bd69b4a045e25 Mon Sep 17 00:00:00 2001 From: augushong Date: Wed, 6 May 2026 19:49:04 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0AGENTS.md=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E7=BB=93=E6=9E=84=E5=92=8C=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 调整文档结构，将“开发规范与标准流程”改为指向具体表格和技能文件 - 删除已过时或冗余的后端、接口、风格等规则说明 - 保持核心项目规则不变，使文档更聚焦于当前实际工作流程 --- AGENTS.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 65ded3a..b2e1d49 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ - `AGENTS.md`（本文件）：协作规则入口与导航 - `.agents/`：工作流（skills）与补充文档（含业务侧规则：`.agents/AGENTS.md`） -- 开发规范与标准流程：已整合到本文件「项目级规则」中 +- 标准开发流程：见「标准开发流程」表格，操作细节见对应技能文件 ## 项目级规则（最高优先级 / 唯一权威） @@ -40,13 +40,10 @@ ### 其他规则 - 数据库：表结构优先 Scheme（`app/admin/scheme/`）；避免 ENUM；tools:db 用于调试，不用于“设计表结构” -- 后端：代码优先使用CURD机制生成。 - 前端：视图与脚本同名配对（`*.html` + 同名 `*.js`），并按模块维护 `_common.js` - 配套资源与多端代码：统一放在 `source/`；不影响现有 PHP/ThinkPHP 主工程运行与发布；目录约定与安全要求见 `source/README.md`（禁止提交构建产物、依赖目录等） - 部署栈模式：`source/stack/` 为模式文件统一目录（含 `default/` 与各模式目录）；`default/` 必须与代码库默认行为一致；默认行为相关文件变更时需同步更新 `source/stack/default/` 对应文件 - 命令执行环境：执行 `php think` 命令前，通过 `php think admin:stack:mode current` 检测当前模式；若为 `docker-dev`，所有 `php think` 命令前缀改为 `docker compose exec ulthon_admin`（如 `docker compose exec ulthon_admin php think tools:http:call`）；其他模式（default/full/base-build）直接在宿主机执行 `php think`，不做转换 -- 接口：如果需要实现接口能力，需要利用框架的“页面接口同体机制”，框架支持直接所有“页面输出”改为“json输出”。 -- 风格：遵循项目命名规范与 PSR；格式化以仓库根目录 `.php-cs-fixer.php` 配置为准（不假设本机已安装工具） - 权限：基于 `auth` 注解生成节点与鉴权；以角色为中心管理（角色、角色权限、用户角色）；命令行使用见技能：[ulthon-permission-cli](./.agents/skills/ulthon-permission-cli/SKILL.md) - 临时文件：智能体在任务中产生的临时文件（脚本、日志、缓存、产物等）统一输出到 `runtime/agents/`（可按智能体/任务再分子目录），不要放在仓库根目录；除非任务明确要求或框架约定位置属于根目录 - 调试与验证：优先使用框架内置命令行工具（tools:http:call、tools:db:*、tools:log:*、admin:menu:*、admin:permission:*），不需要借助外部数据库 MCP 或临时脚本