From e60cfc037c5d4a96b018391ecd9bb69c8b58d0d9 Mon Sep 17 00:00:00 2001 From: Neo Date: Wed, 6 May 2026 01:58:18 +0800 Subject: [PATCH] =?UTF-8?q?docs(audit):=20=E5=85=A8=E5=B1=80=E6=94=B6?= =?UTF-8?q?=E5=8F=A3=E5=8F=8D=E6=80=9D=20=E2=80=94=205=20=E9=97=AE?= =?UTF-8?q?=E8=BF=BD=E6=BA=AF=20+=20=E6=B4=9E=E5=8F=A3=E7=99=BB=E8=AE=B0?= =?UTF-8?q?=20+=20=E6=96=87=E6=A1=A3=E8=A7=84=E8=8C=83=E5=8C=96=E5=A4=A7?= =?UTF-8?q?=E5=B7=A5=E7=A8=8B=E7=AB=8B=E9=A1=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Neo 在 F1-6 Sprint 2 收尾后反思"项目全局控制度不够,到处没收口"。 经 5 问追溯调研(2 个子代理 + Bash 实证),识别 5 个未收口洞口 + 1 个 未明确登记的大工程,本次完成"登记 + 修订",实际收口动作待逐项推进。 5 个未收口洞口(已登记 backlog §七): - P0 #3 F1-6 Sprint 3 范围描述误导(本次已修订 F1-6-tasks.md §4 拆分 3a/3b) - P0 #5 Sprint 3/4 衔接判断错误(本次已纠正) - P1 #1 3 项迁移后功能验证未做(IDE slash / 8 subagent / MCP 测试库) - P1 #2 2026-04-15~05-02 累积基线 17 天工作待验证 - P2 #4 etl-coupon-detail 30+ 待调研 4 个月未定 文档规范化大工程立项(已登记 backlog §八): - Neo 明确目标:规范化 / 归档 / 对账 / 去重 / 重构 / 零信息损失 - 范围 11 个 docs/ 子目录 + 各模块本地 docs - 工程量 L+(数十小时,需多 sprint) - 状态:立项,详细 spec 待 Neo 调度时立 落地修订: - docs/_overview/architecture-evolution-backlog.md 追加 §七 §八 - docs/_overview/wave1-findings/F1-6-tasks.md §4 Sprint 3 拆分 3a/3b - docs/audit/changes/2026-05-06__global_closure_reflection.md 反思全文 承认:Claude 在跨 sprint 衔接判断上有盲区,本次反思已纠正,未来 sprint 转换 前必须读完整 §4 范围描述,不靠记忆推断。 Co-Authored-By: Claude Opus 4.7 (1M context) --- .../architecture-evolution-backlog.md | 75 ++++++++++ docs/_overview/wave1-findings/F1-6-tasks.md | 39 +++-- docs/audit/audit_dashboard.md | 5 +- .../2026-05-06__global_closure_reflection.md | 138 ++++++++++++++++++ 4 files changed, 245 insertions(+), 12 deletions(-) create mode 100644 docs/audit/changes/2026-05-06__global_closure_reflection.md diff --git a/docs/_overview/architecture-evolution-backlog.md b/docs/_overview/architecture-evolution-backlog.md index bc7eea5..fd2f544 100644 --- a/docs/_overview/architecture-evolution-backlog.md +++ b/docs/_overview/architecture-evolution-backlog.md @@ -47,3 +47,78 @@ | 日期 | 决策 / 变更 | 触发 | |------|------------|------| | 2026-05-06 | 创建本 backlog | F1-6 Sprint 2 #3 累计交易笔数调研发现 DWS 字段名与实算口径矛盾 + app7 直读 DWD 违规,Neo 决定将 DWD 孤立 + Core 中间件目标提上任务表 | +| 2026-05-06 | 追加 §七 全局收口洞口清单 + §八 文档规范化整理大工程 | Neo 反思项目全局控制度,5 问追溯调研后立项 | + +--- + +## 七、全局收口洞口清单(2026-05-06 反思,逐项收口) + +### 触发背景 +Neo 发现"项目全局的控制度不够,有很多东西被漏了,到处都没有收口"。 +经 5 问追溯调研(子代理 + Bash 实证),发现以下 5 个未收口洞口。 + +### 收口清单 + +| # | 洞口 | 来源证据 | 状态 | 优先级 | 处理方式 | +|---|------|---------|------|--------|---------| +| 1 | **3 项迁移后功能验证未做** | `docs/audit/changes/2026-05-02__claude_code_migration.md` L111-113 标"待用户后续验证" | ⏳ 待验 | P1 | (a) IDE 中输入 `/audit` 等 5 个 slash 命令是否能加载;(b) 8 个 subagent 通过 `Agent` 工具调用是否正常;(c) MCP 测试库 `pg-etl-test` / `pg-app-test` `SELECT 1` 通过 — 各自 ~ 2 分钟,出补做 audit | +| 2 | **2026-04-15 ~ 05-02 累积基线 17 天工作待验证** | `docs/audit/changes/2026-05-04__cumulative_baseline_pending_verification.md` 文件名即"待验证",commit `caf179a` 把 17 天工作打包成 1 个 commit | ⏳ 待验 | P1 | 读该 audit 文档列举的待验证项,逐项验证或推迟到具体 wave 验证(F1-5a/F1-5b 走查实际已部分覆盖,需对账)| +| 3 | **F1-6 Sprint 3 范围描述误导** | F1-6-tasks.md §4 把 MP-2 单项 ETL 依赖错误暗示成 Sprint 3 整体不可做,导致 Claude 推荐"跳过 Sprint 3 直推 Sprint 4" | ⏳ 待修订 | P0 | 修订 F1-6-tasks.md §4,明确 5 个 P1 指标(#6~#10)可独立做,仅 MP-2 依赖 ETL 配合 | +| 4 | **etl-coupon-detail 30+ "待调研"标注** 4 个月未定 | `docs/specs/etl-coupon-detail/` design.md + requirements.md(package_services / coupon_details_list 等) | ⏳ 灰色 | P2 | 由 Neo 评估是否在 Wave 1 解决;若是登记到 W1 任务清单,若否明确推迟到指定阶段 | +| 5 | **Sprint 3 / 4 衔接判断错误** | Claude 在 Sprint 2 收尾时推荐"跳过 Sprint 3"是错误判断 | 已识别 | P0 | 本次反思已纠正,Sprint 2 收尾后正确顺序 = Sprint 3 (5/6 项可做) → Sprint 4 | + +### 收口原则 +- 每项洞口完成后,出对应 audit 文档(`docs/audit/changes/2026-05-XX__closure_*.md`) +- 完成后标 ✅ 并补 commit 引用 +- 不再让"待验证 / 待调研"在文档中无限期挂着 + +--- + +## 八、文档规范化整理(大工程,长期立项) + +### 触发背景 +Neo:"项目中的文档又多又零碎,分支理不清,只能逐一处理并全部文档按类型和作用 +重构合并去重等。但我不想损失任何的信息精度。这是一个很重很大的工程。" + +调研背景(子代理 2 实证 2026-05-06):**没有找到明确的"2026-01-01 至今文档整理" +任务记录**,只有零散的局部整理痕迹(2026-02-13 BD manual 整理 / 2026-02-15 docs/database +合并 / 2026-04-06 v1 整理 1155 文件)。本立项即明确该任务正式登记。 + +### 工程目标(Neo 定义) + +1. **规范化**:项目内所有文档按类型和作用归类 +2. **归档**:过期内容统一归档(不删除) +3. **对账**:不符合项目实时状态的文档,逐一对比分析原因 +4. **去重 + 合并**:多文档同主题/重叠内容,合并去重 +5. **重构**:目录结构按"类型 + 作用"重新组织 +6. **零信息损失** (关键约束):**不损失任何精度**,即使整理过程也保留原文留底 + +### 范围估算(初步,详细 spec 待立) + +- `docs/_overview/`(产品全景索引) +- `docs/audit/`(审计记录,200+ 篇 audit 文档) +- `docs/prd/`(PRD + 决策卡 + 反馈) +- `docs/database/`(BD manual + DDL) +- `docs/specs/`(spec 文档,含 etl-coupon-detail 等) +- `docs/ai/`(AI prompt 体系) +- `docs/contracts/`(OpenAPI 契约) +- `docs/guides/`(开发指南) +- `docs/miniprogram-dev/`(小程序开发) +- `docs/architecture/`(架构总览) +- `docs/ai-env-history/`(迁移历史) +- 各模块内 `docs/`(模块本地文档) + +### 工程量初判 +- 大概率 **L+ 工作量**(数十小时,需要分多个 sprint) +- 必须有明确 spec 设计(类型分类标准 / 归档约定 / 去重原则 / 信息损失防护) +- 不在 F1-6 阶段 B 做,作为独立任务在 F1-6 完成后或并行启动 + +### 执行原则 +- 先 spec 后施工(不做无规划重构) +- 每次提交 1 个目录或 1 个主题,不批量乱动 +- 整理前留下 git 备份点(全文档 tar 归档 _DEL/ ) +- 整理后做信息精度核对(diff 比对关键内容) + +### 状态 +- ⏳ **立项**(2026-05-06 由 Neo 在反思时正式登记) +- 详细 spec 待 Neo 调度时立(可能与 F1-6 阶段 B 收尾后启动) diff --git a/docs/_overview/wave1-findings/F1-6-tasks.md b/docs/_overview/wave1-findings/F1-6-tasks.md index f8c737b..c47190a 100644 --- a/docs/_overview/wave1-findings/F1-6-tasks.md +++ b/docs/_overview/wave1-findings/F1-6-tasks.md @@ -104,19 +104,36 @@ ## 四、Sprint 3 范围(待启动) -### 5 个助教/门店相关 P1 + MP-2 完整 +> ⚠️ 2026-05-06 修订(全局收口反思后):原描述"需 ETL 团队配合"误导 Claude +> 推荐"跳过 Sprint 3 直推 Sprint 4"。**实际上 5 个 P1 指标(#6~#10)完全可独立做, +> 沿用 Sprint 1/2 模式;仅 MP-2 单项需 ETL 配合**,可拆分推进。详见架构演进 +> backlog §七 第 3 项。 -| # | 指标 | 备注 | -|---|------|------| -| 6 | 累计服务客户数(助教) | dws_assistant_customer_stats daily | -| 7 | 助教等级 | dws_assistant_daily_detail.assistant_level_code | -| 8 | 月度课时(助教) | dws_assistant_daily_detail.base_hours 聚合 | -| 9 | 月度计费金额(助教) | dws_assistant_daily_detail.total_ledger_amount 聚合 | -| 10 | 月度新增/流失会员 | dws_member_*_summary daily | -| **MP-2 完整 daily salary** | board-coach 月度面板 | **需 ETL 团队配合**:新建 dws_assistant_daily_salary 表 + ETL Excel 上传 UI 改造 | +### 5 个助教/门店相关 P1 指标(可立刻做,不依赖 ETL)+ MP-2 完整(独立子任务,需 ETL 配合) -### Sprint 3 估算 -5 指标 ~ 3-4h + MP-2 完整 5-6h(含 ETL 改造) = **L ~ 8-10h** +| # | 指标 | 数据源 | 是否需 ETL 配合 | +|---|------|--------|---------------| +| 6 | 累计服务客户数(助教) | `dws_assistant_customer_stats` daily | **不需要**(走 Sprint 1/2 同款模式)| +| 7 | 助教等级 | `dws_assistant_daily_detail.assistant_level_code` | **不需要** | +| 8 | 月度课时(助教) | `dws_assistant_daily_detail.base_hours` 聚合 | **不需要** | +| 9 | 月度计费金额(助教) | `dws_assistant_daily_detail.total_ledger_amount` 聚合 | **不需要** | +| 10 | 月度新增/流失会员 | `dws_member_*_summary` daily | **不需要** | +| 11 | (Sprint 2 推迟项) 累计交易笔数 | 需 ETL 新增 `total_open_table_count` | **需要** | +| **MP-2 完整 daily salary** | 新建 `dws_assistant_daily_salary` 表 + Excel 上传 UI 改造 | **需要** | + +### Sprint 3 拆分实施 + +**子 Sprint 3a(可立刻启动)**:5 个 P1 指标 #6~#10 +- 沿用 Sprint 1/2 §3 五步流程 +- 估算 ~ 3-4h +- 不依赖 ETL 团队 + +**子 Sprint 3b(等 ETL 配合)**:#11(累计交易笔数)+ MP-2 完整 +- 需要先与 ETL 团队对齐:新建 `dws_assistant_daily_salary` + 新增 `total_open_table_count` + Excel 上传 UI 改造 +- 估算 ~ 5-6h(含 ETL 改造) + +### Sprint 3 总估算 +5 P1 指标 ~ 3-4h + #11/MP-2 完整 5-6h = **L ~ 8-10h**(可拆 3a + 3b 独立推进) --- diff --git a/docs/audit/audit_dashboard.md b/docs/audit/audit_dashboard.md index 3a4fc50..87c3e1a 100644 --- a/docs/audit/audit_dashboard.md +++ b/docs/audit/audit_dashboard.md @@ -1,6 +1,6 @@ # 审计一览表 -> 自动生成于 2026-05-06 01:32:13，请勿手动编辑。 +> 自动生成于 2026-05-06 01:58:18，请勿手动编辑。 ## 时间线视图 @@ -10,6 +10,7 @@ | 2026-05-06 | 项目级 | 2026-05-06 · F1-6 Sprint 2 #4 — 储值卡余额迁移到 sandbox_replay(SCD2 时光机) | 功能 | 其他 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_member_balance.md) | | 2026-05-06 | 项目级 | 2026-05-06 · F1-6 Sprint 2 #2 — 累计消费总额加入 sandbox_replay | 清理 | 其他 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_total_consume_amount.md) | | 2026-05-06 | 项目级 | 2026-05-06 · F1-6 Sprint 2 #5 — 累计 GMV 加入 sandbox_replay(门店级) | 文档 | 其他 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_total_gmv.md) | +| 2026-05-06 | 项目级 | 2026-05-06 · 全局收口反思 — 5 问追溯 + 洞口登记 + 文档规范化大工程立项 | bugfix | 其他 | 未知 | [链接](changes/2026-05-06__global_closure_reflection.md) | | 2026-05-05 | 项目级 | 2026-05-05 · F1-6 Sprint 1 沙箱时光机引擎启动 + get_last_visit_days 试点迁移 | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__f1_6_sprint1_sandbox_replay_kickoff.md) | | 2026-05-05 | 项目级 | 2026-05-05 — Wave 1 F1-5a 完整走查(应查尽查版) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_backend_walkthrough.md) | | 2026-05-05 | 项目级 | Wave 1 F1-5a — 沙箱 batch-run 接入 runtime_context(MVP + 漂移防御核心) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_sandbox_batch_run.md) | @@ -296,6 +297,7 @@ | 2026-05-06 | 2026-05-06 · F1-6 Sprint 2 #4 — 储值卡余额迁移到 sandbox_replay(SCD2 时光机) | 功能 | 其他 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_member_balance.md) | | 2026-05-06 | 2026-05-06 · F1-6 Sprint 2 #2 — 累计消费总额加入 sandbox_replay | 清理 | 其他 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_total_consume_amount.md) | | 2026-05-06 | 2026-05-06 · F1-6 Sprint 2 #5 — 累计 GMV 加入 sandbox_replay(门店级) | 文档 | 其他 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_total_gmv.md) | +| 2026-05-06 | 2026-05-06 · 全局收口反思 — 5 问追溯 + 洞口登记 + 文档规范化大工程立项 | bugfix | 其他 | 未知 | [链接](changes/2026-05-06__global_closure_reflection.md) | | 2026-05-05 | 2026-05-05 · F1-6 Sprint 1 沙箱时光机引擎启动 + get_last_visit_days 试点迁移 | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__f1_6_sprint1_sandbox_replay_kickoff.md) | | 2026-05-05 | 2026-05-05 — Wave 1 F1-5a 完整走查(应查尽查版) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_backend_walkthrough.md) | | 2026-05-05 | Wave 1 F1-5a — 沙箱 batch-run 接入 runtime_context(MVP + 漂移防御核心) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_sandbox_batch_run.md) | @@ -471,6 +473,7 @@ | 2026-05-06 | 2026-05-06 · F1-6 Sprint 2 #4 — 储值卡余额迁移到 sandbox_replay(SCD2 时光机) | 功能 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_member_balance.md) | | 2026-05-06 | 2026-05-06 · F1-6 Sprint 2 #2 — 累计消费总额加入 sandbox_replay | 清理 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_total_consume_amount.md) | | 2026-05-06 | 2026-05-06 · F1-6 Sprint 2 #5 — 累计 GMV 加入 sandbox_replay(门店级) | 文档 | 未知 | [链接](changes/2026-05-06__f1_6_sprint2_total_gmv.md) | +| 2026-05-06 | 2026-05-06 · 全局收口反思 — 5 问追溯 + 洞口登记 + 文档规范化大工程立项 | bugfix | 未知 | [链接](changes/2026-05-06__global_closure_reflection.md) | | 2026-05-05 | 2026-05-05 · F1-6 Sprint 1 沙箱时光机引擎启动 + get_last_visit_days 试点迁移 | bugfix | 未知 | [链接](changes/2026-05-05__f1_6_sprint1_sandbox_replay_kickoff.md) | | 2026-05-05 | 2026-05-05 — Wave 1 F1-5a 完整走查(应查尽查版) | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_backend_walkthrough.md) | | 2026-05-05 | Wave 1 F1-5a — 沙箱 batch-run 接入 runtime_context(MVP + 漂移防御核心) | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_sandbox_batch_run.md) | diff --git a/docs/audit/changes/2026-05-06__global_closure_reflection.md b/docs/audit/changes/2026-05-06__global_closure_reflection.md new file mode 100644 index 0000000..aeb452a --- /dev/null +++ b/docs/audit/changes/2026-05-06__global_closure_reflection.md @@ -0,0 +1,138 @@ +# 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 +``` + +回滚后: +- `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)