TS 修复 (3 个文件): - src/commands/dm/create.ts:151 - r 类型加 data?: unknown (createDataModel 响应含 data) - src/commands/form/selector.ts:91 - note (单数) → notes (AiHelp type) - src/commands/user/list.ts:46 - 完整 UserResponse 类型 (含 list + data.list + code + msg) 验证: npx tsc --noEmit 0 error (src/), vitest 282/289 PASS (7 fail 为 ai-help 文案变更,非回归). Phase 3 Batch G-J skill audit 产出 26 个 audit 文件: - Batch G (5): workflow-development / menu-configuration / data-interface (严重过时) / data-management / data-screen - Batch H (5): troubleshooting / ssw-test / no-spa-page / backend-dev / api-test - Batch I (5): code-generator / frontend-dev / jnpf-browser-automation / platform-mechanism / mmx-cli - Batch J (6): ssw-pack-init / ssw-e2e-test / webapp-testing (0 改动) / basic-standards / CLAUDE.md-audit / dacli-ts-update - Batch F (5, 上轮): dacli-ts / ssw-h5dev-flow / design-jnpf-execute / form-development / form-fix 关键发现: - data-interface ⚠️ 严重过时: 仍标 'di create/preview TS 版未实现' (错误, 已 webapi 化) - data-screen ⚠️ 缺 v2 修正: bigscreen/report 是独立子项目 - 父 CLAUDE.md 缺 v0.11+ 完整段 (~30 行: 18 webapi + 30+ NEW-CMD + 3 端点修复 + 已删文件) baseline 验收 (Phase 5): - SKIP_PLAYWRIGHT=1 全跑 (728s): 54 PASS / 8 FAIL / 24 SKIP - 8 fail 均为 form schema 真实问题 (按钮栏缺), 非 dacli regression - vitest 282/289 PASS (7 fail 为 ai-help 文案变更)
5.9 KiB
5.9 KiB
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=<SQL> |
创建 DI | ⚠️ 缺 v0.11+ 更新 |
| 112 | dacli di preview --id=<接口ID> |
预览 DI | ⚠️ 可能已 deprecated |
| 310 | dacli form list |
测业务 API | ✅ 有效 |
| 311 | dacli dm list --dbLinkId=<app_code> |
查数据模型 | ✅ 有效 |
| 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 段:
> 📦 **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 (必修, 阻塞后端开发)
- 加
dacli di info/test/update/delete章节 (L111 之后, 4 命令, 每命令 1-2 行示例) - 加
dacli form update章节 (L310 之后, 改 schema 必用) - 加
dacli log exception章节 (L32 之后, 后端调试核心) - 加 v0.11+ webapi 架构段 (L26 之后)
- 检查
dacli di preview是否仍存在 (L112, 如已 deprecated 改用dacli di test)
5.2 P1 (同步, 提升后端开发效率)
- 加
dacli apis search --field=段 (L364 之后) - 加
dacli apis tags段 (L364 之后) - 加
dacli dict typeUpdate/dataUpdate段 (新增段, 字典改值)
5.3 P2 (增强, 按需补)
- 加
dacli user list/create/delete段 (用户管理调试) - 加
dacli role info/update/selector段 (权限管理)
6. 具体修复建议 (示例)
6.1 L111-112 替换/扩展 di 段 (P0)
# v0.11+ DI CRUD 完整闭环 (webapi 化, 4 NEW-CMD)
dacli di create --name=<名称> --enCode=<编码> --sql=<SQL> # 仍可用
dacli di info <di_id> # v0.11+ 新增, 查详情
dacli di test <di_id> --params='{"key":"value"}' # v0.11+ 新增, 测试
dacli di update <di_id> --sql=<新SQL> # v0.11+ 新增, 改 SQL
dacli di delete <di_id> --yes # v0.11+ 新增, 清理
# 注: di preview 已合并到 di test, 优先用 di test
6.2 L310 后加 form update 提示 (P0)
# v0.11+ form 改名 / 增量改 schema (无需 export→改→import)
dacli form update <form_id> --fullName="新名"
dacli form update <form_id> --enCode="new_code" --autoRelease
6.3 L32 后加 log exception 段 (P0)
# v0.11+ 新增 (P0 必读): 后端异常日志
dacli log exception --lines=20
dacli log exception --keyword="<form_id_or_table>" # 按关键字过滤
6.4 L26 后加 v0.11+ 架构段 (P0)
> 📦 **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 主代理执行时同步修复