用户拍板 (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
form-fix SKILL.md 审计报告 (v0.11+ 兼容性)
审计日期: 2026-06-25
审计对象: /home/ubuntu/ccWorkDir/.claude/skills/form-fix/SKILL.md (191 行)
审计依据: dacli/docs/v0.11-next-steps-plan.md §11.4 + 代码实际状态
1. form-fix 命令引用清单
SKILL.md 中所有 dacli form <sub> 调用(按行号):
| 行号 | 命令 | 用途 | 状态 |
|---|---|---|---|
| 4 | dacli form fix |
触发词 | ❌ 命令不存在 |
| 7 | dacli form fix |
主要修复命令 | ❌ 命令不存在 |
| 15 | dacli form fix |
修复 formData 缺 jnpfKey | ❌ 命令不存在 |
| 16 | dacli form fix |
修复 columnList 字段不完整 | ❌ 命令不存在 |
| 17 | dacli form fix |
修复 searchList 配置 | ❌ 命令不存在 |
| 18 | dacli form fix |
修复 appColumnData 不一致 | ❌ 命令不存在 |
| 19 | dacli form fix |
修复 tables 字段被替换 | ❌ 命令不存在 |
| 20 | dacli form release |
state=1→2 发布 | ✅ 存在 |
| 27 | dacli form list |
关键词搜索表单 | ✅ 存在 |
| 28 | dacli form info |
查看表单详情 | ✅ 存在 |
| 45 | dacli form fix |
7 步法步骤 3 | ❌ 命令不存在 |
| 48, 56, 65 | dacli form fix |
命令示例(3 处) | ❌ 命令不存在 |
| 77 | dacli form list |
验证修复结果 | ✅ 存在 |
| 80 | dacli form msrelation |
主子表关系查询 | ❓ 未确认 |
| 170 | dacli form create |
对比基线模式 | ✅ 存在 |
| 181 | dacli form list |
验证 state | ✅ 存在 |
| 188 | dacli form info --expand-subtable |
查看主子表 ER | ✅ 存在 |
| 189 | dacli form msrelation |
主子表关系 | ❓ 未确认 |
关键问题:
dacli form fix在 v0.11+ 代码中不存在(已重构/迁移)dacli form msrelation未在commands/form/index.ts注册(15 个子命令中无此命令)
2. Deprecated 命令检测
2.1 dacli form fixcolumndata — 不存在于 SKILL.md,但代码仍存在
- SKILL.md 引用: 无(SKILL.md 中未提及此命令)
- 代码状态:
src/commands/form/fixcolumndata.ts仍存在 (96 行),在index.ts第 28 行注册 - v0.11+ 状态: v0.11+ 计划明确标记为"已 deprecated"(见
v0.11-next-steps-plan.md§11.4) - 迁移方向: 功能已并入
webapi/_buildformdata.ts(直接 import web 端buildFormData) - 建议: 保留但不推荐使用,应在 SKILL.md 中明确标注"deprecated,用 form update 替代"
2.2 dacli form validate — 不存在于 SKILL.md,但代码仍存在
- SKILL.md 引用: 无(SKILL.md 中未提及此命令)
- 代码状态:
src/commands/form/validate.ts仍存在 (38 行),在index.ts第 27 行注册 - v0.11+ 状态: v0.11+ 计划标记为"已 deprecated",功能已并入
webapi/_buildformdata.ts - commit:
9c14cda refactor(v0.11+): form validate/fixcolumndata/bindflow 改用 webapi - 建议: 保留但标注 deprecated,新修复流程应直接用
form update或form clone
2.3 dacli form clone <workSystem_form_id> — 代码存在并升级
- SKILL.md 引用: 第 42-43 行(作为备选基线) + 第 56-57 行(--baseline 参数)
- 代码状态:
src/commands/form/clone.ts存在,已升级为 v0.11+ webapi 镜像- 改用
loadVisualDev.getInfo/create/release替代旧的c.get/postJson - 默认有浏览器层验证(
browserVerify) - commit:
b9729f1 feat(v0.11): Phase 1 续 - 7 命令切换 webapi
- 改用
- SKILL.md 缺失:
- 缺 webapi 化说明(仍描述为"export + import 一步到位"的旧语义)
- 缺浏览器验证默认行为说明(
--no-verify/--verify选项)
- 建议: 保留该命令作为兜底,但在 SKILL.md 中补充 webapi 化 + 浏览器验证说明
2.4 dacli form fix — 完全不存在,SKILL.md 误用
- SKILL.md 引用: 10 处(行 4, 7, 15-19, 45, 48, 56, 65)
- 代码状态: 完全不存在。
src/commands/form/中无fix.ts文件 - v0.11+ 重构:
- clone-baseline 模式已移至
form clone+ 内置 baseline (src/main/resources/dacli/baseline-schema.json) - webapi 化已消除 BS-51/52 根因(无需"修复",因为创建时就用 web 端
buildFormData)
- clone-baseline 模式已移至
- 建议: SKILL.md 必须全面迁移到 v0.11+ 实际可用的命令
3. 修复流程是否还成立
3.1 7 步法 Playbook(行 22-88)
原始流程:
- 诊断(form list/info, menu list)
- 选择基线(内置 or 指定 workSystem form ID)
- 运行
dacli form fix --baseline=... - 验证(form list, msrelation)
- 浏览器 E2E 验证
v0.11+ 流程需求:
- 诊断阶段 — 应增加
dacli app context --json(v0.10+ P0.1) - 基线选择 — 已自动用内置 baseline(无需 --baseline)
- 核心修复 — 改为
dacli form clone <workSystem_id>+dacli form update --fields=...(两步法) - 验证 — 应加入
dacli form lint(v0.11+ 新增)或form validate --fix(仍可用但 deprecated) - 浏览器验证 —
form clone默认自动浏览器层验证
3.2 clone-baseline 模式
- SKILL.md 主张(行 7, 36-44, 170-171): clone-baseline 是核心修复手段
- v0.11+ 实际:
- 内置 baseline 已自动化,无需显式 clone(行 36-44 仍正确)
- 但 SKILL.md 未提及
dacli form clone的 webapi 化升级(行 42-43 的 workSystem 表单 ID 833005095028268677 仍可作为兜底)
- 建议: 保留 clone-baseline 作为兜底,但增加
form update作为首选增量修复
3.3 state=2 重发布(行 20)
- SKILL.md 引用:
dacli form release(state 1→2) - v0.11+ 状态: 命令仍存在,但 v0.11+ 修复场景多在
form clone时用--release标志直接发布 - 建议: 该建议仍正确,但应增加
--releaseOnly选项说明(v0.11+form update新增)
4. 缺 webapi 化说明
SKILL.md 完全未提及以下 v0.11+ 关键变化:
-
dacli form clone现在走 webapi 镜像- 用
loadVisualDev.getInfo/create/release替代旧的c.get/postJson - 默认浏览器层验证(
browserVerify,硬阻塞) - SKILL.md 行 42-43 + 56-57 仍描述为"export + import 一步到位"的旧语义
- 用
-
dacli form update是 NEW-CMD (P0)- commit:
801a204 feat(v0.11+): form update P0 高需求 NEW-CMD (闭环 CRUD) - 功能: 改 form 元数据/字段/enCode (PUT 语义)
- 自动 BS-49/50/52 防御
- SKILL.md 完全未提及
- commit:
-
BS-51/52 根因已通过 webapi 镜像消除
- 旧
_simplify.ts(87 行) +_validate.ts已 deprecated - webapi 直接 import web 端
buildFormData,无 schema 漂移 - SKILL.md 行 7, 36 仍以"BS-51/52"为修复场景,但根因已消除
- 旧
-
三层防御体系 (L1/L2/L3)
- v0.10+ P0.1:
dacli app context --json应在诊断阶段必跑 - L1 precheck / L2 guard (22 条) / L3 diagnoseError
- SKILL.md 完全未提及
- v0.10+ P0.1:
5. 缺 v0.11+ NEW-CMD 章节
v0.11+ Phase 2 新增 30+ 命令,其中 form 相关 P0 NEW-CMD:
| 命令 | commit | SKILL.md 是否引用 | 用途 |
|---|---|---|---|
dacli form update |
801a204 |
❌ 缺失 | 增量改 schema (P0 高需求) |
dacli form selector |
(P2) | ❌ 缺失 | 列出可用 form 供选择 |
dacli form lint |
(P1) | ❌ 缺失 | schema 静态检查 |
建议: SKILL.md 应增加"v0.11+ 增量修复"章节,介绍 form update --fields=... 作为首选修复手段。
6. 优先级修复清单
P0 必修(影响 AI 频繁使用,必须改)
P0.1 — 行 4, 7, 15-19, 45, 48, 56, 65:删除所有 dacli form fix 引用
问题: dacli form fix 在 v0.11+ 中完全不存在
建议替换:
- 行 7(概述): 删除 "使用
dacli form fix命令修复",改为 "使用dacli form clone+dacli form update命令修复" - 行 15-19(诊断表): 将"dacli form fix"改为"dacli form clone + form update"
- 行 45, 48, 56, 65(步骤 3): 删除整个"运行 dacli form fix"小节,改为"克隆 + 增量更新"两步法
P0.2 — 行 7:删除 "clone-baseline 模式" 作为唯一修复手段
问题: v0.11+ webapi 化已消除根因,clone-baseline 只是兜底
建议:
- 行 7 改为: "当 JNPF 表单 API 返回 200 但浏览器不渲染时,使用
dacli form clone+dacli form update修复(webapi 化后,多数情况form update --fields=...即可解决)" - 增加段落说明: "如需复用特定表单的特殊配置(自定义按钮、特殊校验),仍可用
form clone --baseline=<id>兜底"
P0.3 — 行 45-72:删除步骤 3,重写为 v0.11+ 流程
问题: 步骤 3 全部基于不存在的 dacli form fix 命令
建议重写:
# 步骤 3a: 克隆基线表单 (如需)
dacli form clone <workSystem_form_id> \
--newEnCode=<新编码> --newFullName=<新名称> \
--release
# 步骤 3b: 增量更新 schema (首选)
dacli form update --id=<新form_id> \
--fields='[{"field":"f_xxx","label":"中文","jnpfKey":"input"},...]' \
--autoRelease
P1 同步(应改,影响架构理解)
P1.1 — 行 7, 9, 36-44:补充 webapi 化说明
问题: 未提及 v0.11+ webapi 镜像架构
建议:
- 行 7 末尾加: "v0.11+ 起,
form clone走 webapi 镜像(直接 import web 端buildFormData),无 schema 漂移" - 行 36-44 增加: "v0.11+ 起,BS-51/52 根因已消除,内置 baseline 仍是兜底"
P1.2 — 行 10, 106-119:补 form update 增量修复章节
问题: 缺 v0.11+ P0 NEW-CMD 介绍
建议: 在"参数说明"前增加"v0.11+ 增量修复"章节,说明 dacli form update --id=X --fields=Y 用法
P1.3 — 行 22-32:诊断阶段增加 dacli app context
问题: 未引用 v0.10+ P0.1 强制第一步
建议:
- 行 27 前增加:
# v0.10+ 必跑第一步:环境快照 dacli app context --json
P2 仅检查(不紧急,但可优化)
P2.1 — 行 20:补充 form release 的 --releaseOnly 选项
建议: 在常见问题中说明 form update --releaseOnly 可直接 state 0/2→1
P2.2 — 行 188-189:核实 form msrelation 是否存在
问题: form msrelation 未在 index.ts 中注册(15 个子命令中无此)
建议: 删除该引用或改为 form info --expand-subtable(已存在)
P2.3 — 行 80:核实 form msrelation 是否存在
建议: 同 P2.2,删除或替换
7. 关键建议总结
| 优先级 | 修改点 | 行号 | 核心改动 |
|---|---|---|---|
| P0 | 删除 dacli form fix 引用 |
4, 7, 15-19, 45, 48, 56, 65 | 替换为 form clone + form update |
| P0 | 步骤 3 重写 | 45-72 | 改为"克隆 + 增量更新"两步法 |
| P0 | 删除 clone-baseline 唯一性 描述 |
7, 36 | 改为兜底手段 |
| P1 | 补 webapi 化说明 | 7, 9, 36-44 | 强调 webapi 镜像 |
| P1 | 补 form update 章节 |
10, 106-119 | NEW-CMD 介绍 |
| P1 | 诊断阶段加 app context |
22-32 | v0.10+ 强制 |
| P2 | 核实 form msrelation 存在性 |
80, 188, 189 | 删除或替换 |
关键风险: dacli form fix 在 SKILL.md 中被引用 10+ 次,AI 使用此 skill 时会反复尝试调用不存在的命令,导致频繁错误。
修复后预期: SKILL.md 全面反映 v0.11+ 实际可用命令(form clone + form update + form lint),webapi 化说明清晰,NEW-CMD 章节完整。
附录: v0.11+ form 相关命令清单
| 命令 | 状态 | 来源 |
|---|---|---|
dacli form list |
✅ 存在 | list.ts |
dacli form info |
✅ 存在 | info.ts |
dacli form create |
✅ 存在 | create.ts (webapi 化) |
dacli form update |
✅ NEW-CMD | update.ts (P0, 801a204) |
dacli form release |
✅ 存在 | release.ts (webapi 化) |
dacli form delete |
✅ 存在 | delete.ts |
dacli form export |
✅ 存在 | export.ts |
dacli form import |
✅ 存在 | import.ts |
dacli form clone |
✅ 存在 | clone.ts (webapi 化) |
dacli form validate |
⚠️ Deprecated | validate.ts (功能并入 _buildformdata) |
dacli form fixcolumndata |
⚠️ Deprecated | fixcolumndata.ts (功能并入 _buildformdata) |
dacli form codegen |
✅ 存在 | codegen.ts |
dacli form lint |
✅ 存在 | lint.ts (v0.11+ P1) |
dacli form bindflow |
✅ 存在 | bindflow.ts (webapi 化) |
dacli form selector |
✅ 存在 | selector.ts (v0.11+ P2) |
dacli form fix |
❌ 不存在 | 重构/迁移至 form clone + form update |
dacli form msrelation |
❓ 未确认 | 未在 index.ts 注册 |