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 文案变更)
81 lines
4.3 KiB
Markdown
81 lines
4.3 KiB
Markdown
# code-generator SKILL.md 审计报告 (2026-06-25)
|
|
|
|
> **审计依据**: v0.11+ dacli webapi 镜像 18 模块 + 30+ NEW-CMD (form codegen 已 webapi 化 commit `938c31d`)
|
|
|
|
## 1. 命令引用清单 (skill 中所有 dacli 调用)
|
|
|
|
| 行号 | 命令 | 状态 | 备注 |
|
|
|------|------|------|------|
|
|
| 3 | `dacli form codegen (v0.11+)` | ✅ 有效 | 已 webapi 化 (commit `938c31d`) |
|
|
| 14 | `dacli form codegen --ai-help` | ⚠️ 待确认 | `--ai-help` 是 dacli 全局 ai 帮助参数 |
|
|
| 21 | `dacli form create` (发布 state=1) | ✅ 有效 | |
|
|
| 28-34 | `dacli form codegen` 完整参数 | ✅ 有效 | `--auto-alias` 默认 ON, `--mainClassName` 自动推导 |
|
|
| 39 | `dacli form codegen 808986025610185477 --module=tds` | ✅ 有效 | |
|
|
| 42 | `dacli form codegen 839112829108748357 --module=jxcj --mainClassName=DevelopProject` | ✅ 有效 | |
|
|
| 45 | `dacli form codegen ... --no-web --no-uniapp` | ✅ 有效 | |
|
|
| 48-50 | `for FID in $(dacli form list --json \| jq -r '.[].id'); do dacli form codegen $FID --module=jxcj; done` | ⚠️ 需补 form update | 批量场景应补 `dacli form update` 增量改 schema |
|
|
| 55 | `dacli form list` (看 STATE 字段) | ✅ 有效 | |
|
|
| 56 | `dacli form validate <id>` | ⚠️ 需标注 @deprecated | webapi 化后已自动保证 schema 完整性, 此命令标记 @deprecated |
|
|
| 154 | `--no-auto-alias` 关闭别名 | ✅ 有效 | |
|
|
| 155 | `dacli dm create --table=jxcj_xxx` (自动去前缀) | ✅ 有效 | |
|
|
| 159 | `dacli app login` | ✅ 有效 | |
|
|
|
|
## 2. v0.11+ 已重构/已删命令引用检测
|
|
|
|
### ✅ form codegen 已 webapi 化 (commit `938c31d`)
|
|
- skill 标题与内容已明确标注 v0.11+, 一致性良好
|
|
- PascalCase 化: `--auto-alias` 默认 ON + 默认从 enCode 推导 mainClassName
|
|
- per-model web/uniapp 输出 (`$CCWORKDIR/{web,uniapp}/.../ssw/{appCode}/{ModelName}/`)
|
|
|
|
### ✅ ssw-common 共享 MapperConfig (BS-14 集中化)
|
|
- 行 108-128 详细说明了 `SswMapperConfig` + `ssw-common-biz` 依赖
|
|
- 业务包零 MapperConfig 配置
|
|
|
|
### ⚠️ form validate 仍引用 (行 56)
|
|
- `dacli form validate <id>` 已标记 @deprecated (v0.11+ webapi 镜像已自动保证 schema 完整性)
|
|
- skill 应标注 "已 deprecated, 可选保留作为运行时校验"
|
|
|
|
### ⚠️ 缺 form update NEW-CMD 提示
|
|
- v0.11+ 新增 `dacli form update` (commit `801a204`), 用于增量改 schema
|
|
- code-generator 场景 (form 已建 → codegen 前) 可用 `form update` 调整
|
|
|
|
## 3. 缺 NEW-CMD 章节 (对照 §11.4 NEW-CMD 完成清单)
|
|
|
|
| 父命令 | 缺 | 关联场景 | commit |
|
|
|--------|-----|----------|--------|
|
|
| form | `form update` | 批量 codegen 前调整 schema | `801a204` |
|
|
| log | `log exception` | codegen 失败时调试 | `59a6b4a` |
|
|
| apis | `apis search --field=` | 查 ssw-{app} API 字段 | `7b8f9b1` |
|
|
| doc | `doc toc`, `doc search` | 查 ssw-{app_code}/docs/ | `5f663eb` |
|
|
|
|
**重点**:
|
|
- `dacli form update` 缺失: code-generator 批量场景需要 (e.g. 28 form 批量 codegen 前先 update 字段)
|
|
- `dacli log exception --keyword=<formId>` 缺失: codegen 失败时定位
|
|
- `dacli apis search --field=` 缺失: 查 ssw-{app_code} 业务 API 字段 (PascalCase 实体类)
|
|
|
|
## 4. 优先级修复清单
|
|
|
|
### P0 必修 (主流程命令)
|
|
1. **行 56**: `dacli form validate <id>` 标注 @deprecated 提示
|
|
- 添加注释: "v0.11+ webapi 镜像已自动保证 schema 完整性, 此命令标记 @deprecated"
|
|
2. **行 48-50** 批量 codegen 场景: 补 `dacli form update` 用法
|
|
- 场景: 28 form 批量前先 update 调整字段
|
|
- 建议加 1 段 "批量 codegen 前 update 流程"
|
|
3. **顶部 v0.11+ 段**: 补 "v0.11+ Phase 2 完成 30+ NEW-CMD" 链接
|
|
- `dacli form update` (commit `801a204`) 是高需求命令
|
|
- codegen 失败时 `dacli log exception` 调试
|
|
|
|
### P1 同步 (非阻塞)
|
|
4. **行 14** `dacli form codegen --ai-help` 链接: 确认这是 dacli 全局 ai-help 参数 (Picocli 自动生成)
|
|
5. **行 154** `--no-auto-alias` 应补充: "v0.11+ 默认 ON, 关闭后类名带 appCode 前缀"
|
|
|
|
### P2 仅检查 (无变化)
|
|
- PascalCase 化 + ssw-common MapperConfig 段已完善, 无需修改
|
|
- per-model web/uniapp 输出路径已准确
|
|
|
|
## 5. 总结
|
|
|
|
- **现状**: code-generator 是 v0.11+ 标杆 skill, 准确反映 webapi 化 + PascalCase 化
|
|
- **P0 必修 3 项**: form validate deprecation 标注 + form update 补段 + NEW-CMD 链接
|
|
- **影响范围**: 修 3 处即可对齐 v0.11+ Phase 2 全部产出
|