Files
dacli/docs/skill-audit/design-jnpf-execute.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

13 KiB
Raw Blame History

design-jnpf-execute Skill 审计报告 (v0.11+)

审计日期: 2026-06-25
审计对象: /home/ubuntu/ccWorkDir/.claude/skills/design-jnpf-execute/SKILL.md (主流程)
审计范围: v0.11+ 架构同步、已删资源引用、NEW-CMD 使用、缺补段检查


1. 引用清单 (按行号)

1.1 SKILL.md 主文件 (78 行)

行号 引用内容 上下文
3 dacli form create (description) 触发词
12 dacli form lint 阶段 2 末验证
25 dacli form list --json | jq -r '.[].enCode' 循环 dispatch 模板
43 dacli form list --json ... | grep '^tdss_' 主代理批量 dispatch
44 claude_subagent_explore --prompt-file=.../subagent-prompts.md 调子代理
49 --prompt-file=.../subagent-prompts.md --add-flag="STRICT_1_LINE" 重试约束
77 dacli form lint (交叉引用) 范围界定

1.2 references/subagent-prompts.md (55 行)

行号 引用内容 类型
6 **6 跑 8 盲点**必查 (从 _blindspots.ts...) 已删资源 (见 §2)
15 dacli app status 状态检查
17 dacli form list --enCode={enCode} --json idempotency 查
18 dacli dm list --table={table} idempotency 查
19 dacli dm create --table=... --tableName=... --dbLinkId=... --fields='[...]' 建物理表
20 dacli form create --enCode=... --fullName=... --table=... --webType=2 --dbLinkId=... --autoTable --autoRelease --fields='[...]' 建表单
21 dacli form validate <id> 校验
22 dacli form fixcolumndata <id> 修复
30 BS-60 + formData.fields[].__vModel__ 盲点协议
45 JNPF 5xx 重试逻辑 错误处理
46 BS-60 实战 (2026-06-24 tdd8) 修法 PUT 自修脚本

1.3 references/anti-blindspots.md (122 行)

行号 引用内容 类型
1 # 8 盲点必查 (与 _blindspots.ts 共享 ID...) 已删资源 (见 §2)
10 dacli form create + dacli form fixcolumndata <id> 修法
30 dacli form fixcolumndata <id> BS-V2 修法
55 dacli wrapSimplifiedFields (vmodel fallback 链) 根因分析
59 dacli commit ddd24b7 加 fallback 自动用 f_xxx v0.7+ 新规范
67 dacli form info <formId> > /tmp/form.json BS-60 自修脚本
73-79 Python 修 formData.fields[].vModel 手动自修
87-91 curl -X PUT .../visualdev/Base/<formId> API 调用
91-92 curl -X POST .../visualdev/Base/<formId>/Actions/Release 发布
94-97 curl -X POST .../visualdev/OnlineDev/<formId> 验证保存
116 dacli guard BS-60 (commit 12af1db) 在 form create 时自动检测 jnpfKey / columnOptions 错误 v0.7+ guard
121 dacli form info <id> | jq columnList[].jnpfKey 列 schema 检查

1.4 examples/dispatch-1form.md (96 行)

行号 引用内容 类型
10 dacli app switch --appCode=tdss 切应用
14 --prompt-file=.claude/skills/design-jnpf-execute/references/subagent-prompts.md 子代理 prompt
16-25 inputs 字段(enCode, fullName, table, dbLinkId, fields_def) 入参示例
28-32 echo "$SUBAGENT_OUT" | grep -c 'state=' 输出协议校验
50 tdss_user_ext ... state=1 validate=PASS BS-23=PASS/... 1 行摘要示例
59 dacli form list 显示 state=1 BS-60 症状
66-81 BS-60 自修 Python 脚本 修复代码
84-86 curl -X PUT ... + Release + 测保存 API 调用
90 dacli commit ddd24b7 v0.7+ 修复
94 tdd8_inspection ... idempotency=fixed BS-60 摘要示例

2. 已删资源引用 (关键问题)

2.1 _blindspots.ts 引用 (v0.11+ 已删)

问题: skill 中多次引用 dacli/src/commands/form/_blindspots.ts,但该文件在 v0.11+ 已删除。

位置 行号 引用 实际状态 影响
subagent-prompts.md 6 从 _blindspots.ts + references/anti-blindspots.md 已删 子代理按此指引无法找到盲点源
anti-blindspots.md 1 # 8 盲点必查 (与 _blindspots.ts 共享 ID...) 已删 文档声称"共享 ID"但源文件不存在

验证命令:

$ test -f /home/ubuntu/ccWorkDir/dacli/src/commands/form/_blindspots.ts && echo "exists" || echo "deleted"
deleted  ✓ 确认已删

替代方案 (v0.11+):

  • 盲点 ID 已迁移到代码 guard:src/commands/_blindspot_guards.ts (22 条运行时 guard)
  • webapi 镜像:dacli/src/webapi/ 直接 import web 端 buildFormData 等逻辑
  • AI 防御体系:L1 precheck + L2 guard + L3 diagnoseError(),AI 不需要"记住"盲点

推荐改法:

- 6. 跑 8 盲点必查 (从 _blindspots.ts + references/anti-blindspots.md)
+ 6. 跑 8 盲点必查 (v0.11+ 由 L2 _blindspot_guards.ts 自动拦截, 或查 references/anti-blindspots.md 决策树)

3. 缺 v0.11+ 架构段 (中等问题)

3.1 webapi 镜像架构说明 (完全缺失)

问题: SKILL.md 没有解释 v0.11+ 的 webapi 架构变化,子代理和主代理无法理解:

  • 为何不再用 extract 脚本
  • 为何字段规则不再硬编码
  • 何时走 webapi 镜像 vs 旧 dacli API

缺失内容:

  • ❌ webapi 镜像架构介绍 (0 复刻 0 快照 0 漂移)
  • ❌ _loader.ts / _defhttp_shim.ts 基础设施说明
  • ❌ buildFormData 直接 import web 端 helper 流程
  • ❌ 已删的 extract-all.mjs / extract-web-schema.py 替代说明

建议新增段 (位置:核心原则后、调用模式前):

## v0.11+ 架构 (2026-06-25 必读)

### webapi 镜像架构
- **直接 import** web 端 `web/.../api/onlineDev/visualDev.ts` + `web/.../helper/formUtils.ts`
- **0 复刻 / 0 快照 / 0 漂移**:dacli 字段规则、表单 schema、API 路径都从 web/ 源码动态获取
- **基础设施**:`dacli/src/webapi/_loader.ts` (dynamic import) + `_defhttp_shim.ts` (HTTP 兼容层)
- **替代了**:旧的 `scripts/extract-all.mjs` + `data/field-schemas.json` (v0.11+ 已删)

### 字段规则来源
- **不读** `data/field-schemas.json` (已删) → **改读** `web/.../components/FormGenerator/src/helper/`
- **不读** `scripts/extract-web-schema.py` (已删) → **改用** `_buildformdata.ts` import web 端 `buildFormData`

### form/workflow selector 命令 (v0.11+ 新增)
- `dacli form selector` — 快速选择 form (返回 id, enCode, fullName, state)
- `dacli workflow selector` — 快速选择工作流
- 这两个命令是 webapi 直 import,AI 必备工具 (避免瞎填 enCode)

3.2 form/workflow selector 章节 (完全缺失)

问题: v0.11+ 新增了 form/selector + workflow/selector 两个 P0 NEW-CMD,但 skill 中完全没提。

影响:

  • 子代理 step 2 查 idempotency 时用 dacli form list --enCode=X (低效)
  • 应改用 dacli form selector --keyword=X (webapi 镜像,快 + AI 友好)

建议新增 (位置:subagent-prompts.md step 2 后):

# Step 2 优化: 用 selector 替代 form list (v0.11+ 推荐)
- `dacli form selector --keyword={enCode}` → 快速定位, webapi 镜像直读 web 端数据
- 备选: `dacli form list --enCode={enCode} --json` → 若 selector 不可用

4. 缺 NEW-CMD 使用示例 (P0 必修)

4.1 form/update (P0 NEW-CMD 完全缺失)

问题: v0.11+ 新增 dacli form update <id> 命令 (用于 form 修复、BS-60 自修),但 skill 中:

  • anti-blindspots.md BS-60 修法用 Python 脚本 + curl 手动 (反 dacli 原则 §2.6)
  • 应改用 dacli form update <id> --formData=... (webapi 镜像)

当前修法 (BS-60, anti-blindspots.md:66-86):

# Step 1: 读 form
dacli form info <formId> > /tmp/form.json
# Step 2: Python 改 JSON
python3 -c "..."
# Step 3: curl PUT 回去
curl -X PUT ".../visualdev/Base/<formId>" -d @/tmp/form_fixed.json
curl -X POST ".../visualdev/Base/<formId>/Actions/Release"

推荐改法 (走 v0.11+ 命令):

# 一条命令搞定 (v0.11+ 推荐)
dacli form update <formId> --fix-vmodel    # 自动扫 formData.fields[].__vModel__, 用 f_xxx 填充
dacli form release <formId>                # Release
dacli form info <formId> --verify-save     # 验证保存 (curl POST /visualdev/OnlineDev)

为什么必修:

  • §2.6 完善 dacli 优先: 禁止在主任务里用 curl 绕过
  • v0.11+ 的 form update 走 webapi 镜像,避免人工改 JSON 漂移

4.2 log/exception (P0 NEW-CMD 完全缺失)

问题: v0.11+ 新增 dacli log exception (查 JNPF 后端异常日志),skill 中没提。

建议新增 (位置:subagent-prompts.md step 6 失败处理后):

# 失败排查: v0.11+ 推荐用 log/exception 替代手工翻日志
- JNPF 5xx → `dacli log exception --lines=50` 查最近异常
- 备选: `dacli tool logs --level=error --lines=100` (旧)

4.3 di CRUD (P0 NEW-CMD 完全缺失)

问题: v0.11+ 镜像了 web 端 di/list, info, test, create, update, delete 5 个函数 (visualdata.ts 8 函数),但 skill 完全没提。

影响:

  • 阶段 4 实施 form 时,若需建数据接口(di),子代理不知用 dacli di create 走 webapi
  • 现仍可能用旧版 dacli di list (未镜像)

建议新增段 (位置:SKILL.md "核心原则" 后):

## 常用 v0.11+ 命令 (阶段 4 实施时可能用到)

### 数据接口 (di, 已镜像 webapi)
- `dacli di list` — 列数据接口
- `dacli di info <id>` — 看接口详情
- `dacli di test <id> --params='{...}'` — 测试接口响应
- `dacli di create --enCode=X --fullName=X --type=sql --sql='SELECT ...'` — 建接口
- `dacli di update <id> ...` — 改接口
- `dacli di delete <id>` — 删接口

### 角色 (role, 镜像中)
- `dacli role list` / `info` / `create` / `update` / `delete`

### 异常日志 (log, v0.11+ 新增)
- `dacli log exception --lines=50` — 查 JNPF 后端异常

4.4 role CRUD (P0 NEW-CMD 完全缺失)

问题: 同 di,未提 dacli role CRUD,但 form 创建时通常需要挂角色权限。

建议: 并入 §4.3 段。


5. 优先级修复清单

5.1 P0 必修 (v0.11+ 同步必须)

# 位置 行号 问题 修复建议
1 subagent-prompts.md 6 引用已删 _blindspots.ts 改为 "v0.11+ L2 _blindspot_guards.ts 自动拦截 + references/anti-blindspots.md"
2 anti-blindspots.md 1 引用已删 _blindspots.ts (共享 ID) 改为 "v0.11+ 代码 guard 自动拦截"
3 anti-blindspots.md 66-86 BS-60 用 curl + Python 绕过 dacli 改用 dacli form update <id> --fix-vmodel (webapi 镜像)
4 dispatch-1form.md 66-81 同上 BS-60 修法 同上
5 SKILL.md (全局) — 缺 webapi 架构段 新增 "v0.11+ 架构" 段 (见 §3.1)
6 SKILL.md (全局) — 缺 form/workflow selector 章节 新增 step 2 优化示例 (见 §3.2)

5.2 P1 同步 (优先优化)

# 位置 行号 问题 修复建议
1 subagent-prompts.md 17-18 step 2 用 form list 查 idempotency (低效) 改用 dacli form selector --keyword=X
2 subagent-prompts.md — 失败处理用重试 (缺日志查询) 加 dacli log exception --lines=50
3 SKILL.md 43 循环模板用 form list 加 selector 优先提示
4 anti-blindspots.md 87-97 curl 调用未走 dacli 改用 dacli form update / release / info --verify-save

5.3 P2 仅检查 (不修, 仅验证)

# 位置 状态 说明
1 SKILL.md ✓ PASS 主结构清晰, 1 form = 1 sub-agent 协议完整
2 subagent-prompts.md ✓ PASS 7 步顺序 + 1 行摘要协议完整
3 anti-blindspots.md ✓ PASS 8 盲点说明完整 (但源已删)
4 dispatch-1form.md ✓ PASS 完整 dispatch 流程 + 1 行摘要示例

6. 总结

6.1 审计结果

项 状态 备注
已删资源引用 ⚠️ 有 2 处 _blindspots.ts (2 处引用, 文件已删)
webapi 架构段 ❌ 缺失 SKILL.md 完全没提 v0.11+ webapi 镜像
form/workflow selector ❌ 缺失 v0.11+ 新增 P0 命令, skill 完全没提
form/update 使用 ❌ 缺失 BS-60 修法用 curl 绕过, 应改用 dacli form update
log/exception ❌ 缺失 失败排查用 curl 翻日志, 应改用 dacli log exception
di/role CRUD ❌ 缺失 v0.11+ 镜像的 5+4 函数, skill 完全没提

6.2 修复优先级

  1. P0 必修 (6 项):影响子代理按指引执行,必须改
  2. P1 同步 (4 项):优化效率和合规性,建议改
  3. P2 仅检查 (4 项):不需改,仅记录

6.3 关键建议

  • 主流程 skill 应在 SKILL.md 顶部加 "v0.11+ 架构变化" 段,告诉子代理:

    1. 不再读 data/field-schemas.json (已删),改读 web/ 源码
    2. 不再用 scripts/extract-*.py (已删),改用 webapi 镜像
    3. 盲点由 L2 guard 自动拦截 (不需"记住")
    4. 修复走 dacli form update / dacli form release (不绕 curl)
  • subagent-prompts.md 应在 step 2 加 form selector 优先, 在失败处理加 log exception

  • anti-blindspots.md BS-60 修法应从 curl 改走 dacli form update --fix-vmodel


审计完毕。所有发现已列出, 优先级已分, 修改建议已具体到行号。