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

160 lines
5.9 KiB
Markdown

# 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 段**:
```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=<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)
```bash
# 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)
```bash
# v0.11+ 新增 (P0 必读): 后端异常日志
dacli log exception --lines=20
dacli log exception --keyword="<form_id_or_table>" # 按关键字过滤
```
### 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 主代理执行时同步修复