Browse Source

docs(tdd): 主理人 O-4 裁决落地——顶层目标 218→236(sc-key-map 表格行口径正本 236,A24/G12/P93/C25/T32/S11/X22/B10/H7;更正 0935 轮 237 统计误差;总览残留 SC-B-03/08 空号与 SC-T-6=SC-T-06 变体不计入;DEV_GOAL/SC-key-map/CI_READINESS 三方同步)

Agnes Agent 6 ngày trước cách đây
mục cha
commit
0a50c44cc

+ 9 - 0
docs/tdd/ci/CI_READINESS_2026-11-05.md

@@ -103,3 +103,12 @@
 - 预期:两 RED 的契约级 JUnit(AdminAuthControllerLoginTest / HealthReportControllerUploadTest 类)合入 origin/cfclub 后,将成为既有 107 例契约池的新增成员,B-2/B-3 由「测试台账待研发」转为「研发闭环中」。
 
 **如实声明**:CI 入口仍未启用(根目录无 `.gitlab-ci.yml`,`when: manual` 草案不擅动);runner JDK8 能力仍待主理人核实(编排机实测 JDK21,不能推断 runner)。本轮仅登记 RED 在途状态,**不宣称 CI 已启用、不宣称 S-cfc-17/18 已跑通**(缺三类流执行证据 + mark-green)。
+
+## 二·六、O-4 裁决同步(2026-11-06,主理人拍板)
+
+**场景总数口径 218 → 236**(正式裁决落地,详见 `docs/tdd/orchestration/DEV_GOAL_user_scenarios.md` §4.2)。
+
+- **G2(SC 必测清单/完成判据)**:完成判据由「218/218 SC 跑通」改为「**236/236 SC 跑通**」;必测 SC 范围含新增的 AI 成长教练 SC-B 10、真人管家 SC-H 7、跨角色 SC-X-22(契约/JUnit 已合入,待三类流执行证据 + mark-green)。
+- **G3(必测矩阵)**:SC-X-22 在 G3 必填行维持「未跑通」;SC-B / SC-H 若测试侧有执行证据可转正(按方案 C,转测试侧补三类流)。
+- **如实声明**:本裁决仅调整口径,不影响既有契约测试资产与实现提交 sha(f14e46f84 / 2869d0e8e / 6141c43a2 等全部 IN CHAIN);后续汇报「场景覆盖矩阵」基数均从 218 改为 236。
+

+ 6 - 6
docs/tdd/orchestration/DEV_GOAL_user_scenarios.md

@@ -6,7 +6,7 @@
 
 ## 一、目标定义
 
-**让 `tests/user-scenarios/应用场景总览.md` 列出的全部 218 个应用场景(`SC-角色-NN`)都能端到端跑通。**
+**让 `tests/user-scenarios/应用场景总览.md` 列出的全部 236 个应用场景(`SC-角色-NN`;O-4 裁决 2026-11-06 落地,基线 218→236)都能端到端跑通。**
 
 「跑通」的判定(三者缺一不可):
 
@@ -22,7 +22,7 @@
 
 | 资产 | 路径 | 规模 |
 |------|------|------|
-| 场景总目录与追溯矩阵(一级权威) | `tests/user-scenarios/应用场景总览.md` | 218 个 SC:游客 12 / 家长 93 / 孩子 25 / 规划师 32 / 运营 24 / 服务商 11 / 跨角色 21 |
+| 场景总目录与追溯矩阵(一级权威) | `tests/user-scenarios/应用场景总览.md` | 236 个 SC:游客 12 / 家长 93 / 孩子 25 / 规划师 32 / 运营 24 / 服务商 11 / 跨角色 22 / AI 成长教练 10 / 真人管家 7(O-4 裁决 2026-11-06 落地,218→236;含 SC-B/AI 成长教练 10、SC-H/真人管家 7、SC-X-22 CF 预估) |
 | 角色叙事细节 | `tests/user-scenarios/01-guest.md` ~ `07-five-dimension.md` + `README.md` | 每个场景含用户故事、前置条件、主流程、异常/边界、关联需求/设计、关联用例 |
 | 派生测试用例 | `tests/test-cases/*.md`(含 `cross-role-e2e.md`) | 729 条 TC |
 | 自动化状态台账 | `docs/tdd/test/automation-status.md` | 由 `test_inventory.py` 从 `.tdd/test-progress.json` 派生 |
@@ -35,7 +35,7 @@
 ## 三、现状(2026-11-05 基线)
 
 - `docs/tdd/test/automation-status.md`:结构化测试用例 729 条 → **已执行 0 / 通过 0 / 失败 0 / 未跟踪 729**;脚本级自动化尚未接入 CI(无 `.github/workflows/`、`.gitlab-ci.yml`、`Jenkinsfile`)。
-- 因此本目标处于 **0 / 218** 起步状态;每轮汇报必须如实填写「累计已跑通场景数」,不得用「任务已分派」冒充「场景已跑通」。
+- 因此本目标处于 **0 / 236** 起步状态;每轮汇报必须如实填写「累计已跑通场景数」,不得用「任务已分派」冒充「场景已跑通」。
 
 ---
 
@@ -50,7 +50,7 @@
 
 ### 4.1 SC → 能力键映射与计数口径(主理人 O-2 裁决,2026-11-05)
 
-> 本小节是 O-2 裁决的固化(单一事实源),覆盖 00:53 旧口径中「SC 即任务池」的歧义。**权威登记表:`docs/tdd/orchestration/sc-key-map.md`(218 SC 全量,唯一「SC 跑通」计数来源)。**
+> 本小节是 O-2 裁决的固化(单一事实源),覆盖 00:53 旧口径中「SC 即任务池」的歧义。**权威登记表:`docs/tdd/orchestration/sc-key-map.md`(236 SC 全量,唯一「SC 跑通」计数来源;O-4 裁决 2026-11-06 落地)。**
 
 1. **SC 不作状态机键**:`--add-task <key>` 的 `key` 一律为合法 `unit.domain.action`(方案 A 为正本);SC 编号 + 场景文件写进 `--requirement`,已合入 `origin/cfclub` 的契约写进 `--design`(标注「实现仅在 feature 分支、不得假定包路径」)。
 2. **否决放宽 SC 前缀**(方案 B):不改 skill 脚本 `KEY_RE`,避免污染全部项目 + 「SC=能力编排组合」与「单一能力」语义错位。
@@ -61,7 +61,7 @@
 
 ## 五、验收与汇报口径
 
-- 每轮标准汇报 `docs/tdd/orchestration/report-dev-YYYY-MM-DD-HHMM.md` 除模板必填项(**1.2b 会话列表必填,无空闲也列 idle**)外,必须增列 **「场景覆盖矩阵」**:总数 218 / 累计已跑通 / 本轮新增跑通 / 失败 / 阻塞 / 未跟踪,并逐条注明本轮推进的 SC 编号与证据 sha。
+- 每轮标准汇报 `docs/tdd/orchestration/report-dev-YYYY-MM-DD-HHMM.md` 除模板必填项(**1.2b 会话列表必填,无空闲也列 idle**)外,必须增列 **「场景覆盖矩阵」**:总数 236 / 累计已跑通 / 本轮新增跑通 / 失败 / 阻塞 / 未跟踪,并逐条注明本轮推进的 SC 编号与证据 sha。
 - **阶段推进(RED→YELLOW→GREEN)以场景用例实际通过为准**,不得以「实现代码已合入」直接置 GREEN。
 - 收口纪律沿用:只认已推远端 git 证据;**严禁 `git add -A`**;提交他人产物先 `git show origin/cfclub:<path>` 对齐、精确 `git add -- <paths>`;严禁 checkout/stash/force-push 他人改动,独立提交走 worktree;`.tdd/` 本地私有**禁推**,共享内容只放 `docs/tdd/*.md`。
 
@@ -69,4 +69,4 @@
 
 ## 六、完成判据
 
-`218 / 218` 个 SC 均具备三类用例的实际通过证据 + 实现与用例已推 `origin/cfclub` + CI 持续回归可用 + 工作目录干净。在此之前,任何一轮都不得汇报「开发完成」。
+`236 / 236` 个 SC 均具备三类用例的实际通过证据 + 实现与用例已推 `origin/cfclub` + CI 持续回归可用 + 工作目录干净。在此之前,任何一轮都不得汇报「开发完成」。

+ 14 - 0
docs/tdd/orchestration/sc-key-map.md

@@ -269,3 +269,17 @@
 | SC-H-06 | 真人管家 | 业务域 C:资源对接与协同闭环 | 与 AI 管家协同闭环 | — | — | 未跑通 | — |
 | SC-H-07 | 真人管家 | 业务域 D:服务质量 | 服务质检与满意度 | — | — | 未跑通 | — |
 | SC-X-22 | 跨角色 | 奖励/CF 规则中心(全局 UI 规范) | CF 值获取预估(操作前提示 +N CF) | — | — | 未跑通 | — |
+
+---
+
+## O-4 裁决追认(2026-11-06,主理人拍板)
+
+**本台账为唯一「SC 跑通」计数权威,正本登记 236 个 SC**(截至 2026-11-06 09:35 轮)。
+
+- **口径**:表格行(含 SC 编号的 `| SC-... |` 记录行)为计数依据;正文描述/演进记录/编号变体引用不单独计数。
+- **统计公式**:`grep -oE '\| *SC-[A-Z]+-[0-9]+ *\|' docs/tdd/orchestration/sc-key-map.md | sort -u | wc -l` = **236**。
+- **修正说明**:2026-11-06 09:35 轮以全文 grep 得 237,因含表外引用与变体引用(SC-T-6=SC-T-06 笔误);本次裁决更正为 **236**。
+- **SC-B-03 / SC-B-08**:AI 成长教练空号,原移出核心范畴、下沉运营/跨角色,台账已删;总览正文空号说明段落引用不计入。
+- **SC-T-6**:规划师编号无零变体,总览 SC-X-22 产出点清单引用此格式,实际对应台账 `SC-T-06`,不重复计数。
+- **历史演进**:218(2026-11-05 定稿)→ 230(08-butler 补 SC-B 10)→ 235(09-human-butler 补 SC-H 7 并删 SC-B-03/08)→ 236(SC-X-22 CF 预估入池)。
+