# ssw-loop SKILL.md 审计报告 (2026-06-25) > **审计依据**: v0.11+ dacli 30+ NEW-CMD 完成 (§11.4) + webapi 镜像 18 模块 ## 1. 引用清单 (ssw-loop.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-loop 完全未提及 v0.11+ webapi 镜像架构 **建议**: 在文件顶部加 "⚠️ v0.11+ 镜像架构" 段: ```markdown ## ⚠️ 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-loop 的影响**: - 表单创建/字段补全/菜单挂载等逻辑与 web 端 1:1 一致 - 无需手动同步 web 端 schema 变更 - 见 `.claude/skills/dacli-ts/SKILL.md` §webapi 架构段 ``` ### ❌ 缺 selector 命令说明 **当前**: ssw-loop 未提及 `dacli form selector` / `dacli workflow selector` **建议**: 在阶段4 执行处补充: ```bash # 找 form 替代盲猜 enCode dacli form selector --keyword=用户管理 # 找 workflow dacli workflow selector --keyword=审批 ``` ## 5. 缺 NEW-CMD 章节 ssw-loop 当前完全缺失以下 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-loop §4 | 否 (仅引用路径) | | `.claude/skills/no-spa-page/SKILL.md` | 提及 ssw-loop | 否 (仅作流程对比) | ## 8. 一句话总评 **ssw-loop 是"主流程 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-loop 未使用废弃命令, 但错过了 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-loop.md + 相关 templates **审计结论**: 主流程无废弃命令误用, 但缺少 v0.11+ 关键改进集成, 需按 P0→P1→P2 顺序修复