用户拍板 (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 验证
8.1 KiB
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+ 重命名命令误用
- 未使用
initapploginappstatusappcreateapp等 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+ 关键更新.
主要问题
- P0: 上下文恢复段(行 20-46)仍标注 v0.8.1 旧状态, 未应用 v0.11+
doc toc + doc search - P0: 缺少 v0.11+ webapi 镜像架构说明
- P0: 缺少
form update / log exception / selector等 P0 NEW-CMD 说明 - P1: 部分 v0.11.4+ 预期功能需验证是否已实现
- 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 顺序修复