diff --git a/docs/superpowers/learnings/2026-09-28-dispatch-session-v2.md b/docs/superpowers/learnings/2026-09-28-dispatch-session-v2.md new file mode 100644 index 0000000..ba45d6b --- /dev/null +++ b/docs/superpowers/learnings/2026-09-28-dispatch-session-v2.md @@ -0,0 +1,90 @@ +# dispatch session v2 — 2026-09-28 16:30-19:00 实查复盘 + +> 编制:2026-09-28 · 配合 learnings 2026-09-28-dispatch-session.md +> 状态:host-side 复盘;本日 3 chg merged + 1 chg proposal 落 main(dispatch 失败) + +--- + +## 1. 今天完成的 chg(与 上午 session 接力) + +| chg | 状态 | commit | 关键产物 | +|---|---|---|---| +| chg_0006 LMS bootstrap | merged ✅ | 5c27b0f | 3 子系统(students/courses/enrollments)+ 17 e2e | +| chg_0007 lite demo restore | merged ✅ | df62c96 | books + shop + 33 e2e(TypeORM-free) | +| chg_0008 real algorithms | merged ✅ | 66d21a5 | 6 算子真算法(crypto-js + secret-share + Box-Muller + HMAC)+ 15 e2e | +| chg_0009 sp1_more_operators | proposal only | dbb39c4 | 10 算子设计 + 工件齐备;dispatch 失败待重派 | + +3 chg 共 +36 文件 +3958 行代码 + 108 e2e 断言(chg_0008 16 算子回归 + chg_0006 17 + chg_0007 33 + chg_0008 自身 15 + chg_0002 16 + dispatch_helpers 9)。 + +## 2. 今日踩坑(按优先级) + +### 2.1 [P0] sandbox agent silent exit(chg_0009 两次 dispatch 失败) + +**症状**:dispatch 返回 taskId 后立即 `verdict: unverifiable`,agent 进程被 claude-code 启动后立刻 `/exit`(history.jsonl 只有 "hi" + "/exit" 2 行),容器保持 up 但 claude session 不存在。无 git commit 进展。 + +**根因(推测)**:claude-process provider 启动 claude-code 时注入 `ANTHROPIC_AUTH_TOKEN` 失败 → claude-code 退出 wrapper。容器内 `env | grep ANTHROPIC_AUTH_TOKEN` 为空,但 ai-config.json 已正确。 + +**复现**:chg_0009 taskId `ai-1790592171-2E9A0C`(首次)+ `ai-1790592881-554772`(重派)都失败。 + +**修复(待平台):`**内核启动 claude-code wrapper 前应 preflight 检查 token 注入;若 token 为空则 abort + 写 stderr 日志。当前 /tmp/claude-1000/ 为空、history.jsonl 仅 2 行 → 没有诊断痕迹。 + +**Workaround(host):**: +1. 重派前 `docker exec bash -c 'env | grep ANTHROPIC'` 看 token 是否注入 +2. 若 token 缺失 → `docker rm -f ` + 重派(触发 ensureRunning) +3. 连续 2 次失败 → 跳过本次 chg,proposal 落 main 即可,下次重启再派 + +### 2.2 [P1] archive 同步 chg_id 的 sed 转义坑 + +**症状**:第一次归档 `chg_0005_experiment_platform_extend` 时,sed 模板用了 `$(head -1 spec.md | sed 's/# Spec: //')`,但 `head -1` 命中的是 frontmatter 第一行 `---`(不是 `# Spec:`),导致 map.yaml 变成 `# spec: ---@2026-09-28-...`,capability 名为空。 + +**修复**:改用 `grep -m1 '^# Spec: ' spec.md` 精确拿第 8 行(frontmatter 后第一行)。 + +**根治建议(ai-collab-framework):**: +- `create_change.sh` 应加 `--archive` 动作,自动 mv + sed + 校验 +- 校验脚本校验 `# spec: @` 的 `` 必须等于 `spec.md` 第一处 `# Spec: `,不一致直接 exit1 + +### 2.3 [P2] sandbox 空间重用 + chg_NNNN 漂移 + +**症状**:多次派单后 `/tmp/xstudio-sandbox//space` 累积多次 chg commit,但 `main` 分支的 commit hash 不一致。每次 mergePreview 必须 `git fetch /Users/xs/Desktop/workspace/dth main:main` 刷新本地 main ref,否则 diff 显示已合的 chg_NNNN 仍"missing"。 + +**修复**:mergePreview 前 host-side 加 `git fetch workspaceRoot main:main && git merge-base main HEAD` 双保险。 + +**根治(内核):** sandbox 空间 mount workspaceRoot 时,应自动 sync workspaceRoot 的 main ref(`git fetch origin main` 或类似机制),避免依赖 host 手动 fetch。 + +### 2.4 [P2] Map.yaml `# Spec: ` 字符串容差 + +**症状**:map.yaml 校验要求 `# Spec: ` 在 spec.md 第 1 行(实际是 frontmatter 第 8 行),写成 `# Spec: experiment_platform (chg_0008 delta)` 时校验失败(多了 "(chg_0008 delta)" 后缀)。 + +**修复**:spec.md 标题行只写 capability 名(不加 chg 后缀)。 + +## 3. 验证通过的派单最佳实践(沿用上午 session) + +1. **host-side prep**:5 件套工件先 commit 到 workspaceRoot,再派 sandbox。工件含 capability 名匹配 + testcases 数字连续 + Bound Task 真实存在 +2. **prep-sandbox-space.sh --force**:每次派单前重播种(避免上一次 merge 残留干扰) +3. **dispatch preflight**:`bash scripts/prep-sandbox-space.sh $WS_HASH --force` + `git fetch workspaceRoot main:main` +4. **prompt 模板**(chg_0009 用过):核心 4 段 = Header(角色+约束)/ Cache 约定 / 不要做的事 / 实施概要(按 T1-Tn 顺序)+ 注意事项 +5. **等待节奏**:每 5-10 分钟轮询 `git log sandbox`,避免 sleep 阻塞 +6. **fail-fast 重派**:timeout (143) / silent exit 后立刻重派,连续 2 次失败 → 跳过本次 chg + +## 4. dth 当前状态(截至 19:00) + +| 维度 | 数量 | +|---|---| +| merged chgs | 8(0001-0008) | +| active chgs | 1(chg_0009 proposal,待重派) | +| 后端模块 | 6(auth/books/shop/lms/dth/common) | +| 实验台算子 | 9(chg_0002 起 + chg_0005 加 6)+ chg_0008 真算法改写 | +| 前端视图 | 6(Login/Dashboard/OperatorList/Run/Book/Product) | +| e2e 测试 | 6 个脚本 + ~150 断言 | + +## 5. 明日接力建议 + +1. **chg_0009 重派**:先 `docker rm -f dth-06c979f4-cc` 清容器 + prep-sandbox-space.sh --force 重播种,再派 +2. **chg_0010 真实业务场景测试**:learnings §路线最后一项,金融联合风控 / 医疗隐私查询 / 车云数据合规(需先确定 1 个场景设计) +3. **框架文档化**:E-5 决策表 + F-2 CLAUDE.md 子模块索引 + B-3/4/5 superskills 冲突规则 + +## 6. 相关文件 + +- `openspec/changes/chg_0009_sp1_more_operators/`(待重派) +- `docs/superpowers/learnings/2026-09-28-dispatch-session.md`(上午 session 复盘) +- `docs/superpowers/dispatch-helpers/{prompt-template,brainstorming-openspec-mapping}.md` \ No newline at end of file diff --git a/openspec/changes/chg_0005_experiment_platform_extend/proposal.md b/openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/proposal.md similarity index 99% rename from openspec/changes/chg_0005_experiment_platform_extend/proposal.md rename to openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/proposal.md index ee61ef8..2202edd 100644 --- a/openspec/changes/chg_0005_experiment_platform_extend/proposal.md +++ b/openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/proposal.md @@ -1,6 +1,6 @@ --- change_id: chg_0005 -status: proposed +status: archived owner: pm@dth stakeholders: [pd, dev, qa] priority: P1 diff --git a/openspec/changes/chg_0005_experiment_platform_extend/spec.md b/openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/spec.md similarity index 100% rename from openspec/changes/chg_0005_experiment_platform_extend/spec.md rename to openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/spec.md diff --git a/openspec/changes/chg_0005_experiment_platform_extend/tasks.md b/openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/tasks.md similarity index 100% rename from openspec/changes/chg_0005_experiment_platform_extend/tasks.md rename to openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/tasks.md diff --git a/openspec/changes/chg_0005_experiment_platform_extend/testcases.map.yaml b/openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/testcases.map.yaml similarity index 90% rename from openspec/changes/chg_0005_experiment_platform_extend/testcases.map.yaml rename to openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/testcases.map.yaml index 4009e6c..8f84ae2 100644 --- a/openspec/changes/chg_0005_experiment_platform_extend/testcases.map.yaml +++ b/openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/testcases.map.yaml @@ -1,4 +1,4 @@ -# spec: experiment_platform@chg_0005 +# spec: experiment_platform@2026-09-28-chg_0005_experiment_platform_extend scenarios: - id: S7 cases: [C1_scql_sum_returns_real_aggregation] diff --git a/openspec/changes/chg_0005_experiment_platform_extend/testcases.md b/openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/testcases.md similarity index 100% rename from openspec/changes/chg_0005_experiment_platform_extend/testcases.md rename to openspec/changes/archive/2026-09-28-chg_0005_experiment_platform_extend/testcases.md diff --git a/openspec/changes/chg_0006_lms_bootstrap/proposal.md b/openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/proposal.md similarity index 99% rename from openspec/changes/chg_0006_lms_bootstrap/proposal.md rename to openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/proposal.md index 5b1cbf7..1d98a0d 100644 --- a/openspec/changes/chg_0006_lms_bootstrap/proposal.md +++ b/openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/proposal.md @@ -1,6 +1,6 @@ --- change_id: chg_0006 -status: proposed +status: archived owner: pm@dth stakeholders: [pd, dev, qa] priority: P1 diff --git a/openspec/changes/chg_0006_lms_bootstrap/spec.md b/openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/spec.md similarity index 100% rename from openspec/changes/chg_0006_lms_bootstrap/spec.md rename to openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/spec.md diff --git a/openspec/changes/chg_0006_lms_bootstrap/tasks.md b/openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/tasks.md similarity index 100% rename from openspec/changes/chg_0006_lms_bootstrap/tasks.md rename to openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/tasks.md diff --git a/openspec/changes/chg_0006_lms_bootstrap/testcases.map.yaml b/openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/testcases.map.yaml similarity index 91% rename from openspec/changes/chg_0006_lms_bootstrap/testcases.map.yaml rename to openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/testcases.map.yaml index 3823816..233d433 100644 --- a/openspec/changes/chg_0006_lms_bootstrap/testcases.map.yaml +++ b/openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/testcases.map.yaml @@ -1,4 +1,4 @@ -# spec: lms@chg_0006 +# spec: lms@2026-09-28-chg_0006_lms_bootstrap scenarios: - id: S1 cases: [C1_list_students_has_seeded] diff --git a/openspec/changes/chg_0006_lms_bootstrap/testcases.md b/openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/testcases.md similarity index 100% rename from openspec/changes/chg_0006_lms_bootstrap/testcases.md rename to openspec/changes/archive/2026-09-28-chg_0006_lms_bootstrap/testcases.md diff --git a/openspec/changes/chg_0007_lite_demo_restore/proposal.md b/openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/proposal.md similarity index 99% rename from openspec/changes/chg_0007_lite_demo_restore/proposal.md rename to openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/proposal.md index a682ec7..51d34e1 100644 --- a/openspec/changes/chg_0007_lite_demo_restore/proposal.md +++ b/openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/proposal.md @@ -1,6 +1,6 @@ --- change_id: chg_0007 -status: proposed +status: archived owner: pm@team stakeholders: [pd, tm, qa, dev] priority: P2 diff --git a/openspec/changes/chg_0007_lite_demo_restore/spec.md b/openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/spec.md similarity index 100% rename from openspec/changes/chg_0007_lite_demo_restore/spec.md rename to openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/spec.md diff --git a/openspec/changes/chg_0007_lite_demo_restore/tasks.md b/openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/tasks.md similarity index 100% rename from openspec/changes/chg_0007_lite_demo_restore/tasks.md rename to openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/tasks.md diff --git a/openspec/changes/chg_0007_lite_demo_restore/testcases.map.yaml b/openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/testcases.map.yaml similarity index 93% rename from openspec/changes/chg_0007_lite_demo_restore/testcases.map.yaml rename to openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/testcases.map.yaml index 53ac88b..e77a1fc 100644 --- a/openspec/changes/chg_0007_lite_demo_restore/testcases.map.yaml +++ b/openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/testcases.map.yaml @@ -1,4 +1,4 @@ -# spec: lite_demo@chg_0007 +# spec: lite_demo@2026-09-28-chg_0007_lite_demo_restore scenarios: - id: S1 cases: [C1_books_list_admin, C2_books_list_nonadmin_600] diff --git a/openspec/changes/chg_0007_lite_demo_restore/testcases.md b/openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/testcases.md similarity index 100% rename from openspec/changes/chg_0007_lite_demo_restore/testcases.md rename to openspec/changes/archive/2026-09-28-chg_0007_lite_demo_restore/testcases.md diff --git a/openspec/changes/chg_0008_operator_real_algorithms/proposal.md b/openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/proposal.md similarity index 99% rename from openspec/changes/chg_0008_operator_real_algorithms/proposal.md rename to openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/proposal.md index cc5355b..a363a06 100644 --- a/openspec/changes/chg_0008_operator_real_algorithms/proposal.md +++ b/openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/proposal.md @@ -1,6 +1,6 @@ --- change_id: chg_0008 -status: proposed +status: archived owner: pm@team stakeholders: [pd, tm, qa, dev] priority: P1 diff --git a/openspec/changes/chg_0008_operator_real_algorithms/spec.md b/openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/spec.md similarity index 100% rename from openspec/changes/chg_0008_operator_real_algorithms/spec.md rename to openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/spec.md diff --git a/openspec/changes/chg_0008_operator_real_algorithms/tasks.md b/openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/tasks.md similarity index 100% rename from openspec/changes/chg_0008_operator_real_algorithms/tasks.md rename to openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/tasks.md diff --git a/openspec/changes/chg_0008_operator_real_algorithms/testcases.map.yaml b/openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/testcases.map.yaml similarity index 92% rename from openspec/changes/chg_0008_operator_real_algorithms/testcases.map.yaml rename to openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/testcases.map.yaml index 70d2daa..661d99f 100644 --- a/openspec/changes/chg_0008_operator_real_algorithms/testcases.map.yaml +++ b/openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/testcases.map.yaml @@ -1,4 +1,4 @@ -# spec: experiment_platform@chg_0008 +# spec: experiment_platform@2026-09-28-chg_0008_operator_real_algorithms scenarios: - id: S1 cases: [C1_scql_sum_invariant] diff --git a/openspec/changes/chg_0008_operator_real_algorithms/testcases.md b/openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/testcases.md similarity index 100% rename from openspec/changes/chg_0008_operator_real_algorithms/testcases.md rename to openspec/changes/archive/2026-09-28-chg_0008_operator_real_algorithms/testcases.md