Files
dacli/docs/skill-audit/ssw-h5dev-flow.md
T
ssw 06aed3830c chore(v0.11+): 合并 dacli/.claude/skills/dacli-ts 到父 .claude/skills/ + Phase 3 Batch F 审计
用户拍板 (2026-06-25): 为避免重复, 把 dacli 子项目的 dacli-ts skill 移到父 .claude/skills/ 下作为实体目录 (而非原 symlink), 同时删 dacli/CLAUDE.md 和 dacli/.claude/ 目录.

变更:
1. 删除整个 dacli/.claude/ 目录 (30 个文件, 包含 settings.local.json + dacli-ts skill 全部内容)
2. 删除 dacli/CLAUDE.md (内容已并入父 CLAUDE.md)
3. 父 .claude/skills/dacli-ts 替换 symlink 为实体目录 (从 dacli/.claude/skills/dacli-ts 复制)
4. 更新 4 处文档引用 (dacli/.claude/skills/dacli-ts → .claude/skills/dacli-ts, dacli/CLAUDE.md 标注合并)
5. Phase 3 Batch F 5 个主流程 skill 审计报告 (新增 docs/skill-audit/):
   - dacli-ts.md — P0 必修 3 项 (补 30+ NEW-CMD + webapi 18 模块 + form validate deprecation)
   - ssw-h5dev-flow.md — P0 必修 5 项 (doc toc/search + form update + selector + log exception)
   - design-jnpf-execute.md — P0 必修 6 项 (删 _blindspots.ts 引用 + 补 webapi + 4 NEW-CMD)
   - form-development.md — P0 必修 3 项 (删 form msrelation 误用 + 补 form update + webapi 段)
   - form-fix.md — P0 必修 3 项 (删 dacli form fix 误用 10+ 处 + 补 form clone/update 流程)

Batch G-J 子代理审计待下一轮执行 (见 plan §12.3).

下一步: 执行 Phase 3 P0 必修 (按 audit 报告) → Phase 4 历史残留清理 → Phase 5 baseline 验证
2026-06-25 15:53:06 +08:00

8.1 KiB

ssw-h5dev-flow SKILL.md 审计报告 (2026-06-25)

审计依据: v0.11+ dacli 30+ NEW-CMD 完成 (§11.4) + webapi 镜像 18 模块

1. 引用清单 (ssw-h5dev-flow.md 中所有 dacli 命令)

行号 命令 状态
20 dacli doc list --dir=docs/{app_code} ✅ 有效
26-46 dacli doc get/scan/refresh/clear (标注 TS 未实现) ❌ 错! v0.11+ 已实现 doc toc + doc search
60 dacli app status ✅ 有效
62 dacli app login --account=admin --password=<密码> ⚠️ 占位符待清理 (统一 admin/123456)
98-100 dacli menu list/info/create + menu update ✅ 有效
169 dacli app login --appCode= ✅ 有效
232-236 dacli app init/login/status ✅ 有效 (v0.9+ 重命名)
266 dacli form lint --from-script/--from-design ✅ 有效
294 dacli app switch --appCode={app_code} ✅ 有效
311-316 dacli doc get/list + dacli form/menu/... list + playwright ✅ 有效
327 dacli form info {id} ✅ 有效
355-362 dacli form info {formId} | python3 -c "..." (BS-52 检查) ✅ 有效
386 dacli form list / dacli form info $id ✅ 有效
466-478 dacli app init + form create/release + codegen + menu create ✅ 有效

2. 7 阶段流程审计

✅ 阶段 1 初始化 (行 229-237)

  • 使用 v0.9+ 重命名后命令 (app init/login/status), 无废弃命令误用

✅ 阶段 2 设计 (行 239-261)

  • 未引用具体 dacli 命令

⚠️ 阶段 2.5 lint (行 263-274)

  • 使用 dacli form lint, 引用 _blindspots.ts (v0.11+ 仍存在, 但已被 _blindspot_guards.ts 替代)
  • 建议: 改为引用 _blindspot_guards.ts

✅ 阶段 3 审核 (行 276-286)

  • 无 dacli 命令引用

✅ 阶段 4 执行 (行 288-308)

  • 使用 dacli app switch --appCode=, 无废弃命令

✅ 阶段 5 测试 (行 310-367)

  • 使用 dacli doc/get/list + dacli form/menu list + dacli form info
  • 缺 dacli log exception (AI 调试核心入口)

✅ 阶段 6 总结 (行 369-405)

  • 使用 dacli form list/info, 无废弃命令

✅ 阶段 7 迭代 (行 407-408)

  • 无 dacli 命令引用

3. 旧命令引用分析

✅ 无 v0.9+ 重命名命令误用

  • 未使用 initapp loginapp statusapp createapp 等 v0.9+ 前命令名

⚠️ 旧端点 / 旧脚本引用

行号 问题 建议
26-46 标注 dacli doc get/scan/refresh/clear TS 版未实现 v0.11+ 已实现 doc toc + doc search, 删除所有"未实现"标注
89-93 D-12 防御注释提及 "v0.11.4+ 自动检测 --type=3 + urlAddress" 验证 v0.11+ 是否已实现, 若已实现改描述
100 Java v10.6 历史参考提及 menu update --fixDisplay=true 验证 TS v0.11+ 是否已实现, 若已实现删注释

4. 缺 v0.11+ 架构段

❌ 缺 webapi 镜像架构说明

当前: ssw-h5dev-flow 完全未提及 v0.11+ webapi 镜像架构 建议: 在文件顶部加 "⚠️ v0.11+ 镜像架构" 段:

## ⚠️ v0.11+ dacli 架构更新 (2026-06-25)

**dacli v0.11+ 已采用 webapi 镜像架构**:
- `dacli/src/webapi/_loader.ts` 直接 dynamic import web/ 源码
- **0 复刻 0 快照 0 漂移** (替换了 extract-web-schema.py + extract-all.mjs)
- 所有 dacli form/menu/dict/workflow 等命令底层走 webapi 镜像

**对 ssw-h5dev-flow 的影响**:
- 表单创建/字段补全/菜单挂载等逻辑与 web 端 1:1 一致
- 无需手动同步 web 端 schema 变更
- 见 `.claude/skills/dacli-ts/SKILL.md` §webapi 架构段

❌ 缺 selector 命令说明

当前: ssw-h5dev-flow 未提及 dacli form selector / dacli workflow selector 建议: 在阶段4 执行处补充:

# 找 form 替代盲猜 enCode
dacli form selector --keyword=用户管理
# 找 workflow
dacli workflow selector --keyword=审批

5. 缺 NEW-CMD 章节

ssw-h5dev-flow 当前完全缺失以下 NEW-CMD (v0.11+ 已交付):

P0 必修 (高频)

# 命令 场景 commit
1 dacli form update 阶段4 增量改 form schema (改名/改字段/改列表配置) 801a204
2 dacli log exception 阶段5 测试遇到异常, AI 调试核心入口 59a6b4a
3 dacli di info/test/update/delete DI 调试/管理 (4 个) 59a6b4a d1284c4
4 dacli role update/info/selector 权限管理闭环 (3 个) 6effbcb 51b1f04
5 dacli workflow info/update/delete 工作流管理 (3 个) 5ec47e3 4669e35
6 dacli schedule update/delete 定时任务管理 (2 个) 6be66cb bd11e1b
7 dacli msg notice/template CRUD (6 个) 消息管理 6be66cb 4505a6f
8 dacli monitor server 性能诊断 af9e5a6 cbe6a1e
9 dacli bigscreen update/delete 大屏管理 (2 个) af9e5a6 4669e35
10 dacli dict typeUpdate/typeDelete/dataUpdate/dataDelete (4 个) 字典管理闭环 d31fa51 bed941b

P0 上下文恢复 (重要)

# 命令 场景 commit
11 dacli doc toc 重要! 替换行 20-46 的"doc get/scan/refresh/clear 未实现"注释 5f663eb
12 dacli doc search 重要! 补充到上下文恢复段 5f663eb
13 dacli apis search --field= 字段级搜索 (盲猜 API 字段时) 7b8f9b1

P1 同步 (中等)

# 命令 场景 commit
14 dacli apis tags API tag 分类查询 6effbcb
15 dacli user list/create/delete 用户管理 (3 个) 7224156

6. 优先级修复清单

🔴 P0 必修

# 行号 修复
1 20-46 上下文恢复注释需更新: 替换为 v0.11+ doc toc + doc search 方案
2 26-46 删除所有"TS 版未实现 doc get/section"标注, 补充实际命令
3 1-7 添加 v0.11+ 镜像架构段 (webapi 架构 + selector 命令说明)
4 阶段4 (288-308) 补充 form update + form/workflow selector 命令
5 阶段5 (310-367) 补 log exception + monitor server + apis search

🟡 P1 同步

# 行号 修复
6 89-93 D-12 防御注释需验证 v0.11+ 是否已实现
7 100 Java 历史参考 menu update --fixDisplay 需验证 TS 版
8 263-274 阶段 2.5 lint 段补 selector + form update 提示
9 311 dacli doc get --file= 标注"v0.11+ 推荐 doc toc 替代"

🟢 P2 检查

# 行号 修复
10 466-478 相关命令清单段补 30+ NEW-CMD

7. references/ 子文档审计

文档 关联性 是否需审计
.claude/templates/功能设计模板.md 阶段2 设计模板 是
.claude/templates/jnpf-design-*.tmpl 阶段2.5 设计骨架 是
.claude/skills/ai-debug-import/SKILL.md 提及 ssw-h5dev-flow §4 否 (仅引用路径)
.claude/skills/no-spa-page/SKILL.md 提及 ssw-h5dev-flow 否 (仅作流程对比)

8. 一句话总评

ssw-h5dev-flow 是"主流程 skill"之一, 当前 v0.11+ 兼容性良好, 但缺少部分 v0.11+ 关键更新.

主要问题

  1. P0: 上下文恢复段(行 20-46)仍标注 v0.8.1 旧状态, 未应用 v0.11+ doc toc + doc search
  2. P0: 缺少 v0.11+ webapi 镜像架构说明
  3. P0: 缺少 form update / log exception / selector 等 P0 NEW-CMD 说明
  4. P1: 部分 v0.11.4+ 预期功能需验证是否已实现
  5. P1: 阶段4/5 缺少部分 NEW-CMD 集成提示

风险等级

中等 — ssw-h5dev-flow 未使用废弃命令, 但错过了 v0.11+ 关键改进. AI 用此流程时可能:

  • 不知道用 doc toc/search 做上下文恢复 (继续用 Read 工具, 浪费 token)
  • 不知道用 form update 增量改 schema (继续 delete + create 重建)
  • 不知道用 selector 命令查找 form/workflow (继续盲猜 enCode)

建议

立即执行 P0 修复 (5 项 ~30 分钟), 然后 P1 验证 (4 项 ~20 分钟).


审计时间: 2026-06-25 审计范围: 479 行 ssw-h5dev-flow.md + 相关 templates 审计结论: 主流程无废弃命令误用, 但缺少 v0.11+ 关键改进集成, 需按 P0→P1→P2 顺序修复