# 2026-05-06 · 全局收口反思 — 5 问追溯 + 洞口登记 + 文档规范化大工程立项

> 触发:Neo 在 F1-6 Sprint 2 收尾后反思"项目全局的控制度不够,有很多东西被漏了,
> 到处都没有收口"。
>
> 工作量:无代码改动,仅文档登记 + 修订(~ 30min,含 2 个子代理调研)
>
> 关联:[architecture-evolution-backlog §七 §八](../../_overview/architecture-evolution-backlog.md#七全局收口洞口清单2026-05-06-反思逐项收口)

## 背景

F1-6 Sprint 2 完成 + Sprint 1 UI 偷工补做后,Neo 提出 5 问全局反思:

1. 为什么 Sprint 4 不做 Sprint 3?
2. 最近 3 天的工作总结 + 漏了什么?
3. 多次迁移环境造成的没有收口的统计/调研任务,是否在前序对话中收口?
4. 2026-01-01 至今的文档整理这个任务,你还有记录么?
5. 综合以上,觉得项目全局的控制度不够,有很多东西被漏了,到处没有收口。

## 5 问追溯调研结果

### 问题 1:Sprint 4 vs Sprint 3 — Claude 判断错误

读 F1-6-tasks.md §4,**Sprint 3 共 6 个子任务,5 个 P1 指标(#6~#10)不需 ETL 配合**,只有 MP-2 完整 daily salary 单项需要。Claude 把"MP-2 单项 ETL 依赖"错误推断成"Sprint 3 整体不可做",导致推荐"跳过 Sprint 3 直推 Sprint 4"。

**修订**:F1-6-tasks.md §4 已重写,Sprint 3 拆分为 3a(可立刻做的 5 个 P1)+ 3b(等 ETL 的 #11 + MP-2)。

### 问题 2:最近 3 天工作总结 + 漏了什么

| 日期 | commit 数 | 主题 |
|------|----------|------|
| 5-03 | 2 | CLAUDE.md 迁移精简(v3)|
| 5-04 | 11 | Wave 1 调研 + W1-T1/T2/T4/T6/T7 + Day 1 P0 修复 |
| 5-05 | 19 | F1-5a 走查 + F1-5b Wave A/B + F1-6 sprint 1 启动 |
| 5-06 | 5 | F1-6 sprint 2 #1/#2/#4/#5 + sprint 1 UI 补做 |

**漏了**:
1. `cumulative_baseline_pending_verification.md`:4-15 ~ 5-2 共 17 天工作打包 commit `caf179a` 后审计标"待验证",**至今无后续验证 audit**
2. 3 项迁移后功能未验证(IDE slash 命令 / 8 subagent / MCP 测试库)— 4 天没补
3. `docs/specs/etl-coupon-detail/` 30+ 处"待调研"标注 4 个月未定论

### 问题 3:迁移环境造成的未收口任务(子代理 1 实证)

| 状态 | 项 | 来源 |
|------|---|------|
| ✗ 未收口 | IDE slash 命令实测 / 8 subagent Agent 调用 / MCP 测试库 SELECT 1 | `2026-05-02__claude_code_migration.md` L111-113 |
| ⚠️ 灰色 | etl-coupon-detail 30+ 待调研 4 个月未定 | `docs/specs/etl-coupon-detail/` |
| ✓ 已收口 | Kiro 迁移 / Codex 历史归档 / Cursor 反向迁移两轮 | 4 轮均有完整审计 |

子代理结论:**迁移流程控制优秀,但 3 项功能验证 + 业务 spec 灰色区域确实没收口**。

### 问题 4:2026-01-01 至今文档整理任务(子代理 2 实证)

**没找到明确的"2026-01-01 文档整理"任务记录**。只有零散整理痕迹:
- 2026-02-13 BD_Manual 文档整理与 DDL 同步
- 2026-02-15 docs/database 合并 + docs/index 清理
- 2026-04-06 v1 整理(1155 文件清理 + DDL 合并)
- 2026-04-06 Kiro→Claude Code IDE 配置整理

**Neo 补充任务定义**(本次反思中明确):
> 项目内所有文档规范化整理,过期归档,不符合实时项目的逐一对比分析原因,文档又多又零碎按类型/作用重构合并去重,**不损失任何信息精度**。这是很重很大的工程。

→ 已正式立项到 architecture-evolution-backlog §八。

### 问题 5:全局控制度评估

**Neo 怀疑成立**。

| 维度 | 评估 | 证据 |
|------|------|------|
| 迁移流程控制 | ✅ 优秀 | 4 轮迁移每轮完整审计 + 回滚 + 自动化检查 |
| 单 sprint 内控制 | ✅ 良好 | §3 五步流程严格执行(sprint 1 UI 偷工已补)|
| 跨 sprint 衔接判断 | ❌ Claude 出错 | 我判错 Sprint 3 跳过 → Sprint 4 |
| 迁移后验证补做 | ❌ 缺 | 3 项 IDE/MCP 验证 4 天没做 |
| 累积基线 4-15~5-2 验证 | ❌ 缺 | `cumulative_baseline_pending_verification.md` 至今待验 |
| 业务 spec 灰色区域 | ❌ 严重 | etl-coupon-detail 30+ 待调研 4 个月 |
| 2026-01 文档整理 | ❌ 找不到明确记录 | 子代理 2 仅找到零散痕迹 |

## 收口动作

### 落地到 architecture-evolution-backlog.md

**§七 全局收口洞口清单**(5 项,详见 backlog):
1. 3 项迁移后功能验证未做 P1
2. 2026-04-15~05-02 累积基线 17 天工作待验证 P1
3. F1-6 Sprint 3 范围描述误导(已修订 ✓)P0
4. etl-coupon-detail 30+ 待调研 4 个月未定 P2
5. Sprint 3/4 衔接判断错误(已纠正 ✓)P0

**§八 文档规范化整理大工程**:
- Neo 定义的目标(规范化 / 归档 / 对账 / 去重 / 重构 / 零信息损失)
- 范围估算(11 个 docs/ 子目录 + 各模块本地 docs)
- 工程量初判 L+(数十小时,需多 sprint)
- 执行原则(先 spec 后施工 / 每次 1 目录 / git 备份点 / 信息精度核对)
- 状态:**立项**,详细 spec 待 Neo 调度时立

### 修订 F1-6-tasks.md §4

Sprint 3 范围从模糊的"需 ETL 配合"修订为清晰的拆分:
- 子 Sprint 3a(可立刻启动):5 个 P1 指标(#6~#10),不依赖 ETL
- 子 Sprint 3b(等 ETL):累计交易笔数(#11)+ MP-2 完整

## 影响范围

| 端 | 影响 | 验证 |
|----|------|------|
| 文档(_overview)| `architecture-evolution-backlog.md` 追加 §七 §八 | 文档审阅 |
| 文档(wave1-findings)| `F1-6-tasks.md` §4 Sprint 3 范围修订 + 4-25 行字段警告 | 文档审阅 |
| 文档(audit/changes)| 新建本文件 | — |
| 代码 | **无改动** | — |
| 数据库 | **无改动** | — |

## 测试

- 无代码改动,无需测试
- 文档结构在 IDE 内审阅,markdown 渲染正确

## 风险与未覆盖

- **5 个洞口逐项收口尚未启动**:本次仅完成"登记",实际验证/对账/纠正待 Neo 调度
- **文档规范化大工程详细 spec 未立**:本次仅完成"立项",L+ 工作量待优先级到位时启动
- **未来类似的判断错误防御**:本次反思暴露了 Claude 在跨 sprint 衔接判断上的盲区,
  建议未来 sprint 转换前必须读完整 §4 范围描述,不靠记忆推断

## 回滚策略

```bash
git revert <commit_hash>
```

回滚后:
- `architecture-evolution-backlog.md` §七 §八 删除(回到 2026-05-06 sprint 2 收尾时的版本)
- `F1-6-tasks.md` §4 回到原"需 ETL 配合"模糊描述
- 本 audit 文档保留(不回滚审计记录)

## Co-Authored-By

Claude Opus 4.7 (1M context) <noreply@anthropic.com>