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 文案变更)
8.6 KiB
8.6 KiB
Skill Audit: troubleshooting
审计目标: /home/ubuntu/ccWorkDir/.claude/skills/troubleshooting/SKILL.md
审计时间: 2026-06-25
审计者: .claude/ skill 审计子代理 (Batch H)
对照基准: dacli v0.11+ 已重构命令 + 30+ NEW-CMD (见 v0.11-next-steps-plan.md §11.4)
1. 技能定位
历史归档型 skill, 保留但需加 v0.11+ 三层防御提示。
2. 命令引用清单 (按行号)
| 行号 | 命令 | 上下文 | 状态 |
|---|---|---|---|
| 19 | dacli app context --json |
v0.10+ 推荐入口 | ✅ 有效 |
| 22 | dacli tool logs --level=error --lines=50 |
查后端日志 | ✅ 有效 |
| 25 | dacli app status |
查登录状态 | ✅ 有效 |
| 33 | dacli app login (表格行内) |
Token 过期 | ✅ 有效 |
| 34 | dacli form release |
表单未发布 | ✅ 有效 |
| 37 | dacli form create |
"Database exception" 错误 | ⚠️ 应加 v0.11+ webapi 提示 |
| 38 | dacli menu create --formId |
"主表不存在" | ⚠️ 应加 v0.11+ BS-50 guard |
| 39 | dacli menu create --formId=<id> |
vue-router 未注册 | ⚠️ 同上 |
| 69 | dacli menu info --id=<MENU_ID> |
菜单字段诊断 | ✅ 有效 (但应改为位置参数) |
| 72 | dacli menu delete --id=<MENU_ID> --yes |
菜单删除 | ✅ 有效 (但应改为位置参数) |
| 73 | dacli menu create --fullName=... --enCode=... --parentId=... --formId=... |
重建菜单 | ⚠️ 引用 v0.7+, 应加 v0.11+ webapi 化提示 |
| 85 | dacli menu delete --id=<MENU_ID> --fallback --yes |
兜底删除 | ✅ 有效 |
| 87 | dacli menu unrelease --formId=<FORM_ID> |
走 formId unrelease | ✅ 有效 |
| 97 | dacli form list --keyword=<enCode> |
查表单 | ✅ 有效 |
| 99-100 | dacli menu delete / dacli menu create |
删了重建 | ⚠️ 应加 v0.11+ webapi 提示 |
| 120 | dacli dm query --table=<table> --order=f_creator_time --sort=desc |
表查询 | ✅ 有效 |
| 127 | dacli tool logs --level=error --lines=100 |
查日志 | ✅ 有效 |
| 133-134 | playwright -s=dacli eval/console |
浏览器调试 | ✅ 有效 (非 dacli) |
| 137-140 | curl ... -H "App-Code: ..." |
直接 API 调 | ✅ 有效 (推荐模式) |
| 186, 189 | dacli apis info "POST /api/xxx/xxx" |
排错定位 | ✅ 有效 |
| 214 | dacli dm query (行内) |
排查数据 | ✅ 有效 |
| 250 | dacli menu list --keyword=<app_code>_ |
菜单列表 | ✅ 有效 |
| 274 | dacli form create --fields |
字段说明 | ⚠️ 引用 v0.11+ 已变化 (webapi 化) |
命令总数: 22 处 dacli 引用 (含表格行内 1 处)
3. v0.11+ 已重构命令引用检测
3.1 已重构/已 webapi 化命令 (引用但未注明 v0.11+)
| 命令 | 当前引用 | 实际状态 (v0.11+) | 影响 |
|---|---|---|---|
dacli form create |
L37, L274 | v0.11+ 已 webapi 化 (9c14cda+7bf7762+938c31d+e6a56f3+c98bf2b) | 低 (命令本身仍可用) |
dacli form release |
L34 | v0.11+ webapi 化 (7224156 family) |
无影响 |
dacli form list |
L97 | v0.11+ webapi 化 | 无影响 |
dacli menu create |
L38, L73, L100 | v0.11+ webapi 化 (c7b24eb+694619b) | 低 |
dacli menu info |
L69 | v0.11+ webapi 化 (c7b24eb) |
应改为位置参数 <id> |
dacli menu delete |
L72, L99 | v0.11+ webapi 化 (c7b24eb) |
应改为位置参数 <id> |
dacli menu unrelease |
L87 | v0.11+ webapi 化 (694619b) |
无影响 |
dacli menu list |
L250 | v0.11+ webapi 化 (c7b24eb) |
无影响 |
dacli apis info |
L189 | 仍有效 | 无影响 |
3.2 旧端点引用
未发现旧端点引用 (grep 全部为已 webapi 化的 dacli 命令)
3.3 已废弃命令引用
未发现已 @deprecated 命令引用 (form/validate + fixcolumndata + _simplify 等已 deprecated 命令未出现)
4. 缺 NEW-CMD 章节
4.1 严重缺失的 v0.11+ 新命令 (P0)
| 缺失命令 | 应在位置 | 缺失原因 |
|---|---|---|
dacli log exception |
L186 之后 (dacli 增强能力段) | AI 排查异常唯一入口, 但 skill 未提 |
dacli log request |
同上 | 排查 API 请求失败 |
dacli form update |
L34 (form release 之后) | form 改名/增量改 schema 必用 |
dacli di info/test/update/delete |
L120 (dm query 之后) | 调试数据接口核心 |
dacli workflow info/update/delete |
全文未提 | 流程调试 |
dacli role info/update/selector |
全文未提 | 权限相关报错 |
dacli menu selector |
全文未提 | 找菜单 ID |
dacli monitor server |
全文未提 | 性能诊断 |
dacli dict typeUpdate/dataUpdate |
全文未提 | 字典改值 |
dacli apis tags |
L189 之后 | 查 API 标签 |
dacli apis search --field= |
同上 | 字段级搜索 |
dacli doc toc |
全文未提 | 长文档索引 |
dacli doc search |
全文未提 | 文档搜索 |
4.2 缺 v0.11+ 架构说明章节
应在开头加 1 段 (替换或补充 L8 的"v0.10+ 防御体系"段):
> 📦 **dacli v0.11+ webapi 镜像架构 (2026-06-25)**:所有 form/menu/dict/dm/datasource/role/log/monitor/schedule/msg/di/workflow/user 命令已 webapi 化 (18 模块, 100+ 函数), 0 复刻 0 漂移。报错时优先用 `dacli app context --json` 看环境, `dacli log exception` 看后端异常。
5. 优先级修复清单
5.1 P0 (必修, 阻塞 AI 调试)
- 加
dacli log exception章节 (L186 之后, 3 行示例) - 加
dacli form update章节 (L34 之后, 3 行示例) - 加
dacli workflow info/update/delete章节 (新增段) - 加 v0.11+ webapi 架构段 (L8 替换为 v0.11+ 段)
- 修复
--id=为位置参数 (L69, L72, L99 三处)
5.2 P1 (同步, 提升 AI 效率)
- 加
dacli di info/test/update/delete段 (L120 后, 引用 di 已 webapi 化) - 加
dacli role info/update/selector段 (L100 后, 权限报错必备) - 加
dacli apis tags / search --field=段 (L189 后) - 加
dacli monitor server段 (L22 后, 性能诊断) - 加
dacli dict typeUpdate/dataUpdate段 (新增段, 字典报错)
5.3 P2 (增强, 按需补)
- 加
dacli doc toc/search段 (新增段, 文档搜索) - 加
dacli menu selector段 (L87 后, 找菜单 ID) - 加
dacli user list/create/delete段 (用户管理调试) - 加
dacli schedule update/delete段 (定时任务调试) - 加
dacli bigscreen update/delete段 (大屏调试) - 历史归档段加
@deprecated标记 (提醒仅作 debug 历史参考)
6. 具体修复建议 (示例)
6.1 L186 后加 v0.11+ 异常排查 (P0)
# v0.11+ 新增 (P0 必读): 后端异常日志直接读
dacli log exception --lines=20
dacli log exception --keyword="<form_id>" # 按关键字过滤
dacli log request --lines=10 # API 请求日志
6.2 L34 后加 form update 提示 (P0)
# v0.11+ form 改名 / 增量改 schema (无需 export→改→import)
dacli form update <form_id> --fullName="新名"
dacli form update <form_id> --enCode="new_code"
dacli form update <form_id> --autoRelease # 改完直接发布
6.3 L8 替换为 v0.11+ 防御段 (P0)
> 📦 **dacli v0.11+ 三层防御 + webapi 镜像 (2026-06-25)**:本技能已集成到 dacli 完整防御体系。AI 报错时优先看:
> - **错误决策树**: `.claude/skills/dacli-ts/references/errors.md`(26 段按错误关键词分类)
> - **三层防御**: `.claude/skills/dacli-ts/SKILL.md` §🛡️(pre-check + 22 条 guard + diagnoseError)
> - **后端异常**: `dacli log exception --keyword=<id>` (v0.11+ 新增, 必读)
> - **环境快照**: `dacli app context --json` (v0.10+ 推荐入口)
> - **webapi 架构**: dacli 直接 import web 端源码, 0 复刻 0 漂移
> - **历史归档**: `.claude/skills/dacli-ts/references/troubleshooting.md` (52 条盲点流水账, 仅 debug 历史问题)
6.4 修复位置参数 (P0)
L69: dacli menu info --id=<MENU_ID> → dacli menu info <MENU_ID>
L72: dacli menu delete --id=<MENU_ID> --yes → dacli menu delete <MENU_ID> --yes
L99: dacli menu delete --id=<MENU_ID> --yes → dacli menu delete <MENU_ID> --yes
7. 整体评价
健康度: 中等偏低
- 22 处 dacli 引用, 大部分仍有效
- 缺 13+ 个 v0.11+ 新命令 (P0 缺失严重)
- 缺 v0.11+ webapi 架构说明
- 3 处位置参数未改 (低优先级修复)
- 未引用已废弃命令 (✅)
- 未引用旧端点 (✅)
修复预计工作量: 1-2 小时
- P0 必修 5 项: 1 小时
- P1 同步 5 项: 30 分钟
- P2 增强 6 项: 30 分钟
建议: 标记为 P0 必修, 在 Phase 3 Batch H 主代理执行时同步修复