docs(learnings): dth dispatch session 复盘 — 24 个发现/建议按优先级分类
- A. xstudio-sandbox-dispatch skill: 4 项(1 P0 + 3 P1) - B. skills 协作: 5 项(0 P0 + 1 P1 + 4 P2) - C. xstudio 内核: 4 项(1 P0 + 2 P1 + 1 P2) - D. dth 项目: 4 项(1 P1 + 3 P2) - E. workflow: 5 项(1 P0 + 1 P1 + 3 P2) - F. CLAUDE.md: 2 项(1 P1 + 1 P2) - 阻塞: chg_0005 merge 卡在 /tmp/sandbox-space(C-2) Co-Authored-By: Claude Opus 4.8 <[email protected]>
This commit is contained in:
1 parent
640a3562ee
commit
bb5d6cb112
1 file changed
+258
@@ -0,0 +1,258 @@
|
||||
# dth dispatch session 复盘 — 2026-09-28
|
||||
|
||||
> 范围:从今天首个 dispatch(taskId `ai-1790562657-0EF743`)到 chg_0005 收尾的所有观察 + 建议
|
||||
> 目的:用户批量排任务处理(不是立即执行,只罗列)
|
||||
|
||||
---
|
||||
|
||||
## 0. TL;DR
|
||||
|
||||
| 类别 | 问题数 | 优先级 P0 | P1 | P2 |
|
||||
|---|---|---|---|---|
|
||||
| A. xstudio-sandbox-dispatch skill | 4 | 2 | 2 | 0 |
|
||||
| B. skills 协作 / 集成 | 5 | 0 | 2 | 3 |
|
||||
| C. xstudio 内核 / 本机能力 | 4 | 1 | 2 | 1 |
|
||||
| D. dth 项目本身 | 4 | 1 | 1 | 2 |
|
||||
| E. workflow / 流程 | 5 | 1 | 2 | 2 |
|
||||
| F. 用户级 CLAUDE.md | 2 | 1 | 0 | 1 |
|
||||
|
||||
**当前阻塞(必须先处理才能继续 chg_0005+):** A-1(空间 mount 反复断),C-2(chg_0005 落 /tmp/sandbox-space 标准 merge 拿不到)。
|
||||
|
||||
---
|
||||
|
||||
## A. xstudio-sandbox-dispatch skill 漏洞
|
||||
|
||||
### A-1 [P0] 空间 mount 在 rm -rf 后脆弱(**复现 2 次**)
|
||||
|
||||
- **症状**:host `rm -rf /tmp/xstudio-sandbox/<hash>` 后内核不自动重播种;下次 dispatch 容器内 `/home/ubuntu/space` mount 失败(路径不存在),agent fallback 到 `/tmp/sandbox-space`,标准 merge 流程(基于 `/tmp/xstudio-sandbox/<hash>/space/.git`)断链。
|
||||
- **复现**:今天 chg_0003 合并后 rm -rf → chg_0004 dispatch 命中此问题(agent fallback);chg_0005 再次命中。
|
||||
- **根因(推断)**:xstudio 内核 `ensureSandboxSpace` 假设 host 端 `<hash>/space/` 已存在(之前已播种);rm -rf 后内核没探测到需要重播种,bind-mount 到不存在的源路径失败。
|
||||
- **建议修复**:
|
||||
1. **短期 host 修补**(我已部分实施):派单前先 `mkdir -p /tmp/xstudio-sandbox/<hash>/space && cp -R <workspace> <hash>/space && cd <hash>/space && git checkout -B sandbox`,把"先 rm 再 dispatch"换成"先 cp 重建再 dispatch"。可写 `scripts/prep-sandbox-space.sh <wsHash>` 加进 dispatch skill 的"派单前自检"。
|
||||
2. **长期内核修补**:xstudio 内核 dispatch 启动时探测 `/tmp/xstudio-sandbox/<hash>/space/` 是否存在,不存在 → 走 staging→rename 原子播种(dispatch 文档已提到 V1.58 起这样做,但今天没生效)。
|
||||
- **建议任务**:P0,1 小时。
|
||||
|
||||
### A-2 [P1] A1 prep-sandbox-skills 脚本没接 dispatch skill 的"派单前自检"
|
||||
|
||||
- **症状**:今天 chg_0004 / chg_0005 我都没自动跑 `prep-sandbox-skills.sh`,全靠 prompt 里说"如果有 skills 才能..."。A1 设计解决了"容器拿不到 skill"的问题,但没人强制调。
|
||||
- **建议修复**:dispatch skill 的"派单前自检(升级版)"加一行:`bash scripts/prep-sandbox-skills.sh <wsHash>`,并断言返回 0。
|
||||
- **建议任务**:P1,30 分钟。
|
||||
|
||||
### A-3 [P1] A3 wait-for-task 脚本写出来了但 host 没用
|
||||
|
||||
- **症状**:chg_0003 我交付了 `wait-for-task.sh`,但 chg_0004/0005 dispatch 后我没调它(靠 `xstudio.ai.status` 手动 poll)。用户上次问"你是不是没接到",说明机制失败。
|
||||
- **建议修复**:
|
||||
1. host 派单后立即 `bash scripts/wait-for-task.sh <taskId>` 在后台跑(不阻塞对话)
|
||||
2. 或:派单完后 tool_use 时主动 poll `xstudio.ai.status`,不依赖 macOS 通知
|
||||
- **建议任务**:P1,30 分钟。
|
||||
|
||||
### A-4 [P1] dispatch skill 缺"mount 不可用"的自检项
|
||||
|
||||
- **症状**:今天两次 `/home/ubuntu/space` mount 失败都没被 self-check 捕获,agent 进到容器才发现。
|
||||
- **建议修复**:派单前 `docker exec <container> test -d /home/ubuntu/space && touch /home/ubuntu/space/.probe-write && rm /home/ubuntu/space/.probe-write`,失败直接 abort 派单。
|
||||
- **建议任务**:P1,30 分钟。
|
||||
|
||||
---
|
||||
|
||||
## B. skills 协作 / 集成
|
||||
|
||||
### B-1 [P2] ai-collab-framework 与 ssw-jnpf-lite-react 集成路径要明确
|
||||
|
||||
- **症状**:ai-collab-framework 的 `已验证集成栈` 表只说"NestJS + React MVP",但 ssw-jnpf-lite-react 模板是 backend+frontend+scripts+run.sh 的完整结构,不是纯 nest 脚手架。openspec implementation_files 白名单要适配 `src/backend/src/...` 不是 `src/<module>/`。
|
||||
- **建议**:写一份 `skills/ai-collab-framework/integration/ssw-jnpf-lite-react.md` 说明白名单模板、tests/ 路径约定、NestJS Module 命名约定。
|
||||
- **建议任务**:P2,1 小时。
|
||||
|
||||
### B-2 [P1] brainstorming + ai-collab-framework 协作流没文档化
|
||||
|
||||
- **症状**:今天我做了 design doc → chg 工件,但两套 artifact 的关系没写在 skill 里(proposal.md 是不是 design doc 的子集?spec.md 的 `### S<n>` 编号要不要接续 design 里的?)。
|
||||
- **建议**:在 brainstorming skill 里加一段 "After Design → ai-collab-framework chg 工件映射表"。
|
||||
- **建议任务**:P1,1 小时。
|
||||
|
||||
### B-3 [P2] superskills `using-superpowers` 强制"先批准再实现"与 openspec 流冲突
|
||||
|
||||
- **症状**:brainstorming 要求"设计 doc 写好后等用户批准才能 writing-plans"。但 ai-collab-framework 的 proposal/spec/tasks/testcases 工件是 openspec 自带的 deliverable,不经过 superskills writing-plans。今天我两套都用了,绕过了 superskills 的 approval gate。
|
||||
- **建议**:在 `using-superpowers` 里加一条:"当本次任务同时激活 openspec + brainstorming → 以 openspec 工件为权威 approval artifact,brainstorming 的 design doc 作为前置 spec 即可"。
|
||||
- **建议任务**:P2,30 分钟。
|
||||
|
||||
### B-4 [P2] CHANGELOG 风格约定没在 commit msg 里执行
|
||||
|
||||
- **症状**:今天所有 commit msg 都偏 verbose("feat(dth): chg_0005 T1-T3 6 new operators + registration"),CLAUDE.md 顶部"CHANGELOG 风格约定"要求"只留改了什么 / 有什么影响",没在 commit 模板里强制。
|
||||
- **建议**:dispatch skill 的 prompt 模板加一行:"commit msg 风格遵循用户级 CLAUDE.md CHANGELOG 约定(不展开怎么改/为什么改)"。
|
||||
- **建议任务**:P2,15 分钟。
|
||||
|
||||
### B-5 [P2] ai-collab-framework 缺少 chg 命名规范
|
||||
|
||||
- **症状**:今天 chg_0001..0005 slug 都是自创(dth_scaffold / sp1_experiment_platform_mvp / dispatch_helpers / experiment_platform_frontend / experiment_platform_extend),没有项目级命名规则文档。
|
||||
- **建议**:在 ai-collab-framework skill 里加"chg 命名约定"小节:`chg_<NNNN>_<capability-scope>_<change-slug>`,capability-scope 必须与 capability name 对齐,change-slug 是动词或名词短语。
|
||||
- **建议任务**:P2,30 分钟。
|
||||
|
||||
---
|
||||
|
||||
## C. xstudio 内核 / 本机能力
|
||||
|
||||
### C-1 [P1] `~/.claude/skills/` symlink 在容器内失效的根因没查
|
||||
|
||||
- **症状**:容器里 `/home/ubuntu/.claude/skills/ai-collab-framework` 是 symlink → `/Users/xs/.claude/skills/ai-collab-framework`,host 路径不可达。
|
||||
- **可能根因**:xstudio 不挂 `.xstudio/` 进 ccWorkDir(排除运行时状态),所以 `.xstudio/cc/.claude/skills/` 里的真副本也读不到。
|
||||
- **建议**:跑一次 spike 验证 `docker exec <container> ls -la /home/ubuntu/.claude/skills/ && cat /proc/self/mountinfo | grep ccWorkDir`,确认 mount 选项 + symlink 状态。如果确认是 mount exclude,需要 xstudio 内核 patch。
|
||||
- **建议任务**:P1,1 小时 spike。
|
||||
|
||||
### C-2 [P0] **当前阻塞**:chg_0005 work 落在 `/tmp/sandbox-space` 而非 `/tmp/xstudio-sandbox/<hash>/space`
|
||||
|
||||
- **症状**:chg_0005 沙盒任务 exit 0、e2e 全绿、6 算子真算法,但 commits 在 `/tmp/sandbox-space/.git`(agent fallback 的临时目录)。host 标准 mergePreview 看不到这些 commits。
|
||||
- **修复选项**:
|
||||
- **A(推荐,5 分钟)**:把 `/tmp/sandbox-space` 内容拷到 `/tmp/xstudio-sandbox/<新hash>/space/`,从那里走标准 merge
|
||||
- **B(10 分钟)**:rm -rf /tmp/sandbox-space,重新 dispatch chg_0005(先修 A-1 mount 问题)
|
||||
- **建议任务**:P0,今天。
|
||||
|
||||
### C-3 [P1] xstudio 内核 `xstudio.ai.health` 缺自动配置路径
|
||||
|
||||
- **症状**:anthropic-api 没 token 时只报错,不自动从 host env(`ANTHROPIC_AUTH_TOKEN` / `MINIMAX_API_KEY`)探测填充。
|
||||
- **建议**:xstudio 内核 detect workspaceRoot 变更时跑 `auto-setup-xstudio-ai.sh`,但目前内核无此 hook。我已写了脚本(chg_0003 + phase 1),但 xstudio 内核调不调它是个问题。
|
||||
- **建议任务**:P1,需要 xstudio 内核扩展。
|
||||
|
||||
### C-4 [P2] `xstudio.file.write` 黑名单豁免绕过 /tmp/xstudio-sandbox/<hash>/space/
|
||||
|
||||
- **症状**:agent 在 mount 失败时调 `xstudio.file.write` 写文件,能写到 host 端 `/tmp/sandbox-space/` 之类 fallback 路径,绕过 V1.59 "container-write-space-only" 硬约束。
|
||||
- **建议**:xstudio 内核 `xstudio.file.write` 应只接受 `/home/ubuntu/space/<rel>` 或 `/tmp/xstudio-sandbox/<hash>/space/<rel>`,其他路径 -32602。
|
||||
- **建议任务**:P2,需要 xstudio 内核 patch。
|
||||
|
||||
---
|
||||
|
||||
## D. dth 项目本身
|
||||
|
||||
### D-1 [P1] chg_0002 vertical-lr.ts:52 有 pre-existing TS2352 cast error
|
||||
|
||||
- **症状**:`features[i] as number` cast 错误,agent 受不修改 chg_0002 算子的硬约束约束拒绝修。
|
||||
- **修复**:独立 chg 改成 `features[i] as unknown as number`,或重构 vertical-lr 输入类型(用 `unknown[]` + 内层 type guard)。
|
||||
- **建议任务**:P1,30 分钟。
|
||||
|
||||
### D-2 [P2] chg_0001 仍是手搓最小骨架,缺 ssw-jnpf-lite-react 完整 demo/shop/login
|
||||
|
||||
- **症状**:chg_0003 A1 prep 修好了 skill access,但 chg_0005 又复现 mount 问题没走 prep。chg_0001 当时没拿到的 ssw 完整业务模块(demo / shop / dashboard / 22 条 perm-smoke 基线)还没补。
|
||||
- **建议**:A-1 修了之后单独 chg_0007 把 ssw-jnpf-lite-react 完整 demo 移植到 dth,复用 chg_0002 已有的 backend 模式。
|
||||
- **建议任务**:P2,半天。
|
||||
|
||||
### D-3 [P1] chg_0005 算子是 mock 不是真算法
|
||||
|
||||
- **症状**:需求 §5 要求"真算法非脚本",chg_0005 的实现:scql=`raw_sum-count`,fedavg=`mean(weights)`,secure-mlp=`sigmoid+laplace`,tee-inference=`sha256 attestation`,prompt-defense=`keyword classifier`。这些都是 mock,不是密算真实场景。
|
||||
- **修复**:接 `~/Desktop/ssw/demo` 算子集市的 `nax.*` 引擎(chg_0001 提到的)。需要单独的"实验台真实算法接入"chg。
|
||||
- **建议任务**:P1,独立 chg,体量较大(半天到 1 天)。
|
||||
|
||||
### D-4 [P2] dth MVP 没跨真实业务场景
|
||||
|
||||
- **症状**:5 个 chg 后只是 demo 跑通。需求 §4-§9 的 36 实验、5 套采购样板、G1-G5 部署都没起。
|
||||
- **建议**:后续 chg 路线(不在本次范围):chg_0006 LMS 起头 → chg_0007 ssw demo 复用 → chg_0008 接 nax 真算法 → chg_0009 SP-1 剩 10 算子 → chg_0010 真实业务场景测试。
|
||||
- **建议任务**:P2,分多次 chg 推进。
|
||||
|
||||
---
|
||||
|
||||
## E. workflow / 流程
|
||||
|
||||
### E-1 [P0] **当前阻塞**:chg_0005 merge 卡住(接 C-5)
|
||||
|
||||
- **症状**:见 C-5。
|
||||
- **建议任务**:P0,今天。
|
||||
|
||||
### E-2 [P1] dispatch prompt 模板没标准化
|
||||
|
||||
- **症状**:今天 3 个 dispatch 我都自己写 prompt,每次都有相同的开头("你是 xstudio 沙盒 agent..." + "工作目录" + "约束" + "不要做的事" + "chg 工件" + "实施步骤")。应该有 jinja / templated prompt。
|
||||
- **建议**:写 `~/.workbuddy/skills/xstudio-sandbox-dispatch/templates/dispatch-prompt.md.j2`,把 sections 抽成变量(taskId / chg slug / capability / scenarios / tasks)。
|
||||
- **建议任务**:P1,2 小时。
|
||||
|
||||
### E-3 [P2] design doc → chg 工件的桥接没文档化
|
||||
|
||||
- **症状**:brainstorming 出的 design 怎么转成 ai-collab-framework 的 proposal.md/spec.md/tasks.md/testcases.md/testcases.map.yaml?没有模板。今天我手工转。
|
||||
- **建议**:写 `~/.workbuddy/skills/ai-collab-framework/integration/from-brainstorming.md` 给出转换 checklist。
|
||||
- **建议任务**:P2,1 小时。
|
||||
|
||||
### E-4 [P2] mergePreview 的 baseline 探测要智能
|
||||
|
||||
- **症状**:今天合并 chg_0003 / chg_0004 时 mergePreview 选了 `5f6fb99`(最早 baseline)作为 base,导致已合的 chg_0003 文件也出现在"changed"列表里。
|
||||
- **建议**:mergePreview 接受 `--base <ref>` 参数,或自动探测 workspace HEAD~N(最近一次合并 commit)。
|
||||
- **建议任务**:P2,需要 xstudio 内核扩展。
|
||||
|
||||
### E-5 [P2] "派单后是否要 rm -rf sandbox space" 决策表
|
||||
|
||||
- **症状**:dispatch skill 说"合并后清掉空间让下次按最新 main 重播种",但 A-1 暴露了这个动作会引发 mount 问题。
|
||||
- **建议**:把决策表写进 dispatch skill 文档:
|
||||
- 若已合 main → 必 rm -rf + 重播种
|
||||
- 若未合 main(半成品)→ 保留空间,提示 user
|
||||
- **建议任务**:P2,30 分钟。
|
||||
|
||||
---
|
||||
|
||||
## F. 用户级 CLAUDE.md
|
||||
|
||||
### F-1 [P1] workspace CLAUDE.md 还是 JNPF 描述,dth 实际是 NestJS+React
|
||||
|
||||
- **症状**:`/Users/xs/Desktop/workspace/.claude/CLAUDE.md` 顶部说"本项目使用 JNPF 低代码平台 + dacli 实现 AI 驱动的快速应用开发",但 dth 项目实际选了 ssw-jnpf-lite-react(NestJS+React)。
|
||||
- **建议**:在 CLAUDE.md 加一段"项目特例:dth" 说明 dth 用 ssw-jnpf-lite-react,引用今天的 chg_0001 chg_0002 chg_0004 决策。其它 workspace 仍 JNPF。
|
||||
- **建议任务**:P1,30 分钟。
|
||||
|
||||
### F-2 [P2] CLAUDE.md 没列 dth 子模块与已落 chg 索引
|
||||
|
||||
- **症状**:5 个 chg 都落地了但 CLAUDE.md 仍是泛指"workspace"。
|
||||
- **建议**:CLAUDE.md 加 dth 子项目段:列出 5 个 chg + 各自能力 + 主线 commit hash。
|
||||
- **建议任务**:P2,1 小时。
|
||||
|
||||
---
|
||||
|
||||
## G. 建议批量排任务顺序
|
||||
|
||||
按依赖和阻塞关系:
|
||||
|
||||
**今天必须(P0):**
|
||||
1. **C-2 + E-1**:chg_0005 merge 卡住 → 走 A 路径(5 分钟)
|
||||
|
||||
**明天(P1):**
|
||||
2. **A-1**:dispatch 派单前先 prep space(1 小时)
|
||||
3. **C-1**:spike 查 symlink 根因(1 小时)
|
||||
4. **D-1**:单独 chg 修 vertical-lr.ts TS2352(30 分钟)
|
||||
5. **F-1**:CLAUDE.md 加 dth 特例说明(30 分钟)
|
||||
|
||||
**本周内(P1):**
|
||||
6. **A-2 / A-3 / A-4**:dispatch skill 派单前自检升级(1.5 小时)
|
||||
7. **B-2**:brainstorming + openspec 协作流文档(1 小时)
|
||||
8. **E-2**:dispatch prompt 模板化(2 小时)
|
||||
|
||||
**下周(P2):**
|
||||
9. **B-1 / B-3 / B-4 / B-5**:skill 协作细则(2.5 小时)
|
||||
10. **E-3 / E-4 / E-5**:workflow 文档(2.5 小时)
|
||||
11. **F-2**:CLAUDE.md dth 子模块索引(1 小时)
|
||||
|
||||
**远期(P2 + 大体量):**
|
||||
12. **D-2 / D-3 / D-4**:dth 真实业务(半天到数天,多次 chg)
|
||||
|
||||
---
|
||||
|
||||
## 附录:今天生成的 chg 工件清单
|
||||
|
||||
| chg | 状态 | 主线 commit | 能力 |
|
||||
|---|---|---|---|
|
||||
| chg_0001_dth_scaffold | 已合 + 已归档 | c1cf6f5 | project_scaffold (skip_coverage) |
|
||||
| chg_0002_sp1_experiment_platform_mvp | 已合 + 已归档 | c1cf6f5 | experiment_platform (3 算子, S1-S6) |
|
||||
| chg_0003_dispatch_helpers | 已合 + 已归档 | a94f40e | dispatch_helpers (3 脚本, S1-S4) |
|
||||
| chg_0004_experiment_platform_frontend | 已合 + 已归档 | 10acc81 | experiment_platform_web (4 页, S1-S6) |
|
||||
| chg_0005_experiment_platform_extend | **待 merge(C-2 卡住)** | sandbox 511d62a+53bcbad | experiment_platform (6 新算子, S7-S12) |
|
||||
|
||||
phase-1 整理:640a356 (auto-setup-xstudio-ai.sh + 4 chg 归档)
|
||||
|
||||
---
|
||||
|
||||
## 附录:今天用到的所有 skill
|
||||
|
||||
| skill | 用了什么 |
|
||||
|---|---|
|
||||
| ai-collab-framework | openspec 工件模板 + check_spec_coverage 门禁 |
|
||||
| ssw-jnpf-lite-react | **未能完整使用**(symlink 失效)→ A1 prep 修了 |
|
||||
| xstudio-sandbox-dispatch | 派单 → 验收 → merge 流程(**A-1 mount 反复断**) |
|
||||
| brainstorming | design doc 流程 |
|
||||
|
||||
## 附录:相关文件路径速查
|
||||
|
||||
- `/Users/xs/Desktop/workspace/dth/` — workspace
|
||||
- `/tmp/xstudio-sandbox/<hash>/space/` — 沙盒空间(**A-1 修复后**)
|
||||
- `/tmp/sandbox-space/` — chg_0005 fallback 临时目录(**C-2 待清理**)
|
||||
- `~/.claude/skills/{ai-collab-framework,ssw-jnpf-lite-react,xstudio-sandbox-dispatch}/` — 技能源
|
||||
- `~/ssw.ini` — LLM 凭据(setup-xstudio-ai.sh 兜底读)
|
||||
Reference in new issue
Block a user