- 删 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 修复
10 KiB
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 开始执行