Files
dacli/docs/drift
sswandClaude 64fbb4ac0a docs: archive cmd-review 25 + drift round 20 (2026-07-23)
清理 help 体系干扰/过期信息, 整体归档:

1. cmd-review/ 25 文件 → archive/cmd-review-2026-07/
   - 22 个 2026-06-30 一波生成的命令审计
   - 1 个 bigscreen-components (2026-07-01)
   - 1 个 bigscreen (2026-07-01)
   - 1 个 app (2026-07-01)
   - 含 form/dm/menu M2 实战更新版 (建议已落地, 整体降级归档)
   - cmd-review/ 留 README.md 指针

2. drift/ 20 个 round summary → archive/drift-rounds-2026-07/
   - round 3-4/5/6/7/7b/8/9/10/11/12/13/14/15/16/17 + day summary
   - drift/ 保留 README/USAGE/fetch-baseline.sh 基础设施
   - drift/README.md 加 ⚠️ 头

3. 改引用:
   - dacli/README.md §必读文档 改指 archive
   - 7 个 ADR (0001-0004/0011/0013/0015) 顶部加 ⚠️ 头说明引用路径已迁
   - archive/README.md 加 cmd-review-2026-07/ + drift-rounds-2026-07/ 段, 更新结构图, 更新 AI 误读防御清单

新权威源:
- 命令用法 → 'dacli <cmd> --help' (DacliHelp 注入 pitfalls/bestPractices/decisionTree)
- 决策理由 → docs/decisions/0001-0016 ADR (git-tracked, 权威)
- 反模式 → docs/anti-patterns.md (auto-gen, _anti_patterns.ts 为单一权威)

触发: 用户反馈 'dacli help 体系感觉很多干扰/过期信息, 看看怎么处理'
      + 'cmd-review 22 + drift 13 round 意义不大, 也可归档'

Co-Authored-By: Claude <[email protected]>
2026-07-23 15:04:18 +08:00
..

dacli Drift Detection Loop

目的:用 JNPF baseline(developSystem + workSystem)当 oracle,通过 /loop TDD 模式检测 dacli 重建行为漂移。

工作流概览(5 个环节)

Phase 1: 脚本直读 JNPF DB → /tmp/dacli-loop/baseline-{ts}.json
Phase 2: AI 推理描述(oracle JSON → 业务描述字符串)
Phase 3: AI 用 dacli <module> create --ai "<描述>" 重建(仅 testspace)
Phase 4: AI diff(baseline vs 新生成)
Phase 5: AI 写测试 + 写本轮 summary

详见 /home/ubuntu/.claude/plans/abstract-churning-adleman.md(完整设计)。

覆盖模块(8 个)

模块 baseline 表 重建命令 测试文件
form base_visual_dev dacli form create --ai "<描述>" dacli/tests/integration/drift/form-drift.spec.ts
workflow base_workflow_template dacli workflow create --ai "<描述>" dacli/tests/integration/drift/workflow-drift.spec.ts
di base_data_interface dacli di create --ai "<描述>" dacli/tests/integration/drift/di-drift.spec.ts
menu base_menu dacli menu create --formId=<id> --ai "<描述>" dacli/tests/integration/drift/menu-drift.spec.ts
dict base_dict_type + base_dict_data dacli dict typeCreate --ai "<描述>" dacli/tests/integration/drift/dict-drift.spec.ts
role base_role dacli role create --ai "<描述>" dacli/tests/integration/drift/role-drift.spec.ts
report base_visual_report dacli report create --ai "<描述>" dacli/tests/integration/drift/report-drift.spec.ts
datascreen blade_visual dacli bigscreen construct --ai "<描述>" dacli/tests/integration/drift/datascreen-drift.spec.ts

关键约束

  • Loop 不改 dacli 业务代码:loop 只产出测试 + summary
  • 所有文档归本目录:{YYYY-MM-DD}-summary.md(每轮一份)
  • 测试归 dacli/tests/integration/drift/:每个漂移类别 1 个 vitest case(durable 资产)
  • /loop 用 Claude Code 平台自带:不包装自定义 skill

文件索引

每轮总结(按时间倒序)

  • (暂无,第一轮 loop 跑完后生成)

历史归档

(按月份归档总结)

Polishing 触发流程

读最新 {date}-summary.md → 看到待修漂移类别 → 开修复会话:

# 1. 看当前漂移状态
cat dacli/docs/drift/$(date +%Y-%m-%d)-summary.md

# 2. 跑相关测试(vitest 失败信息是修复入口)
cd $ccWorkDir/dacli && npx vitest run tests/integration/drift/{module}-drift.spec.ts

# 3. 读失败信息 → 改 dacli → 跑通 → 标 [x] → 提交
# commit: "fix: {category} drift (BS-新X)"

/loop 启动模板

在 Claude Code 会话里:

# Round 1 (form 模块):
/loop 30m "1. 跑 fetch-baseline.sh 拿 form baseline → /tmp/dacli-loop/baseline-{ts}.json
2. 读 JSON,推理 form 描述(enCode + fullName + 字段 label)
3. 在 testspace 跑 'dacli form create --ai \"<描述>\" --autoRelease'
4. diff baseline vs 重建结果,按字段分类 missing/extra/changed
5. 写 vitest 到 dacli/tests/integration/drift/form-drift.spec.ts
6. 写 summary 到 dacli/docs/drift/{date}-summary.md"

Round 1 启动 Checklist

  • DB 连接配置(~/.dacli-token/db-config.env,PG_CONN 指向 JNPF 业务库)
  • JNPF 平台 DB 表名确认(base_visual_dev 等)
  • testspace 应用可用(dacli app switch --appCode=testspace)
  • 跑 fetch-baseline.sh → JSON 含 21+53=74 张 form
  • AI 跑完整 Phase 2-5 → 测试 PASS + summary 写好
  • Round 1 commit: "Round 1: drift loop 初始化 + form 模块 N 份漂移测试"

注意事项

  1. JNPF DB 表结构:跟 JNPF 版本耦合,升级后表名/字段可能变,需更新 SQL
  2. testspace 隔离:重建只在 testspace,不污染 developSystem/workSystem baseline
  3. commit 节奏:每轮 /loop 一 commit(CLAUDE.md §14)
  4. NCPF 不确定性:--ai 走 NCPF backend LLM,行为可能波动,必要时多跑几次取一致结果

相关文档

  • /home/ubuntu/.claude/plans/abstract-churning-adleman.md — 完整设计(plan)
  • dacli/.claude/skills/dacli/SKILL.md — dacli 主 skill(loop 入口索引)
  • dacli/.claude/skills/dacli/references/baseline/README.md — 现有 baseline 复刻体系(与 drift loop 互补)
  • dacli/.claude/skills/dacli/examples/baseline/all.sh — 现有 baseline 复刻脚本(参考模式)

各轮总结索引

Round 文件 主要内容
1 (无文件) Drift loop 初始化 + form 模块 N 份漂移测试
2-4 (合并) form + workflow + dict drift 闭环
5 2026-07-14-round5-menu-workflow-summary.md menu + workflow drift 52 tests
6 2026-07-14-round6-w3-mirror-summary.md 镜像 web bpmnLintUtil.ts
7 2026-07-14-round7-autolayout-c-summary.md C方案 autoLayout
7b 2026-07-14-round7b-autolayout-mirror-summary.md B方案 真镜像 web constructTreeUtil.ts
8 2026-07-14-round8-blindspot-solidify.md 盲点固化 9 个
9 2026-07-14-round9-dict-di-drift-summary.md dict + di drift 11 类别
10 2026-07-14-round10-drift-fix-summary.md BS-NCPF-400 + BS-drift-DI-1/2/3
11 2026-07-14-round11-ai-user-workflow-blindspot.md 本轮: --ai 错误分类 + user resetPwd + NCPF retry + LLM NPE + 2 已知不可修