Files
dacli/docs/skill-audit/backend-dev.md
T
ssw d99ed45585 fix(v0.11+) Phase 5: 修 TS 类型错误 + Phase 3 Batch G-J skill audit (26 文件)
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 文案变更)
2026-06-25 16:38:18 +08:00

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 (必修, 阻塞后端开发)

  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 (同步, 提升后端开发效率)

  1. 加 dacli apis search --field= 段 (L364 之后)
  2. 加 dacli apis tags 段 (L364 之后)
  3. 加 dacli dict typeUpdate/dataUpdate 段 (新增段, 字典改值)

5.3 P2 (增强, 按需补)

  1. 加 dacli user list/create/delete 段 (用户管理调试)
  2. 加 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 主代理执行时同步修复