Files
dacli/docs/skill-audit/ssw-loop.md
T
ssw b9b64dea90 feat: 重命名 ssw-h5dev-flow → ssw-loop (跨 2 仓库)
.claude 仓库:
- git mv skills/ssw-h5dev-flow → skills/ssw-loop (保留 history)
- 改 SKILL.md frontmatter (name + description 触发词)
- 改 5 个 references + 3 个子代理 prompt 模板 + learnings.md.tmpl
- 改 templates/html/style.css + script.js 注释
- 改 scripts/scaffold.sh + 4 个 check 脚本路径
- 改其他 skill 引用: dacli-ts/SKILL.md + anti-patterns.md, no-spa-page/SKILL.md, jnpf-browser-automation/SKILL.md
- 改 CLAUDE.md §技能索引 + §开发流程 + §问题处理
- 改 .claude/templates/flow-jxcj-rerun-process.md + .claude/settings.local.json (allow list)

dacli 仓库:
- 改 src/commands/doc/_parser.ts + list.ts 注释 (提及 ssw-loop plan/debug/research 走 MD)
- 改 tests/unit/doc-md-slice.test.ts 注释
- 改 docs/尚数网基本开发规范v3.0.md (7 处引用)
- git mv docs/skill-audit/ssw-h5dev-flow.md → ssw-loop.md (保留 history)
- 改 docs/cmd-review/doc.md

历史保留 (未改, 反映 v0.11 时代状态):
- dacli/docs/v0.11-*.md (4 个 plan 文件)
- docs/dacli/ssw-dacli/ (Java 版归档, 已废弃)
- docs/aibridge/.claude/ (Python 时代)

验证: 14/14 doc-md-slice 测试 PASS
2026-06-29 13:28:52 +08:00

192 lines
8.0 KiB
Markdown

# 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 顺序修复