Files
dacli/docs/drift/README.md
T
2026-07-17 12:20:48 +08:00

111 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 自动维护,新一轮追加到顶部 -->
- (暂无,第一轮 loop 跑完后生成)
### 历史归档
(按月份归档总结)
## Polishing 触发流程
读最新 `{date}-summary.md` → 看到待修漂移类别 → 开修复会话:
```bash
# 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 会话里:
```bash
# 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 已知不可修** |