mirror of
https://gitee.com/ulthon/ulthon_admin.git
synced 2026-07-01 15:32:48 +08:00
docs: 更新AGENTS.md文档结构和内容
- 调整文档结构,将“开发规范与标准流程”改为指向具体表格和技能文件 - 删除已过时或冗余的后端、接口、风格等规则说明 - 保持核心项目规则不变,使文档更聚焦于当前实际工作流程
This commit is contained in:
@@ -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 或临时脚本
|
||||
|
||||
Reference in New Issue
Block a user