用户拍板 (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 验证
13 KiB
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.mdBS-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 修复优先级
- P0 必修 (6 项):影响子代理按指引执行,必须改
- P1 同步 (4 项):优化效率和合规性,建议改
- P2 仅检查 (4 项):不需改,仅记录
6.3 关键建议
-
主流程 skill 应在 SKILL.md 顶部加 "v0.11+ 架构变化" 段,告诉子代理:
- 不再读
data/field-schemas.json(已删),改读 web/ 源码 - 不再用
scripts/extract-*.py(已删),改用 webapi 镜像 - 盲点由 L2 guard 自动拦截 (不需"记住")
- 修复走
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
审计完毕。所有发现已列出, 优先级已分, 修改建议已具体到行号。