docs: 更新AGENTS.md文档结构和内容

- 调整文档结构,将“开发规范与标准流程”改为指向具体表格和技能文件
- 删除已过时或冗余的后端、接口、风格等规则说明
- 保持核心项目规则不变,使文档更聚焦于当前实际工作流程
This commit is contained in:
augushong
2026-05-06 19:49:04 +08:00
parent c8f606e809
commit 8ed88c99b5

View File

@@ -2,7 +2,7 @@
- `AGENTS.md`(本文件):协作规则入口与导航
- `.agents/`工作流skills与补充文档含业务侧规则`.agents/AGENTS.md`
- 开发规范与标准流程:已整合到本文件「项目级规则」中
- 标准开发流程:见「标准开发流程」表格,操作细节见对应技能文件
## 项目级规则(最高优先级 / 唯一权威)
@@ -40,13 +40,10 @@
### 其他规则
- 数据库:表结构优先 Scheme`app/admin/scheme/`);避免 ENUMtools: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 或临时脚本