Files
dacli/docs/skill-audit/form-fix.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

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)
  • 建议: SKILL.md 必须全面迁移到 v0.11+ 实际可用的命令

3. 修复流程是否还成立

3.1 7 步法 Playbook(行 22-88)

原始流程:

  1. 诊断(form list/info, menu list)
  2. 选择基线(内置 or 指定 workSystem form ID)
  3. 运行 dacli form fix --baseline=...
  4. 验证(form list, msrelation)
  5. 浏览器 E2E 验证

v0.11+ 流程需求:

  1. 诊断阶段 — 应增加 dacli app context --json(v0.10+ P0.1)
  2. 基线选择 — 已自动用内置 baseline(无需 --baseline)
  3. 核心修复 — 改为 dacli form clone <workSystem_id> + dacli form update --fields=...(两步法)
  4. 验证 — 应加入 dacli form lint(v0.11+ 新增)或 form validate --fix(仍可用但 deprecated)
  5. 浏览器验证 — 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+ 关键变化:

  1. dacli form clone 现在走 webapi 镜像

    • 用 loadVisualDev.getInfo/create/release 替代旧的 c.get/postJson
    • 默认浏览器层验证(browserVerify,硬阻塞)
    • SKILL.md 行 42-43 + 56-57 仍描述为"export + import 一步到位"的旧语义
  2. 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 完全未提及
  3. BS-51/52 根因已通过 webapi 镜像消除

    • 旧 _simplify.ts (87 行) + _validate.ts 已 deprecated
    • webapi 直接 import web 端 buildFormData,无 schema 漂移
    • SKILL.md 行 7, 36 仍以"BS-51/52"为修复场景,但根因已消除
  4. 三层防御体系 (L1/L2/L3)

    • v0.10+ P0.1:dacli app context --json 应在诊断阶段必跑
    • L1 precheck / L2 guard (22 条) / L3 diagnoseError
    • SKILL.md 完全未提及

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 注册