From 167dfe110eaaede3f50c1a0fb27ebda0fdd1c98e Mon Sep 17 00:00:00 2001 From: augushong Date: Wed, 6 May 2026 19:41:23 +0800 Subject: [PATCH] =?UTF-8?q?docs(AGENTS):=20=E6=9B=B4=E6=96=B0=E8=B0=83?= =?UTF-8?q?=E8=AF=95=E4=B8=8E=E9=AA=8C=E8=AF=81=E6=8C=87=E5=8D=97=E5=B9=B6?= =?UTF-8?q?=E7=A7=BB=E9=99=A4=E5=86=97=E4=BD=99=E6=8A=80=E8=83=BD=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 将调试与验证部分简化为优先使用框架内置命令行工具 - 删除已整合的 CLI 命令参考技能文档，避免信息冗余 --- .agents/skills/ulthon-cli-reference/SKILL.md | 78 -------------------- AGENTS.md | 3 +- 2 files changed, 1 insertion(+), 80 deletions(-) delete mode 100644 .agents/skills/ulthon-cli-reference/SKILL.md diff --git a/.agents/skills/ulthon-cli-reference/SKILL.md b/.agents/skills/ulthon-cli-reference/SKILL.md deleted file mode 100644 index 28040da..0000000 --- a/.agents/skills/ulthon-cli-reference/SKILL.md +++ /dev/null @@ -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` 是删除生成的文件，不是数据库操作 diff --git a/AGENTS.md b/AGENTS.md index 764d68d..8cd8279 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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)