Files
dacli/docs/skill-audit/frontend-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

70 lines
3.1 KiB
Markdown

# frontend-dev SKILL.md 审计报告 (2026-06-25)
> **审计依据**: v0.11+ dacli webapi 镜像 18 模块 + 30+ NEW-CMD
## 1. 命令引用清单 (skill 中所有 dacli 调用)
| 行号 | 命令 | 状态 | 备注 |
|------|------|------|------|
| - | (无任何 dacli 命令引用) | - | skill 主要讲 Vue 3 + Vite 独立路由模式 |
## 2. v0.11+ 已重构/已删命令引用检测
### ✅ 无 dacli 命令引用
- skill 内容为前端开发模式 (目录结构/路由配置/模板语法/数据调用)
- 未涉及 `dacli` CLI 命令
- 未引用已重构/已删命令
### ⚠️ 数据调用方式可优化
- 行 128-150 描述了 2 种数据调用方式 (直接 fetch API)
- v0.11+ 推荐: 前端数据调用应通过 `dacli apis info` 查询后端 API 定义
- 也可补: `dacli form info` 查 model schema + `dacli di list/info` 查数据接口
### ⚠️ 路由配置可补 dacli 菜单命令
- 行 50-66 描述菜单挂载 + 路由配置
- v0.11+ 推荐: `dacli menu list` 查菜单 + `dacli menu create` 挂菜单
- 当前未引用, 需补
## 3. 缺 NEW-CMD 章节 (对照 §11.4 NEW-CMD 完成清单)
| 父命令 | 缺 | 关联场景 | commit |
|--------|-----|----------|--------|
| apis | `apis info` | 查后端 API 字段定义 (前端调 API 前) | - |
| apis | `apis search --field=` | 字段盲猜 (前端对接业务字段) | `7b8f9b1` |
| apis | `apis tags` | 按 tag 过滤 (前端常用 tag: visualdev/datainterface) | `6effbcb` |
| menu | `menu list` | 查已挂菜单 | - |
| form | `form info` | 查 model schema (前端对接表单) | - |
| di | `di list` `di info` `di test` | 查数据接口 (前端常用) | `59a6b4a` `d1284c4` |
**重点**:
- frontend-dev 缺 3 个核心 dacli 命令提示: `apis info` / `menu list` / `di info`
- 场景: 前端开发必查 API 字段 + 必挂菜单
- 应在"5. 数据调用"段加 1 段"v0.11+ 推荐: 用 dacli 查 API 字段"
## 4. 优先级修复清单
### P0 必修 (前端开发核心)
1. **"5. 数据调用"段 (行 128-150)**: 补 dacli apis info 用法
- 加 1 段: "v0.11+ 推荐: 调 API 前先 `dacli apis info` 查字段定义"
- 场景: 避免前端盲传字段名 (字段名 + PascalCase 化后)
2. **"2. 路由配置"段 (行 50-66)**: 补 dacli menu list/create 用法
- 加 1 段: "挂菜单前先 `dacli menu list` 看已挂菜单, 再 `dacli menu create`"
- 关联: 与 menu-configuration skill 联动
### P1 同步 (非阻塞)
3. **"3. 页面开发要点"段 (行 68-114)**: 可补 dacli form info 查 model schema
- 场景: 前端对接 form 时, 先 `dacli form info <id>` 看字段结构
4. **"相关技能"段 (行 153-157)**: 补 dacli-ts 引用
- 当前只引用 backend-dev + data-interface, 应加 dacli-ts (核心 CLI)
### P2 仅检查 (无变化)
- Vue 3 + Vite 独立路由模式无变化
- Ant Design Vue UI 库声明无变化
## 5. 总结
- **现状**: frontend-dev 是纯前端开发 skill, 不直接涉及 dacli 命令
- **P0 必修 2 项**: 数据调用段补 `dacli apis info` + 路由段补 `dacli menu list`
- **影响范围**: 修 2 处即可对齐 v0.11+ AI 工作流
- **与 dacli-ts 联动**: frontend-dev 应引用 dacli-ts 作为"查 API 字段"权威源