# Skill Audit: backend-dev **审计目标**: `/home/ubuntu/ccWorkDir/.claude/skills/backend-dev/SKILL.md` **审计时间**: 2026-06-25 **审计者**: .claude/ skill 审计子代理 (Batch H) **对照基准**: dacli v0.11+ 已重构命令 + 30+ NEW-CMD (见 v0.11-next-steps-plan.md §11.4) --- ## 1. 技能定位 > 后端业务类开发技能。业务操作类命名、代码生成路径、数据接口验证。 --- ## 2. 命令引用清单 (按行号) | 行号 | 命令 | 上下文 | 状态 | |------|------|--------|------| | 32 | `dacli tool logs --level=info --lines=20` | 查日志 | ✅ 有效 | | 111 | `dacli di create --name=<名称> --enCode=<编码> --sql=` | 创建 DI | ⚠️ **缺 v0.11+ 更新** | | 112 | `dacli di preview --id=<接口ID>` | 预览 DI | ⚠️ **可能已 deprecated** | | 310 | `dacli form list` | 测业务 API | ✅ 有效 | | 311 | `dacli dm list --dbLinkId=` | 查数据模型 | ✅ 有效 | | 314-317 | `curl ... -H "App-Code: ..."` | 直接调 API | ✅ 有效 | | 352 | `dacli form codegen` v0.11+ 生成 PascalCase 后端 | 代码生成 | ✅ 有效 (已 v0.11+ 标注) | | 364 | `dacli apis info "POST /api/xxx/xxx"` | 查 API 字段 | ✅ 有效 | **命令总数**: 8 处 dacli 引用 (含 1 处 curl 间接) --- ## 3. v0.11+ 已重构命令引用检测 ### 3.1 已重构/已 webapi 化命令 | 命令 | 当前引用 | 实际状态 (v0.11+) | 影响 | |------|----------|-------------------|------| | `dacli form list` | L310 | v0.11+ webapi 化 | 无影响 | | `dacli dm list` | L311 | v0.11+ webapi 化 (f59d8d1) | 无影响 | | `dacli apis info` | L364 | 仍有效 | 无影响 | | `dacli form codegen` | L352 | v0.11+ webapi 化 (938c31d) | ✅ 已标注 v0.11+ | | `dacli tool logs` | L32 | 仍有效 | 无影响 | ### 3.2 旧端点引用 **未发现旧端点引用** (所有命令已 webapi 化或仍有效) ### 3.3 已废弃命令引用 | 命令 | 状态 | 影响 | |------|------|------| | `dacli di preview` (L112) | **未确认是否 deprecated** | 中 - 需查 v0.11+ 是否保留 | | `dacli di create` (L111) | v0.11+ 已 webapi 化 (d1284c4) | 低 - 命令本身仍可用, 但应加 v0.11+ 提示 | --- ## 4. 缺 NEW-CMD 章节 ### 4.1 严重缺失的 v0.11+ 新命令 (P0) | 缺失命令 | 应在位置 | 缺失原因 | |----------|----------|----------| | **`dacli di info`** | L111 之后 (di create 之后) | 后端开发必查 DI 详情 | | **`dacli di test`** | L111 之后 | 后端开发必测 DI | | **`dacli di update`** | L111 之后 | 修改 DI SQL 必用 | | **`dacli di delete`** | L111 之后 | 清理 DI 必用 | | **`dacli form update`** | L310 之后 | 改 form schema 必用 | | **`dacli log exception`** | L32 之后 | 后端调试必看异常 | | **`dacli apis search --field=`** | L364 之后 | 字段级搜索 | | **`dacli apis tags`** | L364 之后 | 查 API 标签 | ### 4.2 缺 v0.11+ 架构说明章节 **应在 L26 之后 (Picocli 注释段) 加 1 段**: ```markdown > 📦 **dacli v0.11+ webapi 镜像架构 (2026-06-25)**:后端开发常用的 di/form/dm/api 命令已 webapi 化 (di 走 loadVisualdata.ts, form 走 loadVisualDev.ts), 0 复刻 0 漂移。DI CRUD 4 命令 (info/test/update/delete) 已新增, 不再需要 delete+create 模式。 ``` --- ## 5. 优先级修复清单 ### 5.1 P0 (必修, 阻塞后端开发) 1. **加 `dacli di info/test/update/delete` 章节** (L111 之后, 4 命令, 每命令 1-2 行示例) 2. **加 `dacli form update` 章节** (L310 之后, 改 schema 必用) 3. **加 `dacli log exception` 章节** (L32 之后, 后端调试核心) 4. **加 v0.11+ webapi 架构段** (L26 之后) 5. **检查 `dacli di preview` 是否仍存在** (L112, 如已 deprecated 改用 `dacli di test`) ### 5.2 P1 (同步, 提升后端开发效率) 6. **加 `dacli apis search --field=` 段** (L364 之后) 7. **加 `dacli apis tags` 段** (L364 之后) 8. **加 `dacli dict typeUpdate/dataUpdate` 段** (新增段, 字典改值) ### 5.3 P2 (增强, 按需补) 9. **加 `dacli user list/create/delete` 段** (用户管理调试) 10. **加 `dacli role info/update/selector` 段** (权限管理) --- ## 6. 具体修复建议 (示例) ### 6.1 L111-112 替换/扩展 di 段 (P0) ```bash # v0.11+ DI CRUD 完整闭环 (webapi 化, 4 NEW-CMD) dacli di create --name=<名称> --enCode=<编码> --sql= # 仍可用 dacli di info # v0.11+ 新增, 查详情 dacli di test --params='{"key":"value"}' # v0.11+ 新增, 测试 dacli di update --sql=<新SQL> # v0.11+ 新增, 改 SQL dacli di delete --yes # v0.11+ 新增, 清理 # 注: di preview 已合并到 di test, 优先用 di test ``` ### 6.2 L310 后加 form update 提示 (P0) ```bash # v0.11+ form 改名 / 增量改 schema (无需 export→改→import) dacli form update --fullName="新名" dacli form update --enCode="new_code" --autoRelease ``` ### 6.3 L32 后加 log exception 段 (P0) ```bash # v0.11+ 新增 (P0 必读): 后端异常日志 dacli log exception --lines=20 dacli log exception --keyword="" # 按关键字过滤 ``` ### 6.4 L26 后加 v0.11+ 架构段 (P0) ```markdown > 📦 **dacli v0.11+ webapi 镜像架构 (2026-06-25)**:所有 di/form/dm/api 命令已 webapi 化, 直接 import web 端源码, 0 复刻 0 漂移。DI CRUD 4 命令 (info/test/update/delete) 已新增, 不再需要 delete+create 模式。 ``` --- ## 7. 整体评价 **健康度**: 中等 - 8 处 dacli 引用, 大部分仍有效 - 缺 8+ 个 v0.11+ 新命令 (P0 缺失中等) - 缺 v0.11+ webapi 架构说明 - 1 处可能 deprecated 命令 (di preview) - 未引用已 @deprecated 命令 (✅) - 未引用旧端点 (✅) **修复预计工作量**: 1-1.5 小时 - P0 必修 5 项: 1 小时 - P1 同步 3 项: 20 分钟 - P2 增强 2 项: 10 分钟 **建议**: 标记为 P0 必修, 在 Phase 3 Batch H 主代理执行时同步修复