Files
dacli/docs/v0.11-cleanup-execution-plan.md
T
ssw c177b89e6c v0.11+ Phase A: 原子删除 (8 文件) - form lint/validate/fixcolumndata 旧 TS+测试
- 删 src/commands/form/_parsers.ts (P1-2, 仅 form lint 使用)
- 删 src/commands/form/_simplify.ts (P1-2, 仅 --fields 路径使用)
- 删 src/commands/form/lint.ts (P0-1, form lint 命令)
- 删 src/commands/form/validate.ts (P1-3, form validate 命令)
- 删 src/commands/form/fixcolumndata.ts (P1-4, form fixcolumndata 命令)
- 删 tests/unit/{form-lint,fix-columndata,field_normalize}.test.ts 3 个测试
- 加 docs/v0.11-{audit-report,cleanup-execution-plan}.md 2 个体检+执行计划文档

体检报告: docs/v0.11-audit-report.md
执行计划: docs/v0.11-cleanup-execution-plan.md
回滚: git revert HEAD (单 commit 安全回滚)

注意: src/commands/form/index.ts 现在引用了已删除文件, 需 Phase B 修复
2026-06-26 10:05:13 +08:00

10 KiB

dacli v0.11+ 体检报告清理 - 执行计划

触发入口: /v0.11-cleanup (重启后输入此命令开始执行) 审计报告: dacli/docs/v0.11-audit-report.md (v2) 执行日期: 2026-06-26 原则: 不考虑兼容老用户, 按 v0.11+ webapi 镜像架构全面对齐


Phase A: 原子删除 (~15 文件)

A.1 整个目录删除

cd /home/ubuntu/ccWorkDir
rm -rf .claude/skills/design-jnpf-execute/
rm -f .claude/templates/jnpf-design-card.tmpl
rm -f .claude/templates/jnpf-design-master-sub.tmpl
rm -f .claude/templates/jnpf-design-workflow.tmpl
rm -f .claude/templates/功能设计模板.md

A.2 旧 TS 代码删除

rm -f dacli/src/commands/form/_parsers.ts
rm -f dacli/src/commands/form/_simplify.ts
rm -f dacli/src/commands/form/lint.ts
rm -f dacli/src/commands/form/validate.ts
rm -f dacli/src/commands/form/fixcolumndata.ts

A.3 旧测试删除

rm -f dacli/tests/unit/form-lint.test.ts
rm -f dacli/tests/unit/fix-columndata.test.ts
rm -f dacli/tests/unit/field_normalize.test.ts

A.4 旧 e2e 脚本删除

rm -f .claude/skills/ssw-e2e-test/scripts/jnpf_client.py
rm -f .claude/skills/ssw-e2e-test/scripts/crud_e2e_template.py
rm -f .claude/skills/ssw-e2e-test/scripts/test_dacli_e2e.sh

A.5 form-fix 技能废弃

# 标记 deprecated (form fixcolumndata 已删)
echo "## ⚠️ 已废弃 (2026-06-26)" > /tmp/deprecated_marker
cat .claude/skills/form-fix/SKILL.md >> /tmp/deprecated_marker
mv /tmp/deprecated_marker .claude/skills/form-fix/SKILL.md

A.6 阶段 A 验证

# 确认删除成功
ls .claude/skills/ | grep -i design-jnpf-execute  # 应为空
ls dacli/src/commands/form/ | grep -E "_parsers|_simplify|lint|validate|fixcolumndata"  # 应为空
ls .claude/skills/ssw-e2e-test/scripts/ | grep -E "jnpf_client|crud_e2e|test_dacli_e2e"  # 应为空

Phase B: 改写 dacli/src (12 文件)

B.1 form/index.ts (主入口)

  • 删 import { buildFormLintCommand } from './lint.ts'
  • 删 import { buildFormValidateCommand } from './validate.ts'
  • 删 import { buildFormFixColumnDataCommand } from './fixcolumndata.ts'
  • 删 3 个 cmd.addCommand(...)

B.2 form/create.ts

  • 删 import { wrapSimplifiedFields, buildTablesFromFields, toSimpleField } from './_simplify.ts'
  • wrapSimplifiedFields(...) 调用处 (260 行附近) → 报错退出: log.error('--fields 已废弃, 请用 --ai-json (v0.11+ 走 web 端 buildFormData)'); process.exit(2)
  • buildTablesFromFields(...) 调用处 → 同上报错
  • --type 默认值改 4 → 2
  • --ai-json 路径 opts.type = '4' 硬编码 → 删 (保持 --type 用户传入)

B.3 form/import.ts

  • 改 auto-rename 行为: 不再依赖 workSystem baseline, 默认 --table={enCode} 不加 <appCode>_ 前缀
  • 加 deprecation warning: log.warn('form import 已废弃, 推荐 form create --ai-json')

B.4 form/clone.ts

  • 删 type=4 兜底引用 (line ~30)
  • 改: 克隆时强制 type=2

B.5 form/selector.ts

  • 删 type=4 引用

B.6 form/_blindspots.ts

  • 删 BS-15/BS-23/BS-31/BS-32/BS-50/BS-52 + BS-V2 的 check 函数 (保留 BS-5/8/37/43/44/47/48/49)

B.7 _blindspot_guards.ts

  • 同上: 删 6 类盲点 + BS-V2

B.8 _precheck.ts

  • 删 type=4 兜底引用

B.9 form/release.ts

  • BS-50 false positive (release 命令触发 menu create 的 guard) → 修: runGuards 加 __command === 'menu create' 限制

B.10 core/client.ts

  • 删 --fields 简化版相关常量

B.11 core/types.ts

  • 删 fixcolumndata 相关类型导出

B.12 commands/app/context.ts

  • 删 fixcolumndata 引用

B.13 commands/test/check.ts

  • 删 6 类盲点必查 (BS-15/23/31/32/50/52)

B.14 阶段 B 验证

cd /home/ubuntu/ccWorkDir/dacli && npm run typecheck
npx tsx src/cli.ts form --help | grep -E "lint|validate|fixcolumndata"  # 应为空
npx tsx src/cli.ts form create --help | grep "ai-json"  # 应有

Phase C: 改写 .claude/ 提示词 (~20 文件)

C.1 顶层

  • .claude/CLAUDE.md - 删 form validate/fixcolumndata/--fields 段, 改 --ai-json 例子
  • .claude/commands/ssw-h5dev-flow.md - 整个重写 (按 7 阶段表)
  • .claude/commands/ssw-onlinedev.md - 改 --fields → --ai-json

C.2 dacli-ts skill (主技能)

  • .claude/skills/dacli-ts/SKILL.md - 删"阶段 2.5 lint 硬关卡"段, 删 6 类盲点必查清单, 改 --fields → --ai-json
  • .claude/skills/dacli-ts/references/commands.md - 删 form lint/validate/fixcolumndata, 加 --ai-json
  • .claude/skills/dacli-ts/references/patterns.md - 删旧 --fields pattern, 加 --ai-json
  • .claude/skills/dacli-ts/references/errors.md - 删 form lint/validate/fixcolumndata 错误, 改 --fields DB exception → --ai-json JSON parse
  • .claude/skills/dacli-ts/references/anti-patterns.md - 删 --fields 简化版 anti-pattern
  • .claude/skills/dacli-ts/references/troubleshooting.md - 标 f_description/f_version sed 案例 deprecated, 加 --ai-json troubleshooting
  • .claude/skills/dacli-ts/references/web-source-map.md - 删 lint/validate/fixcolumndata 入口, --fields → --ai-json
  • .claude/skills/dacli-ts/examples/create-simple-form.sh - 改 --fields → --ai-json
  • .claude/skills/dacli-ts/examples/create-master-sub-form.sh - 改 --fields → --ai-json
  • .claude/skills/dacli-ts/examples/create-workflow.sh - 改 --fields → --ai-json
  • .claude/skills/dacli-ts/examples/baseline/* - 全部改 (如适用)
  • .claude/skills/dacli-ts/scripts/self-check.sh - 删 form validate 调用

C.3 其他 SKILL 改写

  • .claude/skills/form-development/SKILL.md - 删 type=4 兜底, --fields → --ai-json, 删 6 类盲点
  • .claude/skills/data-management/SKILL.md - 整个重写 (dm create 应改为字段 JSON)
  • .claude/skills/ssw-e2e-test/SKILL.md - 整个重写 (用 dacli test)
  • .claude/skills/workflow-development/SKILL.md - 整个重写 (教 dacli workflow 命令)
  • .claude/skills/menu-configuration/SKILL.md - 整个重写 (教 dacli menu --formId)
  • .claude/skills/data-interface/SKILL.md - 整个重写 (教 dacli di)
  • .claude/skills/code-generator/SKILL.md - 删 form validate 段
  • .claude/skills/platform-mechanism/SKILL.md + references/jnpf-form-data-model.md - 删 f_description 段

C.4 no-spa-page 模板修

  • .claude/skills/no-spa-page/templates/entity.java - 删 "禁止 f_version" 注释
  • .claude/skills/no-spa-page/templates/module.js - f_description → f_app_desc

C.5 其他清理

  • .claude/skills/jnpf-browser-automation/examples/regression-test.md - 删 03_forms.py 引用
  • .claude/skills/jnpf-browser-automation/scripts/regression_test.py - 删 03_forms.py 引用

C.6 dacli/docs/ 历史档

  • dacli/docs/skill-audit/design-jnpf-execute.md - 删
  • dacli/docs/skill-audit/ssw-h5dev-flow.md - 重新审计后改写
  • dacli/docs/skill-audit/form-fix.md - 标 deprecated

C.7 阶段 C 验证

# 验证 --fields 已不出现
grep -rln "wrapSimplifiedFields\|parsePythonForms\|form lint\|03_forms.py" /home/ubuntu/ccWorkDir/.claude/ 2>&1 | head -5
# 应为空 (或只剩 history_bak)

Phase D: 端到端验证

D.1 TS 编译

cd /home/ubuntu/ccWorkDir/dacli && npm run typecheck

D.2 命令可用性

cd /home/ubuntu/ccWorkDir/dacli
npx tsx src/cli.ts form --help                # 确认 5 个命令已删
npx tsx src/cli.ts form create --help         # 确认 --ai-json 在, --fields 报错
npx tsx src/cli.ts form info <existing_id>    # 确认 info 正常
npx tsx src/cli.ts test --help                # 确认 dacli test 可用

D.3 跑 baseline 测试

cd /home/ubuntu/ccWorkDir/dacli && npm run test  # vitest

D.4 跑 form 业务流

# 切到 developSystem 找一个 form 测试
dacli app switch --appCode=developSystem
dacli form info 797437045977907781  # 测试 form info 仍正常

D.5 跑 ssw-h5dev-flow 端到端 (dry-run)

# 不实际建表, 验证 SKILL 触发正常
ls /home/ubuntu/ccWorkDir/.claude/commands/ssw-h5dev-flow.md
grep "v0.11" /home/ubuntu/ccWorkDir/.claude/commands/ssw-h5dev-flow.md  # 应有新版本标记

Phase E: 提交 + MEMORY

E.1 git 提交

cd /home/ubuntu/ccWorkDir
git add -A
git commit -m "v0.11+ 全面清理: 删 form lint/validate/fixcolumndata/design-jnpf-execute/ssw-e2e-test 自写 e2e; --ai-json 替代 --fields; workflow/menu/di/ssw-h5dev-flow 重写"
git push origin main

E.2 MEMORY

# 写 MEMORY 文件
cat > /home/ubuntu/.claude/projects/-home-ubuntu-ccWorkDir/memory/dacli-v0.11-cleanup-2026-06-26.md <<'EOF'
---
name: dacli-v0.11-cleanup-2026-06-26
description: v0.11+ 全面清理: form lint/validate/fixcolumndata + design-jnpf-execute + --fields 路径全部删除, --ai-json + webapi 镜像为唯一路径
metadata:
  type: project
---

2026-06-26 v0.11+ webapi 镜像架构下, 旧 v0.10- 内容已全部抹去.

**体检报告**: `dacli/docs/v0.11-audit-report.md` (v2)
**执行计划**: `dacli/docs/v0.11-cleanup-execution-plan.md`

**Why**: 不考虑兼容老用户. 新架构 (webapi 镜像 + --ai-json + buildFormData) 已自动保证 schema 完整性 (BS-51/52/54), 旧的 03_forms.py / form lint / 6 类盲点必查 / dispatch 子代理 全部失效.

**How to apply**: 见体检报告 + 执行计划. AI 新会话必走 --ai-json 路径, 不再写 --fields / 03_forms.py / design-jnpf.html / form lint. 关联字段用 relationForm (webapi 镜像自动保证).

**改动摘要**: ~60 文件改动, ~25 文件删除. 涉及 form/workflow/menu/di/ssw-h5dev-flow/ssw-e2e-test 等多个 skill 和 command. 6 类盲点 BS-15/23/31/32/50/52 + BS-V2 在 SKILL 提示词中全部删除, 22 条 guard 删 6 类后保留 BS-5/8/37/43/44/47/48/49 等运行时兜底.
EOF

# 更新 MEMORY.md 索引
echo "- [dacli v0.11+ 全面清理 2026-06-26](dacli-v0.11-cleanup-2026-06-26.md) — 体检报告 + 执行计划, --ai-json 唯一路径" >> /home/ubuntu/.claude/projects/-home-ubuntu-ccWorkDir/memory/MEMORY.md

总览

Phase 文件数 风险 回滚
A 原子删除 15 低 git revert
B TS 改写 12 中 git revert (单 commit)
C 提示词改写 25+ 低 git revert
D 验证 0 无 -
E 提交 + MEMORY 2 无 -

总耗时预估: 30-60 min (改写 + 验证) 总风险: 中 (Phase B 涉及 TS 类型/逻辑, 需 typecheck + 测试) 回滚方式: 整个执行计划是一组 commit, 可单 commit 回滚或全 revert


重启后入口: 输入 /v0.11-cleanup 开始执行