docs(AGENTS): 更新调试与验证指南并移除冗余技能文档

- 将调试与验证部分简化为优先使用框架内置命令行工具
- 删除已整合的 CLI 命令参考技能文档,避免信息冗余
This commit is contained in:
augushong
2026-05-06 19:41:23 +08:00
parent 748307e826
commit 167dfe110e
2 changed files with 1 additions and 80 deletions

View File

@@ -1,78 +0,0 @@
---
name: "ulthon-cli-reference"
description: "Ulthon Admin 框架常用 CLI 命令速查手册包括菜单管理、Scheme 同步与 CURD 生成等命令说明。"
---
# CLI 命令参考文档
本文档提供 Ulthon Admin 框架的常用 CLI 命令速查手册。
## 何时调用
- 当需要查找 Ulthon Admin 特定的 CLI 命令如菜单管理、Scheme 同步、CURD 生成)及其参数时。
- 当需要验证或调试 CLI 命令功能时。
## 关键原则
- 菜单管理命令用于操作后台菜单结构,支持 JSON/Tree 格式输出。
- Scheme 与 CURD 命令用于保持数据库与代码的一致性,以及生成基础代码。
- CURD 操作建议先使用 `-r` 生成到临时目录进行预览。
- Scheme 同步操作涉及数据库变更,需谨慎使用。
## 菜单管理
| 命令 | 说明 | 常用参数 |
|------|------|----------|
| `admin:menu:list` | 列出菜单(树形) | `--format`, `--status`, `--pid` |
| `admin:menu:create` | 创建菜单 | - |
| `admin:menu:update` | 编辑菜单 | - |
| `admin:menu:delete` | 删除菜单 | - |
| `admin:menu:export` | 导出菜单数据 | `--format=json` |
## Scheme & CURD
| 命令 | 说明 | 常用参数 |
|------|------|----------|
| `scheme:sync` | 同步 Scheme 到数据库 | `--force` (跳过确认) |
| `scheme:make` | 从数据库生成 Scheme | `-t {table}` |
| `curd` | 生成 CURD 代码 | `-t {table}` `-r` (临时) `-f` (强制) `-d` (删除) |
### CURD 参数说明
| 参数 | 简写 | 说明 |
|------|------|------|
| `--table` | `-t` | 主表名(支持带前缀或不带前缀) |
| `--force` | `-f` | 强制覆盖模式(**谨慎使用** |
| `--delete` | `-d` | 删除模式(**删除生成的文件,不是数据库操作** |
| `--runtime` | `-r` | 临时生成模式(**推荐用于预览** |
| `--examples` | | 显示使用示例 |
## 快速示例
### 菜单管理
```bash
php think admin:menu:list # 查看菜单树
php think admin:menu:create # 创建菜单
php think admin:menu:export --format=json # 导出菜单
```
### CURD 操作
```bash
# 预览生成(推荐)
php think curd -t daka_record -r
# 正式生成
php think curd -t daka_record
# 强制覆盖(小心)
php think curd -t daka_record -f
```
## 注意事项
1. **表名参数**CURD 和 Scheme 命令的表名支持带前缀或不带前缀v2.x+ 自动检测)
2. **安全确认**`scheme:sync` 默认需要确认,使用 `-ff` 跳过
3. **临时生成**CURD 使用 `-r` 可生成到临时目录预览
4. **删除模式**CURD 的 `-d` 是删除生成的文件,不是数据库操作

View File

@@ -49,7 +49,7 @@
- 风格:遵循项目命名规范与 PSR格式化以仓库根目录 `.php-cs-fixer.php` 配置为准(不假设本机已安装工具)
- 权限:基于 `auth` 注解生成节点与鉴权;以角色为中心管理(角色、角色权限、用户角色);命令行使用见技能:[ulthon-permission-cli](./.agents/skills/ulthon-permission-cli/SKILL.md)
- 临时文件:智能体在任务中产生的临时文件(脚本、日志、缓存、产物等)统一输出到 `runtime/agents/`(可按智能体/任务再分子目录),不要放在仓库根目录;除非任务明确要求或框架约定位置属于根目录
- 调试与验证:框架内置了完善的功能验证能力可以通过命令行实现数据库操作、控制器的请求页面接口同体机制、模拟用户请求直接获得用户登录状态、日志管理、菜单管理、权限管理等等具体查看命令说明和agents技能。你可以利用这些机制直接实现功能的测试和验证无需借助各类数据库MCP、命令行脚本等方式。
- 调试与验证:优先使用框架内置命令行工具tools:http:call、tools:db:*、tools:log:*、admin:menu:*、admin:permission:*),不需要借助外部数据库 MCP 或临时脚本
### 标准开发流程Scheme + CURD默认必须执行
@@ -83,7 +83,6 @@
Skills 是“按场景调用的工作流说明”,统一以 `.agents/skills/*/SKILL.md` 为准;`.trae/skills/` 为 Trae 集成的镜像目录(内容保持同步)。
- 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)