# Skill Audit: api-test **审计目标**: `/home/ubuntu/ccWorkDir/.claude/skills/api-test/SKILL.md` **审计时间**: 2026-06-25 **审计者**: .claude/ skill 审计子代理 (Batch H) **对照基准**: dacli v0.11+ 已重构命令 + 30+ NEW-CMD (见 v0.11-next-steps-plan.md §11.4) --- ## 1. 技能定位 > JNPF API 集成测试 - curl + jq 调 JNPF 后端, dacli 提供登录态和业务命令封装 --- ## 2. 命令引用清单 (按行号) | 行号 | 命令 | 上下文 | 状态 | |------|------|--------|------| | 20 | `dacli app login --account=admin --password=123456 --appCode=tds` | 登录 | ✅ 有效 | | 21 | `dacli app status` | 查登录态 | ✅ 有效 | | 34-35 | `jq -r .token/.appCode $ccWorkDir/.dacli-token/token.json` | 读 token | ✅ 有效 | | 38-40 | `curl ... -H "App-Code: ..." -H "Authorization: ..."` | 调 API | ✅ 有效 | | 47-67 | `curl -X POST/PUT/DELETE` | CRUD 测试 | ✅ 有效 | | 78 | `dacli form list` | 等价于 `dacli test list` | ✅ 有效 | | 79 | `dacli form info ` (位置参数) | 查表单 | ✅ 有效 | | 80 | `dacli form create --fullName=... --enCode=... --type=...` | 创建表单 | ✅ 有效 | | 81-84 | `dacli form list` / `dacli menu list` / `dacli user list` / `dacli tool logs` | 业务命令 | ✅ 有效 | | 93-110 | `curl + jq` 提取字段 | 通用模式 | ✅ 有效 | | 120-128 | `dacli form create + curl 验证` | 组合模式 | ✅ 有效 | | 131-141 | `bash` 循环测 | 脚本模式 | ✅ 有效 | | 146-153 | `curl + 状态码检测` | token 过期检测 | ✅ 有效 | | 152 | `dacli app login --account=admin --password=<密码> --appCode=$APP_CODE` | 重新登录 | ✅ 有效 | | 162-163 | `playwright -s=dacli open/eval` | UI 测试 | ✅ 有效 | | 166-168 | `curl` 验证数据 | API 验证 | ✅ 有效 | | 177-179 | `dacli app login --account=admin --password=123456 --appCode=tds` | 登录 | ✅ 有效 | | 186-188 | `curl` 检查登录态 | 检查模式 | ✅ 有效 | | 204-224 | 完整 CRUD 流程 | 端到端示例 | ✅ 有效 | | 210 | `dacli form info ` | 查表单 | ✅ 有效 | | 213-216 | `dacli form create --fullName=... --enCode=test_form --type=1 --webType=2` | 创建表单 | ✅ 有效 | | 218 | `dacli form release ` | 发布表单 | ✅ 有效 | | 221-224 | `curl` 验证 | API 验证 | ✅ 有效 | | 229-231 | `dacli workflow list/launch` | 工作流测试 | ✅ 有效 | **命令总数**: 30+ 处 dacli + curl 引用 --- ## 3. v0.11+ 已重构命令引用检测 ### 3.1 已重构/已 webapi 化命令 | 命令 | 当前引用 | 实际状态 (v0.11+) | 影响 | |------|----------|-------------------|------| | `dacli app login` | L20, L152, L179 | v0.11+ 仍有效 | 无影响 | | `dacli app status` | L21 | v0.11+ 仍有效 | 无影响 | | `dacli form list` | L78, L81, L207 | v0.11+ webapi 化 | 无影响 | | `dacli form info` | L79, L210 | v0.11+ webapi 化 | ✅ 已用位置参数 | | `dacli form create` | L80, L120, L213 | v0.11+ webapi 化 (c98bf2b) | 无影响 | | `dacli form release` | L218 | v0.11+ webapi 化 | 无影响 | | `dacli menu list` | L82 | v0.11+ webapi 化 (c7b24eb) | 无影响 | | `dacli user list` | L83 | v0.11+ webapi 化 (7224156) | ✅ 标注 v0.7+ | | `dacli tool logs` | L84 | v0.11+ 仍有效 | 无影响 | | `dacli workflow list` | L229 | v0.11+ webapi 化 (5ec47e3+4669e35) | 无影响 | | `dacli workflow launch` | L231 | v0.11+ 仍有效 | 无影响 | ### 3.2 旧端点引用 **未发现旧端点引用** (所有命令已 webapi 化或仍有效) ### 3.3 已废弃命令引用 **未发现已 @deprecated 命令引用** (L8 已明确移除 `dacli test` 旧命令, ✅) ### 3.4 旧端点 + 旧模式引用 | 引用 | 状态 | 备注 | |------|------|------| | L8 标注 "dacli test" 已废弃 | ✅ 已标注 | 正确反映 v0.11+ 状态 | | L78-84 表格 (旧 dacli test → 新写法) | ✅ 已同步 | 表格已完整映射 | --- ## 4. 缺 NEW-CMD 章节 ### 4.1 严重缺失的 v0.11+ 新命令 (P0) | 缺失命令 | 应在位置 | 缺失原因 | |----------|----------|----------| | **`dacli form update`** | L218 后 (form release 之后) | API 测试时改 form schema 必用 | | **`dacli log exception`** | L84 后 (tool logs 之后) | API 调试必看后端异常 | | **`dacli log request`** | 同上 | API 请求日志 | | **`dacli workflow info/update/delete`** | L229 后 | 工作流 CRUD 闭环 | | **`dacli di info/test/update/delete`** | 全文未提 | 数据接口 CRUD 闭环 | | **`dacli role info/update/selector`** | 全文未提 | 权限相关 API 测试 | | **`dacli menu info/delete** | L82 后 | 菜单管理 | | **`dacli apis tags`** | 全文未提 | 查 API 标签 | | **`dacli apis search --field=`** | 全文未提 | 字段级搜索 | | **`dacli monitor server`** | 全文未提 | 性能监控 API | ### 4.2 缺 v0.11+ 架构说明章节 **应在 L8 后加 1 段**: ```markdown > 📦 **dacli v0.11+ webapi 镜像架构 (2026-06-25)**:所有 form/menu/dict/dm/role/log/monitor/schedule/msg/di/workflow/user 命令已 webapi 化 (18 模块, 100+ 函数), 0 复刻 0 漂移。API 测试时优先用 dacli 业务命令, 必要时辅以 curl + jq 验证返回结构。 ``` --- ## 5. 优先级修复清单 ### 5.1 P0 (必修, 阻塞 API 测试) 1. **加 `dacli log exception/request` 章节** (L84 后, API 调试核心) 2. **加 `dacli form update` 章节** (L218 后, 改 form schema 必用) 3. **加 `dacli workflow info/update/delete` 章节** (L229 后, 流程 CRUD 闭环) 4. **加 `dacli di info/test/update/delete` 章节** (L80 后, DI 闭环) 5. **加 v0.11+ webapi 架构段** (L8 后) ### 5.2 P1 (同步, 提升 API 测试效率) 6. **加 `dacli apis search --field=` 段** (全文, 字段级搜索) 7. **加 `dacli apis tags` 段** (全文, 查 API 标签) 8. **加 `dacli role info/update/selector` 段** (全文, 权限 API 测试) 9. **加 `dacli menu info/delete` 段** (L82 后, 菜单 CRUD) ### 5.3 P2 (增强, 按需补) 10. **加 `dacli monitor server` 段** (全文, 性能监控 API) 11. **加 `dacli user create/delete` 段** (L83 后, 用户 CRUD) 12. **加 `dacli doc toc/search` 段** (全文, 文档搜索) --- ## 6. 具体修复建议 (示例) ### 6.1 L84 后加 log exception 段 (P0) ```bash # v0.11+ 新增 (P0 必读): 后端异常日志 (API 调试核心) dacli log exception --lines=20 dacli log exception --keyword="" # 按关键字过滤 dacli log request --lines=10 # API 请求日志 ``` ### 6.2 L218 后加 form update 段 (P0) ```bash # v0.11+ form 改名 / 增量改 schema (无需 export→改→import) dacli form update --fullName="新名" dacli form update --enCode="new_code" --autoRelease ``` ### 6.3 L229 后加 workflow info/update/delete 段 (P0) ```bash # v0.11+ workflow CRUD 闭环 dacli workflow info # 查详情 dacli workflow update --fullName="新名" # 改名 dacli workflow delete --yes # 删 ``` ### 6.4 L8 后加 v0.11+ 架构段 (P0) ```markdown > 📦 **dacli v0.11+ webapi 镜像架构 (2026-06-25)**:所有 form/menu/dict/dm/role/log/monitor/schedule/msg/di/workflow/user 命令已 webapi 化 (18 模块, 100+ 函数), 0 复刻 0 漂移。API 测试时优先用 dacli 业务命令, 必要时辅以 curl + jq 验证返回结构。L1+L2 防御已覆盖 22 条高频盲点。 ``` ### 6.5 扩展 L78-84 表格 (P1) 加以下行: | 旧 `dacli test ...` | 新写法 | |---------------------|--------| | `dacli test workflow list` | `dacli workflow list` | | `dacli test di info` | `dacli di info ` (v0.11+ 新增) | | `dacli test di test` | `dacli di test --params='...'` (v0.11+ 新增) | | `dacli test log exception` | `dacli log exception` (v0.11+ 新增) | --- ## 7. 整体评价 **健康度**: 中等偏高 - 30+ 处 dacli + curl 引用, 模式清晰 - L8 已正确标注 v0.11+ 变更 (移除 `dacli test`) - L78-84 表格已正确映射旧→新命令 - 缺 10+ 个 v0.11+ 新命令 (P0 缺失较多) - 缺 v0.11+ webapi 架构说明 - 位置参数已用 `` 而非 `--id=` (✅) - 未引用已废弃命令 (✅) - 未引用旧端点 (✅) **修复预计工作量**: 1-1.5 小时 - P0 必修 5 项: 1 小时 - P1 同步 4 项: 20 分钟 - P2 增强 3 项: 10 分钟 **建议**: 标记为 P0 必修, 在 Phase 3 Batch H 主代理执行时同步修复