docs: SKILL.md + references/drift-loop.md (漂移循环文档化)
dacli-ts 技能加漂移循环参考:
- 新建 references/drift-loop.md (5 步工作流 + 模块命令速查 + 通用漂移模式 + 反模式 + 产物清单)
- SKILL.md 加 🔁 漂移循环段, 链 references/drift-loop.md + MEMORY 抽象原则
完整生态:
- MEMORY (抽象原则, 跨工具): dacli-drift-loop-methodology.md
- references/drift-loop.md (dacli 具体工作流, 含 fetch-baseline.sh 路径)
- SKILL.md (技能入口, 触发词)
- dacli/docs/drift/ (实际脚本 + 10 轮总结)
覆盖 9 模块: form/menu/dict/di/workflow/role/portal/datascreen/report
This commit is contained in:
1 parent
a2427b6e50
commit
0da79fc0b8
2 files changed
+134
No files matched your search
@@ -694,6 +694,35 @@ dacli app switch --appCode=testspace # 切到 testspace 统一测试场验
|
||||
|
||||
---
|
||||
|
||||
## 🔁 漂移循环 (检测 dacli 行为跟 baseline 的 schema 漂移)
|
||||
|
||||
> **dacli 跨模块通用检测模式**: 拉 baseline → 重建 → diff → 写 vitest → 修 dacli → 防回归.
|
||||
> **完整参考**: `references/drift-loop.md` (5 步工作流 + 模块命令速查 + 通用漂移模式)
|
||||
> **抽象原则** (跨工具适用): `~/.claude/projects/.../memory/dacli-drift-loop-methodology.md`
|
||||
|
||||
**何时用**:
|
||||
- 接入新 dacli 模块 (form/menu/dict/di/workflow/role/portal/datascreen/report) 时: 跑 Round 1 找 5-10 类漂移
|
||||
- 已修漂移回归报警: vitest FAIL = 有人改了工具默认值
|
||||
- 用户报"重建丢字段/类型错"时: 5 分钟验证是不是已知漂移模式
|
||||
|
||||
**最小 3 步** (跟 `dacli/docs/drift/USAGE.md` 同步):
|
||||
```bash
|
||||
# 1. 拉 baseline (一次性, 几秒)
|
||||
bash /home/ubuntu/ccWorkDir/dacli/docs/drift/fetch-baseline.sh
|
||||
# 输出: /tmp/dacli-loop/baseline-{ts}.json
|
||||
# 验证: 60 forms + 19 workflows + 33 di + 185 menus + 50 dict + ...
|
||||
|
||||
# 2. 切 testspace (CLAUDE.md Rule 13: 不污染 baseline)
|
||||
dacli app switch --appCode=testspace
|
||||
|
||||
# 3. 跑漂移测试 (10 轮已有, Round 1-10 总结在 dacli/docs/drift/)
|
||||
cd /home/ubuntu/ccWorkDir/dacli && npx vitest run tests/integration/drift/{module}-drift.spec.ts
|
||||
```
|
||||
|
||||
**已知 11 类漂移 (Round 1-10 已闭环)**: 5 menu/wf + 6 dict/di, 详见 `references/drift-loop.md` §4.
|
||||
|
||||
---
|
||||
|
||||
## 🔁 长任务自检规则(避免"错了继续跑")
|
||||
|
||||
长流程**每 5 个 dacli 命令后**强制做一次自检(E 类根因:**"不停下来问"变成"错了继续"**):
|
||||
|
||||
@@ -0,0 +1,105 @@
|
||||
# dacli 漂移循环 (Drift Loop) — 工作流参考
|
||||
|
||||
> **用途**: 检测 dacli 命令跟 baseline (JNPF 平台真实示例) 的 schema 漂移, 修复后用 vitest 防回归.
|
||||
> **适用模块**: form / menu / dict / di / workflow / role / portal / datascreen / report (9 个)
|
||||
> **抽象原则** (跨工具适用): 见 `~/.claude/projects/.../memory/dacli-drift-loop-methodology.md`
|
||||
|
||||
---
|
||||
|
||||
## 1. 入口 (3 步上手)
|
||||
|
||||
```bash
|
||||
# Step 1: 拉 baseline (一次性, 几秒)
|
||||
bash /home/ubuntu/ccWorkDir/dacli/docs/drift/fetch-baseline.sh
|
||||
# 输出: /tmp/dacli-loop/baseline-{ts}.json
|
||||
# 验证: 60 forms + 19 workflows + 33 di + 185 menus + 50 dict + 11 roles + 15 reports + 69 datascreens
|
||||
|
||||
# Step 2: 切 testspace (CLAUDE.md Rule 13: 统一测试场, 不污染 baseline)
|
||||
dacli app switch --appCode=testspace
|
||||
|
||||
# Step 3: 跑 /loop (Claude Code 非 plan mode, 30 分钟一循环)
|
||||
# 完整 prompt + 模板: /home/ubuntu/ccWorkDir/dacli/docs/drift/USAGE.md
|
||||
```
|
||||
|
||||
**只跑某模块**:
|
||||
```bash
|
||||
bash fetch-baseline.sh --module=form
|
||||
bash fetch-baseline.sh --module=di,dict
|
||||
bash fetch-baseline.sh --module=form --output=/tmp/my.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 各模块重建命令速查
|
||||
|
||||
| 模块 | 关键描述提取 | 重建命令 (核心选项) |
|
||||
|------|--------------|---------------------|
|
||||
| form | `formData.fields[].__config__.label` | `dacli form create --ai "<描述>" --autoRelease` (v0.13+ 一条端到端) |
|
||||
| menu | `f_full_name` + `f_type` + `f_url_address` | `dacli menu create --formId=<id> --ai "<描述>"` (低级模式) |
|
||||
| dict | `f_full_name` + items | `dacli dict typeCreate --items=<json> --parentId=<id> --category=<0\|1>` (3 选项必传) |
|
||||
| di | `f_action` + 参数字段数 | `dacli di create --fieldJson=<json> --parameterJson=<json> --dataConfigJson=<json>` (3 选项必传) |
|
||||
| workflow | `f_flow_id` + 节点类型列表 | `dacli workflow create --ai "<描述>"` |
|
||||
| role | `f_full_name` + `f_global_mark` | `dacli role create --ai "<描述>"` |
|
||||
| report | `f_fullname` + 列数 | `dacli report create --ai "<描述>"` |
|
||||
| datascreen | `title` + 组件数 | `dacli bigscreen construct --ai "<描述>"` |
|
||||
|
||||
**关键**: dict 和 di 重建必须传 schema JSON 选项, 否则丢字段 (BS-drift-D-1/2/3, BS-drift-DI-1/2/3). 详见 `SKILL.md` di 段.
|
||||
|
||||
---
|
||||
|
||||
## 3. 5 步工作流 (与 MEMORY 抽象原则对齐)
|
||||
|
||||
| 步骤 | 操作 | 工具/产物 |
|
||||
|------|------|-----------|
|
||||
| 1. 拉 baseline | `bash fetch-baseline.sh` | `/tmp/dacli-loop/baseline-{ts}.json` |
|
||||
| 2. 挑样本 (5 随机) | python 脚本 + seed | baseline 子集 |
|
||||
| 3. 切 testspace 重建 | `dacli app switch` + `dacli <cmd> create` | 新 id (testspace 应用) |
|
||||
| 4. diff + 分类 | python 读 baseline + DAC API 拉重建 | 漂移分类: fields_missing/extra/changed/parent_missing/type_wrong |
|
||||
| 5. 写 vitest + 修 dacli | `dacli/tests/integration/drift/{module}-drift.spec.ts` | 测试初始 FAIL → 修 dacli → PASS |
|
||||
|
||||
**测试初始 FAIL 是预期** (漂移存在), 修完 PASS 是防回归.
|
||||
|
||||
---
|
||||
|
||||
## 4. 通用漂移模式 (dacli 高频)
|
||||
|
||||
| 模式 | 默认值 (错的) | baseline 真实 | 影响 |
|
||||
|------|---------------|---------------|------|
|
||||
| 字段透传丢失 | `[]` / `{}` / 空模板 | items / fields / SQL config | 浏览器 select 空, DI 不可调 |
|
||||
| 父级关联丢失 | `parentId=0` (顶级) | sub-classification id | 树形结构破坏 |
|
||||
| 类型默认值错 | `type/category=0` (业务) | `type=1` (系统) | 系统字典被业务化 |
|
||||
| 排序码丢 | `sortCode=0` | 用户配置 | 顺序错乱 |
|
||||
| 关联 id 丢 | `propertyJson.moduleId=""` | form/di/dict id | 引用断链 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 反模式 (3 红牌)
|
||||
|
||||
- ❌ **批量冲 N 个再 debug**: 失败累积难回滚 (Phase 4 prototype 1 原则)
|
||||
- ❌ **修完只口头验证不写测试**: 下次改代码就回归
|
||||
- ❌ **改 baseline 验证**: 污染 dacli 0 差错基线, 切 testspace
|
||||
|
||||
---
|
||||
|
||||
## 6. 产物清单
|
||||
|
||||
| 路径 | 用途 |
|
||||
|------|------|
|
||||
| `/home/ubuntu/ccWorkDir/dacli/docs/drift/fetch-baseline.sh` | 拉 baseline 脚本 |
|
||||
| `/home/ubuntu/ccWorkDir/dacli/docs/drift/USAGE.md` | 3 步上手 + 最小可跑 prompt + 模块命令速查 |
|
||||
| `/home/ubuntu/ccWorkDir/dacli/docs/drift/{date}-round{N}-*.md` | 每轮总结 (Round 1-10 已有) |
|
||||
| `/home/ubuntu/ccWorkDir/dacli/tests/integration/drift/*.spec.ts` | 漂移测试 (form/menu/dict/di/workflow-drift) |
|
||||
| `/tmp/dacli-loop/baseline-{ts}.json` | baseline 快照 (gitignored) |
|
||||
| `/tmp/dacli-loop/{module}-info/{id}.json` | 重建快照 (gitignored) |
|
||||
|
||||
---
|
||||
|
||||
## 7. 与其他参考的关系
|
||||
|
||||
| 参考 | 关系 |
|
||||
|------|------|
|
||||
| `MEMORY/dacli-drift-loop-methodology.md` | 抽象原则 (跨工具适用), 本文件是 dacli 具体实现 |
|
||||
| `references/dacli-dev-workflow.md` | 改 dacli 4 步流程 (改源码用), 本文件是检测漂移 (发现 bug 用) |
|
||||
| `references/anti-patterns.md` | 反模式 (12 个), 包含"凭印象写代码"等根因, 本文件是漂移检测专项 |
|
||||
| `references/baseline/` | baseline 0 差错定义 (复刻要 0 错), 本文件是 baseline 漂移检测 |
|
||||
| `references/test-render.md` (TC-C) | 单 form 静态分析 9 关卡, 本文件是跨模块集成漂移检测 |
|
||||
Reference in new issue
Block a user