Revert "docs(v0.11+): 下一阶段执行 plan - 上下文爆了前备份"
This reverts commit 0cb7c3ee76.
This commit is contained in:
1 parent
0cb7c3ee76
commit
6ff428ff3a
13 files changed
+2457
-327
No files matched your search
@@ -1,327 +0,0 @@
|
||||
# dacli v0.11+ 下一阶段执行 Plan (2026-06-25)
|
||||
|
||||
> **给下一轮 AI(clear 后)**: 这是用户给的 10 个要求的完整执行 plan.
|
||||
> 上一轮上下文爆了, 但 webapi scaffolding + form/workflow selector + source-analysis 已完成并推送.
|
||||
> 用户备份了, 可以大胆改.
|
||||
|
||||
---
|
||||
|
||||
## 0. 一句话总览
|
||||
|
||||
**逐个过 23 个 dacli 父命令 + 18 个 web 页面, 用 webapi 镜像 + AI 痛点驱动新增/修改/删除命令, 同步所有 .claude/** 文件, 清理历史残留盲点/B**, 用官方示例验证, 必要时改 web/** 源码并存 docs/web-patches/.**
|
||||
|
||||
---
|
||||
|
||||
## 1. 用户 10 个要求 (摘要)
|
||||
|
||||
1. **逐个过 dacli 命令源码** - 不要批量, 一个一个分析
|
||||
2. **分析对应 web 页面** - 看 views/**/*.vue 操作逻辑, 决定命令改/删/留
|
||||
3. **webapi 镜像** - 优先 import web 端, 减少漂移
|
||||
4. **官方示例验证** - workSystem/developSystem 跑通
|
||||
5. **.claude/** 全过** - 24 个 skill + 父 CLAUDE.md 全部更新一致
|
||||
6. **可改 web/** 源码** - 谨慎, web/views/ssw/** 改动存 dacli/docs/web-patches/
|
||||
7. **任务长, 用子代理** - 用 subagent-driven-development 派子代理并行
|
||||
8. **清理历史残留** - 旧 B**/盲点/业务信息, 避免干扰 AI
|
||||
9. **已备份, 大胆改**
|
||||
10. **联动 ssw-h5dev-flow/ssw-test/no-spa-page/design-jnpf-execute** - 这些 skill 也调
|
||||
|
||||
---
|
||||
|
||||
## 2. 当前状态盘点 (基线)
|
||||
|
||||
### 已完成 ✅
|
||||
- webapi/ 6 模块, 76 函数镜像 (visualDev 30 / dataModel 10 / dataSource 11 / menu 15 / dict 15 / workflow 14 - 实际 95 函数)
|
||||
- 7 命令样板切换 (form/list form/info form/release form/clone dm/list dm/fields menu/list)
|
||||
- 2 新增命令 (form/selector workflow/selector) - webapi 直 import
|
||||
- 数据清理: scripts/extract-all.mjs (350 行) + data/*.json (4 个) + scripts/extract-web-schema.py
|
||||
- web-patches/ 3 文档 (README + 2 patch)
|
||||
- source-analysis.md 缺口分析 (18 模块 + P0/P1/P2 分级)
|
||||
- SKILL.md (dacli-ts) + form-development + workflow-development 同步
|
||||
|
||||
### 已推送 commit
|
||||
```
|
||||
727b13c feat(v0.11+): Phase A-E AI 工作流闭环
|
||||
a024271 docs(v0.11): dacli/docs/web-patches/ 建立
|
||||
b9729f1 feat(v0.11): Phase 1 续 - 7 命令切换 webapi
|
||||
c29d6bd docs(.claude): v0.11+ Phase 1+2 同步
|
||||
a17fd03 chore(v0.11): Phase 2 清理 - 删 extract-all.mjs
|
||||
2f36878 refactor(v0.11): Phase 1 续 - form/info + dm/list
|
||||
d4506fe feat(webapi): v0.11+ Phase 1
|
||||
```
|
||||
|
||||
### 分支
|
||||
- `feat/dacli-user-commands-v18` (当前)
|
||||
|
||||
### dacli 父命令清单 (23 个, 待逐个过)
|
||||
```
|
||||
apis / app / bigscreen / datasource / di / dict / dm / doc / form / integration
|
||||
log / menu / monitor / msg / org / portal / print / report / role / schedule
|
||||
storage / user / workflow
|
||||
```
|
||||
|
||||
### .claude/ skills (24 个, 待同步)
|
||||
- dacli-ts (v0.10+ 防御体系 + webapi 架构段, 已更新)
|
||||
- form-development, form-fix (已加 selector 段)
|
||||
- workflow-development (已加 selector 段)
|
||||
- 其他待过: design-jnpf-execute, ssw-h5dev-flow, ssw-test, no-spa-page,
|
||||
backend-dev, data-interface, data-management, data-screen, menu-configuration,
|
||||
platform-mechanism, troubleshooting, mmx-cli, api-test, jnpf-browser-automation,
|
||||
ssw-pack-init, ssw-e2e-test, frontend-dev, code-generator, ai-debug-export, ai-debug-import, basic-standards
|
||||
|
||||
### web 端 API 缺口 (来源: source-analysis.md)
|
||||
- 已镜像 (95 函数): visualDev / dataModel / dataSource / menu / dict / workflow
|
||||
- 未镜像: report / portal / bigscreen / di / schedule / msg / log / monitor / print / 等等
|
||||
|
||||
---
|
||||
|
||||
## 3. 4 阶段执行 Plan
|
||||
|
||||
### Phase 1: 命令逐个过 + 子代理并行 (重点)
|
||||
|
||||
**目标**: 对每个 dacli 父命令, 分析 web 页面逻辑, 决定改/删/留, 用 webapi 镜像或保留 c.get/postJson.
|
||||
|
||||
**子代理 dispatch 策略** (用 superpowers:dispatching-parallel-agents):
|
||||
|
||||
每个父命令派 1 个子代理 (Explore 类型), 让它:
|
||||
1. 读 dacli/src/commands/{cmd}/ 全部 .ts
|
||||
2. 读对应 web/views/{对应页面} 全部 .vue
|
||||
3. 读 web/api/{对应 api}.ts
|
||||
4. 输出**建议**:
|
||||
- [KEEP] - 命令有价值, 保留
|
||||
- [REFACTOR-WEBAPI] - 改用 webapi 镜像
|
||||
- [DEPRECATE] - 已废弃, 删或 @deprecated
|
||||
- [NEW-CMD] - 缺新命令, 建议新增 (写 spec)
|
||||
- [WEB-PATCH-NEEDED] - 需要改 web 源码 (写 dacli/docs/web-patches/{comp}.md)
|
||||
5. 输出后写到 `dacli/docs/cmd-review/{cmd}.md`
|
||||
|
||||
**分批** (每批 5-6 命令, 派 5-6 子代理并行):
|
||||
- Batch A: apis, app, bigscreen, datasource, di
|
||||
- Batch B: dict, dm, doc, form, integration
|
||||
- Batch C: log, menu, monitor, msg, org
|
||||
- Batch D: portal, print, report, role, schedule
|
||||
- Batch E: storage, user, workflow
|
||||
|
||||
**验证**: 每个 cmd-review/{cmd}.md 包含建议后, 主代理做决定并执行.
|
||||
|
||||
### Phase 2: 命令改/删/留执行 (主代理)
|
||||
|
||||
**目标**: 基于 Phase 1 建议, 实际改命令.
|
||||
|
||||
**操作清单** (按频率/价值优先):
|
||||
- P0: webapi 镜像高频命令 (report list/portal list/bigscreen list/di list/schedule list)
|
||||
- P0: 新增 selector 类命令 (report selector / portal selector / workflow 已加 / dict typeSelector)
|
||||
- P1: 删除 deprecated 命令 (form/validate / form/fixcolumndata / form/_simplify.ts / form/_blindspots.ts 等已 @deprecated)
|
||||
- P1: form update / dm addFields / dm update / dictData CRUD
|
||||
- P2: 低频命令按需
|
||||
|
||||
**每个命令改完必须**:
|
||||
1. 跑 `npx tsc --noEmit` 验证
|
||||
2. 跑实际命令 (如果非破坏性) 或写测试
|
||||
3. commit + push
|
||||
|
||||
### Phase 3: .claude/** 全过同步
|
||||
|
||||
**目标**: 24 个 skill + 父 CLAUDE.md 全部一致, 提示信息反映新架构.
|
||||
|
||||
**子代理 dispatch** (每个 skill 1 个子代理):
|
||||
- 让子代理:
|
||||
1. 读 skill 当前内容
|
||||
2. 检查是否引用了旧 API/旧命令/旧模式
|
||||
3. 如有, 按新架构更新
|
||||
4. 输出建议
|
||||
|
||||
**主代理执行**: 实际改 skill, 重点:
|
||||
- design-jnpf-execute (主流程 skill, 必改)
|
||||
- ssw-h5dev-flow (H5 开发流程, 必改)
|
||||
- ssw-test, no-spa-page (涉及 dacli 命令)
|
||||
- 其他 skill 按需 (很多可能不直接涉及 dacli)
|
||||
|
||||
### Phase 4: 历史残留清理
|
||||
|
||||
**目标**: 删旧 B**/盲点/已删命令引用, 避免干扰 AI.
|
||||
|
||||
**清理清单**:
|
||||
- `_blindspots.ts` `_blindspot_guards.ts` `_precheck.ts` 是否还引用已删命令
|
||||
- `@deprecated` 标记文件最终是否删 (form/_simplify.ts 等)
|
||||
- 引用 extract-all.mjs / extract-web-schema.py / field-schemas.json 等已删资源
|
||||
- 引用 22 条盲点 (BS-1 ~ BS-60b) 是否仍有意义 (webapi 镜像后 BS-51/52/54 已无效)
|
||||
- 引用 dacli 自有 schema (FieldBuilder.ts) 是否仍存在
|
||||
- 引用 v0.10/v0.11 之前的设计 (polish-changes-v*.md 等历史归档)
|
||||
|
||||
**删除 vs 标记**:
|
||||
- 完全无效 → 删文件
|
||||
- 还有参考价值 → 移到 dacli/docs/history/ 归档
|
||||
|
||||
### Phase 5: 官方示例验证
|
||||
|
||||
**目标**: 所有改动用 workSystem / developSystem 跑通.
|
||||
|
||||
**验证脚本**:
|
||||
```bash
|
||||
SKIP_PLAYWRIGHT=1 bash dacli/.claude/skills/dacli-ts/examples/baseline/all.sh
|
||||
npx vitest run
|
||||
npx tsx tests/test-webapi-*.ts # 全部 webapi 测试
|
||||
```
|
||||
|
||||
### Phase 6: web 端改动 (谨慎, 按需)
|
||||
|
||||
**目标**: 仅在 webapi 镜像 + AI 工作流命令都搞不定时才改.
|
||||
|
||||
**触发条件** (满足任一):
|
||||
- AI 用 selector 找不到 form/report
|
||||
- AI 创建菜单/webapi 调用 web 端逻辑漏关键字段 (BS-51/52/54 类)
|
||||
- web 端页面逻辑本身有 bug
|
||||
|
||||
**改前必做**:
|
||||
1. 在 `dacli/docs/web-patches/{component}.md` 写"待改清单"
|
||||
2. 改 web 源码
|
||||
3. 完善该文档 (diff/原因/验收/重应用)
|
||||
4. commit + push
|
||||
|
||||
---
|
||||
|
||||
## 4. 子代理 dispatch 协议
|
||||
|
||||
**使用 superpowers:dispatching-parallel-agents skill** (用户要求 7).
|
||||
|
||||
**每个子代理 prompt 模板**:
|
||||
```
|
||||
你是 dacli 命令审计子代理.
|
||||
|
||||
任务: 分析 dacli {CMD} 命令, 输出改/删/留建议.
|
||||
|
||||
输入:
|
||||
- dacli 源码: /home/ubuntu/ccWorkDir/dacli/src/commands/{CMD}/*.ts
|
||||
- 对应 web 页面: 找 web/views/{对应路径}/*.vue
|
||||
- 对应 web API: 找 web/api/{对应路径}.ts
|
||||
|
||||
输出: /home/ubuntu/ccWorkDir/dacli/docs/cmd-review/{CMD}.md
|
||||
内容:
|
||||
1. 命令清单 (现有子命令 + 各自功能)
|
||||
2. web 页面操作逻辑摘要
|
||||
3. 改/删/留 建议 (每条理由)
|
||||
4. 如需新增命令, 写 spec (签名 + 用法)
|
||||
5. 如需改 web 源码, 写 web-patches/{file}.md 草稿
|
||||
```
|
||||
|
||||
**调度策略**:
|
||||
- 每批 5-6 个 Explore 子代理并行
|
||||
- 子代理只输出建议, 不直接改代码
|
||||
- 主代理汇总, 决策, 执行
|
||||
|
||||
---
|
||||
|
||||
## 5. 联动 skill 调整 (用户要求 10)
|
||||
|
||||
### ssw-h5dev-flow (H5 开发主流程)
|
||||
- 现在可能引用旧的 form create --fields 流程
|
||||
- 改用 webapi + _buildformdata.ts 路径
|
||||
- 加 form/workflow selector 提示
|
||||
|
||||
### ssw-test
|
||||
- 测试可能用旧 dacli 命令调用方式
|
||||
- 同步 webapi 模式
|
||||
|
||||
### no-spa-page
|
||||
- 独立 HTML 页面开发, 可能不直接涉及 dacli
|
||||
- 检查是否有 dacli 命令引用
|
||||
|
||||
### design-jnpf-execute
|
||||
- 主流程 skill, 必改
|
||||
- 加 v0.11+ 镜像架构段
|
||||
- 删除 extract 脚本引用
|
||||
|
||||
---
|
||||
|
||||
## 6. 完成标准
|
||||
|
||||
### Phase 1 完成
|
||||
- [ ] 23 个命令 cmd-review/{cmd}.md 全部生成
|
||||
|
||||
### Phase 2 完成
|
||||
- [ ] 所有 [REFACTOR-WEBAPI] / [NEW-CMD] 已执行
|
||||
- [ ] npx tsc --noEmit 干净
|
||||
- [ ] 所有 [DEPRECATE] 命令已删或保留 (说明理由)
|
||||
|
||||
### Phase 3 完成
|
||||
- [ ] 24 个 skill 已检查, 引用的已更新
|
||||
- [ ] 父 CLAUDE.md 已更新
|
||||
|
||||
### Phase 4 完成
|
||||
- [ ] 历史残留清理, 文件已删/归档
|
||||
|
||||
### Phase 5 完成
|
||||
- [ ] baseline 跑通 (workSystem + developSystem)
|
||||
- [ ] vitest 跑通
|
||||
- [ ] webapi 全部测试 PASS
|
||||
|
||||
### Phase 6 完成 (按需)
|
||||
- [ ] web 改动存 docs/web-patches/
|
||||
|
||||
---
|
||||
|
||||
## 7. 关键文件位置 (恢复上下文用)
|
||||
|
||||
### dacli 仓库
|
||||
- 命令源码: `dacli/src/commands/{cmd}/*.ts`
|
||||
- webapi 镜像: `dacli/src/webapi/*.ts`
|
||||
- 测试: `dacli/tests/test-webapi-*.ts`
|
||||
- docs (新增): `dacli/docs/source-analysis.md` `dacli/docs/web-patches/` `dacli/docs/cmd-review/`
|
||||
- .claude (dacli): `dacli/.claude/skills/dacli-ts/SKILL.md`
|
||||
|
||||
### 父项目
|
||||
- 父 CLAUDE.md: `.claude/CLAUDE.md` (v0.10+ 防御体系 + webapi 架构段已更新)
|
||||
- 父 .claude/skills: `.claude/skills/{skill-name}/SKILL.md` (24 个)
|
||||
|
||||
### web 端 (只读, 改时谨慎)
|
||||
- 页面逻辑: `web/apps/jnpf-web-apps-main/src/views/**/*.vue`
|
||||
- API 端点: `web/apps/jnpf-web-apps-main/src/api/**/*.ts`
|
||||
- 工具函数: `web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/`
|
||||
- ssw 可改: `web/apps/jnpf-web-apps-main/src/views/ssw/**` (改动存 docs/web-patches/)
|
||||
|
||||
---
|
||||
|
||||
## 8. 注意事项
|
||||
|
||||
1. **不要重新写已有 webapi 模块** - visualDev/dataModel/dataSource/menu/dict/workflow 6 个已 stable
|
||||
2. **不要删除 webapi/_loader.ts / _defhttp_shim.ts** - 是基础设施
|
||||
3. **不要直接改 web/.../views/onlineDev/* / components/FormGenerator/* (除非授权)** - 改时存 docs/web-patches/
|
||||
4. **web/views/ssw/** 可改** - 改动必须存 docs/web-patches/
|
||||
5. **每个 commit 必跑 vitest + baseline** - 避免回归
|
||||
6. **MEMORY 必更新** - 每个阶段完成写 1 条 memory
|
||||
7. **git hooks 已注册** - commit 后 auto-push
|
||||
|
||||
---
|
||||
|
||||
## 9. 应急回滚
|
||||
|
||||
每个 phase 完成后 commit, 回滚 = `git revert <commit>`:
|
||||
```bash
|
||||
git revert 727b13c..HEAD # 回滚所有 v0.11+ commit
|
||||
git push origin feat/dacli-user-commands-v18 --force-with-lease
|
||||
```
|
||||
|
||||
最坏情况: checkout `a024271` (web-patches 建立时) 恢复.
|
||||
|
||||
---
|
||||
|
||||
## 10. 立即开始指令 (给下一轮 AI)
|
||||
|
||||
```
|
||||
# 读这个 plan 文件
|
||||
cat /home/ubuntu/ccWorkDir/dacli/docs/v0.11-next-steps-plan.md
|
||||
|
||||
# 加载相关 skill
|
||||
- superpowers:dispatching-parallel-agents
|
||||
- superpowers:subagent-driven-development
|
||||
- superpowers:executing-plans
|
||||
- superpowers:writing-plans
|
||||
|
||||
# 开始 Phase 1: 派 5-6 个 Explore 子代理审计第 1 批命令 (apis/app/bigscreen/datasource/di)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**作者**: 2026-06-25 上一轮 (上下文爆了前)
|
||||
**状态**: v0.11+ Phase 1+2+4 完成, Phase 3 (webapi AI 工作流) 完成, 此 plan 是后续 Phase 4-8
|
||||
**下一步**: Phase 1 派子代理审计 23 个命令
|
||||
Reference in new issue
Block a user