@tencent-rtc/trtc-agent-skills 0.1.3 → 0.1.4

package/knowledge-base/scenario-spec.md

@@ -1,109 +1,513 @@
-# Scenario 文件写作规范（Spec）
+# Scenario 文件写作规范(Spec)
+# Scenario 文件写作规范(Spec)
 
 > 本文档定义 `knowledge-base/scenarios/{scenario-id}.md` 的标准结构。
 > 新建场景文件按本规范写；老文件按本规范逐步对齐。
-> 配套：`slice-spec.md`（slice 级规范）、`index.yaml`（场景索引）。
+> 配套：`slice-spec.md`（slice 级规范）、per-product platform index（场景/能力索引）。
 
 ---
 
 ## 一、scenario 文件的角色
 
-scenario 文件是 **topic skill 的场景剧本**。topic 接到一个场景 id 后，把这份文件当 ground truth，按它说的：
+scenario 文件是 **topic skill 的场景剧本**。topic 接到一个场景 id 后,把这份文件当 ground truth,按它说的:
+scenario 文件是 **topic skill 的场景剧本**。topic 接到一个场景 id 后,把这份文件当 ground truth,按它说的:
 
-- 列出场景包含哪些能力（slice）
+- 列出场景包含哪些能力(slice)
+- 列出场景包含哪些能力(slice)
 - 决定是否让用户在"主链路 / 完整版"之间选 coverage
 - 走每一步 slice 集成
 
-→ **写 scenario 文件 = 给 topic 提供执行剧本**，措辞应面向"AI 读这份文件后该做什么"。
+→ **写 scenario 文件 = 给 topic 提供执行剧本**,措辞应面向"AI 读这份文件后该做什么"。
+
+**最终读者是 AI**:任何模糊词("一般来说""差不多""按业务考虑")都会让 topic 路由错误,选错场景或装上用户没要的能力。
+→ **写 scenario 文件 = 给 topic 提供执行剧本**,措辞应面向"AI 读这份文件后该做什么"。
+
+**最终读者是 AI**:任何模糊词("一般来说""差不多""按业务考虑")都会让 topic 路由错误,选错场景或装上用户没要的能力。
 
 ---
 
-## 二、两种场景形态：A vs B
+## 二、两种场景形态:A vs B
+## 二、两种场景形态:A vs B
 
-每个场景按自身性质二选一形态，**不强制都要分层**。
+每个场景按自身性质二选一形态,**不强制都要分层**。
+每个场景按自身性质二选一形态,**不强制都要分层**。
 
 | 形态 | 适用场景 | 特征 | 用户是否参与 coverage 选择 |
 |---|---|---|---|
-| **A：单一完整能力** | 所有 slice 缺一不可：1v1 通话、秀场直播间、电商直播等 | 能力不可拆，少一个就不成场景 | 否 |
-| **B：主链路 + 可选增强** | 有清晰的"开箱可用最小集 + 推荐增强"边界：通用会议、协作工具等 | 主链路是默认，增强按需 | 是（minimal / complete 二选一，或可选模块多选） |
+| **A:单一完整能力** | 所有 slice 缺一不可:1v1 通话、秀场直播间、电商直播等 | 能力不可拆,少一个就不成场景 | 否 |
+| **B:主链路 + 可选增强** | 有清晰的"开箱可用最小集 + 推荐增强"边界:通用会议、协作工具等 | 主链路是默认,增强按需 | 是(minimal / complete 二选一,或可选模块多选) |
+| **A:单一完整能力** | 所有 slice 缺一不可:1v1 通话、秀场直播间、电商直播等 | 能力不可拆,少一个就不成场景 | 否 |
+| **B:主链路 + 可选增强** | 有清晰的"开箱可用最小集 + 推荐增强"边界:通用会议、协作工具等 | 主链路是默认,增强按需 | 是(minimal / complete 二选一,或可选模块多选) |
+
+### 形态 B 的两种 coverage 粒度
+### 形态 B 的两种 coverage 粒度
+
+- **B-二选一(minimal / complete)**:增强项作为一个整体,用户在"主链路"和"完整版"之间二选一。写 `enhancement_level`。
+- **B-多选(必装骨架 + 可选模块多选)**:增强项彼此独立、用户通常只要其中几项(典型如通用会议:要屏幕共享和预约,但不要美颜)。此时**必装骨架 always on,可选模块逐项多选,默认只勾选命中用户 `target_features` / 原始 prompt 的项**,结果写入 `confirmed_plan = 必装骨架 + 选中模块`。
+
+### B-多选的反模式判定
+
+**禁止**把可选项独立的场景写成 Form A(整张 `slices:` 全集默认安装)——这正是"用户没要美颜却被装上美颜"(over-integration)的根因。
+
+#### ❌ 反模式正例
+
+某 scenario 的可选项:屏幕共享、虚拟背景、美颜、白板、预约、录制
+- 用户原始 prompt:"我要做团队会议,需要屏幕共享和预约"
+- 错误处理:全部默认安装 → 用户拿到含美颜的代码 → 投诉"我没要美颜"
+- 正确处理:必装骨架 always on;可选项中**仅勾选命中关键词的**(屏幕共享、预约);其余不进 `confirmed_plan`,代码里也不出现
+
+#### B-多选的判据
+
+选这种粒度,当且仅当:
+- 可选项之间**没有"要就全要"的耦合**
+- 默认全装会给用户塞他没要的功能(over-integration)
+
+### 形态判断准则
+
+写 P1 之前先问自己——"如果不选这条增强,场景还能成立吗?"
+- 能 → P1
+- 不能 → P0
+- 整个场景全部 slice 都"少一个就不成立" → 直接走 A 形态
+- **B-二选一(minimal / complete)**:增强项作为一个整体,用户在"主链路"和"完整版"之间二选一。写 `enhancement_level`。
+- **B-多选(必装骨架 + 可选模块多选)**:增强项彼此独立、用户通常只要其中几项(典型如通用会议:要屏幕共享和预约,但不要美颜)。此时**必装骨架 always on,可选模块逐项多选,默认只勾选命中用户 `target_features` / 原始 prompt 的项**,结果写入 `confirmed_plan = 必装骨架 + 选中模块`。
+
+### B-多选的反模式判定
+
+**禁止**把可选项独立的场景写成 Form A(整张 `slices:` 全集默认安装)——这正是"用户没要美颜却被装上美颜"(over-integration)的根因。
 
-**形态 B 的两种 coverage 粒度：**
+#### ❌ 反模式正例
 
-- **B-二选一（minimal / complete）**：增强项作为一个整体,用户在"主链路"和"完整版"之间二选一。写 `enhancement_level`。
-- **B-多选（必装骨架 + 可选模块多选）**：增强项彼此独立、用户通常只要其中几项(典型如通用会议:要屏幕共享和预约,但不要美颜)。此时**必装骨架 always on,可选模块逐项多选,默认只勾选命中用户 `target_features` / 原始 prompt 的项**,结果写入 `confirmed_plan = 必装骨架 + 选中模块`。
-  - 选这种粒度的判据:可选项之间没有"要就全要"的耦合,且默认全装会给用户塞他没要的功能(over-integration)。
-  - 反模式:把这类场景写成 Form A(整张 `slices:` 全集默认安装)——这正是"用户没要美颜却被装上美颜"的根因,**禁止**。
-  - 章节写法见下方「形态 B：能力展示 + coverage」的多选变体说明;参考实现 `scenarios/conference/base/general-conference.md`。
+某 scenario 的可选项:屏幕共享、虚拟背景、美颜、白板、预约、录制
+- 用户原始 prompt:"我要做团队会议,需要屏幕共享和预约"
+- 错误处理:全部默认安装 → 用户拿到含美颜的代码 → 投诉"我没要美颜"
+- 正确处理:必装骨架 always on;可选项中**仅勾选命中关键词的**(屏幕共享、预约);其余不进 `confirmed_plan`,代码里也不出现
 
-形态判断准则：
-- 写 P1 之前先问自己——"如果不选这条增强，场景还能成立吗？" 能 → P1；不能 → P0。
-- 整个场景全部 slice 都"少一个就不成立" → 直接走 A 形态，不必硬掰。
+#### B-多选的判据
 
-不确定时 default 走 A，将来发现确实有可选项再升级到 B。
+选这种粒度,当且仅当:
+- 可选项之间**没有"要就全要"的耦合**
+- 默认全装会给用户塞他没要的功能(over-integration)
+
+### 形态判断准则
+
+写 P1 之前先问自己——"如果不选这条增强,场景还能成立吗?"
+- 能 → P1
+- 不能 → P0
+- 整个场景全部 slice 都"少一个就不成立" → 直接走 A 形态
+
+不确定时 default 走 A,将来发现确实有可选项再升级到 B。
+
+### 必填项语义三件套(形态选择)
+
+- **违反后果**:形态选错(应 B 写成 A)→ 用户被装上没要的能力(over-integration 投诉)/ 应 A 写成 B → 用户漏装关键能力(场景跑不起来)
+- **验证手段**:reviewer 走形态判断准则,逐条问 P1 candidate 是否"少了不成立"
+- **绕过条件**:无
+不确定时 default 走 A,将来发现确实有可选项再升级到 B。
+
+### 必填项语义三件套(形态选择)
+
+- **违反后果**:形态选错(应 B 写成 A)→ 用户被装上没要的能力(over-integration 投诉)/ 应 A 写成 B → 用户漏装关键能力(场景跑不起来)
+- **验证手段**:reviewer 走形态判断准则,逐条问 P1 candidate 是否"少了不成立"
+- **绕过条件**:无
 
 ---
 
 ## 三、必备章节
 
-每个 active scenario 文件 **必须** 包含以下章节。命名可微调，章节角色和顺序不能动。带 (A) (B) 标记的章节按形态二选一写法。
+每个 active scenario 文件 **必须** 包含以下章节。命名可微调,**章节角色和顺序不能动**。带 (A) (B) 标记的章节按形态二选一写法。
 
-### 1. `## 场景概述`
+> 完整模板见第七节。
+每个 active scenario 文件 **必须** 包含以下章节。命名可微调,**章节角色和顺序不能动**。带 (A) (B) 标记的章节按形态二选一写法。
 
-一段 2-4 行散文，回答三个问题：
-- 这个场景对应什么真实业务（举 1-2 个具体例子）
+> 完整模板见第七节。
+
+### 章节 1:`## 场景概述` [必填]
+### 章节 1:`## 场景概述` [必填]
+
+#### 1️⃣ 你必须写什么
+一段 2-4 行散文,回答三个问题:
+- 这个场景对应什么真实业务(举 1-2 个具体例子)
+#### 1️⃣ 你必须写什么
+一段 2-4 行散文,回答三个问题:
+- 这个场景对应什么真实业务(举 1-2 个具体例子)
 - 用户做这种场景的核心诉求是什么
-- 与其他相似场景如何区分（边界划清）
+- 与其他相似场景如何区分(边界划清)
+- 与其他相似场景如何区分(边界划清)
+
+**用途**:topic Step 1.5 展示给用户的"我帮你定位到了什么场景"的依据。
+**用途**:topic Step 1.5 展示给用户的"我帮你定位到了什么场景"的依据。
+
+#### 2️⃣ 写作模板
+```markdown
+## 场景概述
+
+{场景中文名}对应 {真实业务 1}、{真实业务 2} 这类场景。
+用户的核心诉求是 {诉求 1},以及 {诉求 2}。
 
-**用途**：topic Step 1.5 展示给用户的"我帮你定位到了什么场景"的依据。
+与 {相似场景 A} 的区别:{本场景特有的关键差异点}。
+与 {相似场景 B} 的区别:{差异点}。
+```
+
+#### 3️⃣ ✅ 正例(摘自 entertainment-live-room)
+```markdown
+## 场景概述
+
+娱乐直播间对应秀场直播、才艺直播、聊天室直播等以「主播单方面输出 + 观众互动打赏」
+为核心的场景。用户的核心诉求是低延迟拉流、礼物动效、观众连麦上麦,以及主播工具栏
+(美颜/滤镜/音效)。
+
+与「电商直播」的区别:不需要商品挂载、购物车、订单组件;
+与「视频会议」的区别:观众只能通过弹幕/礼物/连麦申请互动,不能主动发声。
+```
+
+为什么这是正例:
+- ✅ 给了 3 个具体业务例子(秀场/才艺/聊天室),不是空泛的"直播"
+- ✅ 列了 3-4 个核心诉求,新人能感知场景的特征
+- ✅ 与 2 个相似场景划清边界,topic 路由时不会混淆
+
+#### 4️⃣ ❌ 反例
+```markdown
+## 场景概述
+
+本场景介绍娱乐直播间的实现。用户可以直播,观众可以观看互动。
+功能比较丰富,支持各种业务需求。
+```
+
+为什么这是反例:
+- ❌ "本场景介绍 xxx" = 元描述,无信息量
+- ❌ "比较丰富""各种业务需求" = 模糊词
+- ❌ 无具体业务例子、无边界划分
+- → topic 拿到这种描述,无法判断用户的"直播需求"是该路由到本场景还是「电商直播」
+- → review 直接打回
 
-### 2. `## 能力清单` (A) 或 `## 能力分层` (B)
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:场景概述模糊 → topic Step 1.5 路由到错误场景 → 用户拿到不匹配的集成方案
+- **验证手段**:人工 review 三个问题逐条对照;字数 50-200 之间;包含 ≥2 个具体业务例子;包含 ≥1 个边界划分
+- **绕过条件**:无
 
-**slice id 必须与 `index.yaml` 一致**。
+---
+
+### 章节 2:`## 能力清单` (A) 或 `## 能力分层` (B) [必填]
+#### 2️⃣ 写作模板
+```markdown
+## 场景概述
+
+{场景中文名}对应 {真实业务 1}、{真实业务 2} 这类场景。
+用户的核心诉求是 {诉求 1},以及 {诉求 2}。
+
+与 {相似场景 A} 的区别:{本场景特有的关键差异点}。
+与 {相似场景 B} 的区别:{差异点}。
+```
 
-#### 形态 A：能力清单
+#### 3️⃣ ✅ 正例(摘自 entertainment-live-room)
+```markdown
+## 场景概述
 
+娱乐直播间对应秀场直播、才艺直播、聊天室直播等以「主播单方面输出 + 观众互动打赏」
+为核心的场景。用户的核心诉求是低延迟拉流、礼物动效、观众连麦上麦,以及主播工具栏
+(美颜/滤镜/音效)。
+
+与「电商直播」的区别:不需要商品挂载、购物车、订单组件;
+与「视频会议」的区别:观众只能通过弹幕/礼物/连麦申请互动,不能主动发声。
+```
+
+为什么这是正例:
+- ✅ 给了 3 个具体业务例子(秀场/才艺/聊天室),不是空泛的"直播"
+- ✅ 列了 3-4 个核心诉求,新人能感知场景的特征
+- ✅ 与 2 个相似场景划清边界,topic 路由时不会混淆
+
+#### 4️⃣ ❌ 反例
+```markdown
+## 场景概述
+
+本场景介绍娱乐直播间的实现。用户可以直播,观众可以观看互动。
+功能比较丰富,支持各种业务需求。
+```
+
+为什么这是反例:
+- ❌ "本场景介绍 xxx" = 元描述,无信息量
+- ❌ "比较丰富""各种业务需求" = 模糊词
+- ❌ 无具体业务例子、无边界划分
+- → topic 拿到这种描述,无法判断用户的"直播需求"是该路由到本场景还是「电商直播」
+- → review 直接打回
+
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:场景概述模糊 → topic Step 1.5 路由到错误场景 → 用户拿到不匹配的集成方案
+- **验证手段**:人工 review 三个问题逐条对照;字数 50-200 之间;包含 ≥2 个具体业务例子;包含 ≥1 个边界划分
+- **绕过条件**:无
+
+---
+
+### 章节 2:`## 能力清单` (A) 或 `## 能力分层` (B) [必填]
+
+**slice id 必须与对应的 per-product platform index 一致**。
+
+#### 形态 A:能力清单
+
+##### 1️⃣ 你必须写什么
+列出本场景**全部** slice,每条用一句话说明 UI 上能直接用做按钮 label / 设置项标题的功能描述。
+
+##### 2️⃣ 写作模板
 ```markdown
 ## 能力清单
 
-- `<product>/<slice-id>` —— {一句话功能描述（中文，UI 上能直接用做按钮 label / 设置项标题）}
+- `{product}/{slice-id}` —— {一句话功能描述,UI 上可用做按钮 label}
+- `{product}/{slice-id}` —— {一句话功能描述,UI 上可用做按钮 label}
 - ...
 ```
 
-#### 形态 B：能力分层
+##### 3️⃣ ✅ 正例(摘自 1v1-video-call)
+```markdown
+## 能力清单
+
+- `call/login-auth` —— 用户登录并完成 UserSig 校验
+- `call/outgoing-call` —— 发起 1v1 视频呼叫,展示对方头像与昵称
+- `call/incoming-call` —— 接收来电,显示接听/拒绝按钮
+- `call/in-call-controls` —— 通话中工具栏(静音、切摄像头、挂断)
+- `call/call-end` —— 通话结束页,展示通话时长
+```
+
+为什么这是正例:
+- ✅ 每条都用 UI 可见的语言("接听/拒绝按钮""通话时长"),不用 SDK 术语
+- ✅ slice id 用 backtick 包裹,可被 topic 机械提取
+- ✅ 顺序贴近用户操作流(登录 → 呼叫 → 接听 → 通话 → 结束)
+
+##### 4️⃣ ❌ 反例
+```markdown
+## 能力清单
+
+- `call/login-auth` —— 登录相关
+- `call/outgoing-call` —— 实现呼叫功能
+- 还有几个 slice,具体见 index.yaml
+```
+
+为什么这是反例:
+- ❌ "登录相关""呼叫功能" = 模糊
+- ❌ "见 index.yaml" = 偷懒,topic 拿不到信息
+- ❌ "还有几个" = 不完整,topic 漏装能力
+- → review 直接打回
 
+#### 形态 B:能力分层
+##### 3️⃣ ✅ 正例(摘自 1v1-video-call)
+```markdown
+## 能力清单
+
+- `call/login-auth` —— 用户登录并完成 UserSig 校验
+- `call/outgoing-call` —— 发起 1v1 视频呼叫,展示对方头像与昵称
+- `call/incoming-call` —— 接收来电,显示接听/拒绝按钮
+- `call/in-call-controls` —— 通话中工具栏(静音、切摄像头、挂断)
+- `call/call-end` —— 通话结束页,展示通话时长
+```
+
+为什么这是正例:
+- ✅ 每条都用 UI 可见的语言("接听/拒绝按钮""通话时长"),不用 SDK 术语
+- ✅ slice id 用 backtick 包裹,可被 topic 机械提取
+- ✅ 顺序贴近用户操作流(登录 → 呼叫 → 接听 → 通话 → 结束)
+
+##### 4️⃣ ❌ 反例
+```markdown
+## 能力清单
+
+- `call/login-auth` —— 登录相关
+- `call/outgoing-call` —— 实现呼叫功能
+- 还有几个 slice,具体见 index.yaml
+```
+
+为什么这是反例:
+- ❌ "登录相关""呼叫功能" = 模糊
+- ❌ "见 index.yaml" = 偷懒,topic 拿不到信息
+- ❌ "还有几个" = 不完整,topic 漏装能力
+- → review 直接打回
+
+#### 形态 B:能力分层
+
+##### 1️⃣ 你必须写什么
+按 P0/P1 分层列出 slice。P1 必须标注「推荐默认勾选」字段。
+
+##### 2️⃣ 写作模板
+##### 1️⃣ 你必须写什么
+按 P0/P1 分层列出 slice。P1 必须标注「推荐默认勾选」字段。
+
+##### 2️⃣ 写作模板
 ```markdown
 ## 能力分层
 
-### P0 主链路（必装）
+### P0 主链路(必装)
+### P0 主链路(必装)
 
-- `<product>/<slice-id>` —— {一句话}
+- `{product}/{slice-id}` —— {一句话}
+- `{product}/{slice-id}` —— {一句话}
 - ...
 
-### P1 常见增强（可选）
+### P1 常见增强(可选)
+### P1 常见增强(可选)
 
-- `<product>/<slice-id>` —— {一句话}
-  - 推荐默认勾选：是 / 否
+- `{product}/{slice-id}` —— {一句话}
+  - 推荐默认勾选:是 / 否
+- `{product}/{slice-id}` —— {一句话}
+  - 推荐默认勾选:是 / 否
 - ...
 ```
 
-**P1 字段说明（仅形态 B）**：
+P1 字段说明:
+P1 字段说明:
 
 | 字段 | 含义 | 取值 |
 |---|---|---|
-| `推荐默认勾选` | minimal coverage 时是否仍当作必装；complete 时是否预选 | 是 / 否 |
+| `推荐默认勾选` | minimal coverage 时是否仍当作必装;complete 时是否预选 | 是 / 否 |
+| `推荐默认勾选` | minimal coverage 时是否仍当作必装;complete 时是否预选 | 是 / 否 |
+
+##### 3️⃣ ✅ 正例(摘自 general-conference)
+```markdown
+## 能力分层
+
+### P0 主链路(必装)
 
-### 3. `## 能力展示` (A) 或 `## 能力展示与 coverage 选择` (B)
+- `conference/login-auth` —— 用户登录与身份认证
+- `conference/room-lifecycle` —— 创建/加入/离开会议室
+- `conference/in-room-controls` —— 会议中基础工具栏(静音、视频开关、挂断)
+
+### P1 常见增强(可选)
+
+- `conference/screen-share` —— 屏幕共享
+  - 推荐默认勾选:是
+- `conference/chat` —— 会议中文字聊天
+  - 推荐默认勾选:是
+- `conference/recording` —— 云端录制
+  - 推荐默认勾选:否
+- `conference/beauty-filter` —— 美颜滤镜
+  - 推荐默认勾选:否
+```
+
+为什么这是正例:
+- ✅ P0 是"少一个就开不了会"的最小集
+- ✅ P1 都是"没有也能开会,有了更好"
+- ✅ 高频增强(屏幕共享/聊天)默认勾选,低频(录制/美颜)默认不勾
+
+##### 4️⃣ ❌ 反例
+```markdown
+## 能力分层
+
+### P0
+- `conference/login-auth`
+- `conference/room-lifecycle`
+- `conference/screen-share`   ← ❌ 屏幕共享不是必装,放 P1
+- `conference/beauty-filter`  ← ❌ 美颜更不该在 P0
+
+### P1
+- `conference/recording`
+- `conference/chat`           ← ❌ 没标"推荐默认勾选"
+```
+
+为什么这是反例:
+- ❌ P0 混入了非必装项 → 用户选 minimal 时被装上没要的能力
+- ❌ P1 缺少"推荐默认勾选"字段 → topic 不知道怎么预选
+- → over-integration 投诉根因
+- → review 直接打回
+
+#### 5️⃣ 必填项语义三件套(章节 2)
+
+- **违反后果**:slice id 与 index.yaml 不一致 → topic 找不到 slice 文件 / P0/P1 划分错 → over-integration 或漏装
+- **验证手段**:
+  ```bash
+  # slice id 一致性
+  python scripts/validate_scenario.py {file}
+  # 通过标准:
+  # - 本文件出现的所有 `{product}/{slice-id}` 都在 index.yaml 中存在
+  # - 形态 A:slices 数 ≥ 3
+  # - 形态 B:P0 ≥ 2,P1 ≥ 2,每个 P1 都有"推荐默认勾选"字段
+  ```
+- **绕过条件**:无
+
+---
+
+### 章节 3:`## 能力展示` (A) 或 `## 能力展示与 coverage 选择` (B) [必填]
+##### 3️⃣ ✅ 正例(摘自 general-conference)
+```markdown
+## 能力分层
+
+### P0 主链路(必装)
+
+- `conference/login-auth` —— 用户登录与身份认证
+- `conference/room-lifecycle` —— 创建/加入/离开会议室
+- `conference/in-room-controls` —— 会议中基础工具栏(静音、视频开关、挂断)
+
+### P1 常见增强(可选)
+
+- `conference/screen-share` —— 屏幕共享
+  - 推荐默认勾选:是
+- `conference/chat` —— 会议中文字聊天
+  - 推荐默认勾选:是
+- `conference/recording` —— 云端录制
+  - 推荐默认勾选:否
+- `conference/beauty-filter` —— 美颜滤镜
+  - 推荐默认勾选:否
+```
+
+为什么这是正例:
+- ✅ P0 是"少一个就开不了会"的最小集
+- ✅ P1 都是"没有也能开会,有了更好"
+- ✅ 高频增强(屏幕共享/聊天)默认勾选,低频(录制/美颜)默认不勾
+
+##### 4️⃣ ❌ 反例
+```markdown
+## 能力分层
+
+### P0
+- `conference/login-auth`
+- `conference/room-lifecycle`
+- `conference/screen-share`   ← ❌ 屏幕共享不是必装,放 P1
+- `conference/beauty-filter`  ← ❌ 美颜更不该在 P0
+
+### P1
+- `conference/recording`
+- `conference/chat`           ← ❌ 没标"推荐默认勾选"
+```
+
+为什么这是反例:
+- ❌ P0 混入了非必装项 → 用户选 minimal 时被装上没要的能力
+- ❌ P1 缺少"推荐默认勾选"字段 → topic 不知道怎么预选
+- → over-integration 投诉根因
+- → review 直接打回
+
+#### 5️⃣ 必填项语义三件套(章节 2)
+
+- **违反后果**:slice id 与 index.yaml 不一致 → topic 找不到 slice 文件 / P0/P1 划分错 → over-integration 或漏装
+- **验证手段**:
+  ```bash
+  # slice id 一致性
+  python scripts/validate_scenario.py {file}
+  # 通过标准:
+  # - 本文件出现的所有 `{product}/{slice-id}` 都在 index.yaml 中存在
+  # - 形态 A:slices 数 ≥ 3
+  # - 形态 B:P0 ≥ 2,P1 ≥ 2,每个 P1 都有"推荐默认勾选"字段
+  ```
+- **绕过条件**:无
+
+---
+
+### 章节 3:`## 能力展示` (A) 或 `## 能力展示与 coverage 选择` (B) [必填]
 
 **topic Step 1.5 直接照抄的展示模板**。包含展示文案 + (B 形态特有) AskUserQuestion 选项。
 
-#### 形态 A：能力展示
+#### 形态 A:能力展示
+
+##### 1️⃣ 你必须写什么
+topic 展示给用户的原话。A 形态不向用户提问 coverage,展示完直接进 Step 2。
+#### 形态 A:能力展示
+
+##### 1️⃣ 你必须写什么
+topic 展示给用户的原话。A 形态不向用户提问 coverage,展示完直接进 Step 2。
 
+##### 2️⃣ 写作模板
+##### 2️⃣ 写作模板
 ```markdown
 ## 能力展示
 
 ### 展示文案
 
-我帮你定位到「{场景中文名}」场景，包含以下 {总数} 项能力：
+我帮你定位到「{场景中文名}」场景,包含以下 {总数} 项能力:
+我帮你定位到「{场景中文名}」场景,包含以下 {总数} 项能力:
 
   • {slice 1 中文名} (`{slice id}`)
   • {slice 2 中文名} (`{slice id}`)
@@ -112,29 +516,85 @@ scenario 文件是 **topic skill 的场景剧本**。topic 接到一个场景 id
 接下来开始集成。
 ```
 
-A 形态不向用户提问 coverage，topic 展示完直接进 Step 2。
+##### 3️⃣ ✅ 正例
+```markdown
+## 能力展示
+
+### 展示文案
 
-#### 形态 B：能力展示 + coverage
+我帮你定位到「1v1 视频通话」场景,包含以下 5 项能力:
 
+  • 登录与身份认证 (`call/login-auth`)
+  • 发起呼叫 (`call/outgoing-call`)
+  • 接收来电 (`call/incoming-call`)
+  • 通话中工具栏 (`call/in-call-controls`)
+  • 通话结束 (`call/call-end`)
+
+接下来开始集成。
+```
+
+为什么这是正例:
+- ✅ 展示文案完整可抄,topic 不需要二次加工
+- ✅ 中文名 + slice id 一一对应,且与「能力清单」一致
+
+#### 形态 B:能力展示 + coverage(二选一)
+
+##### 1️⃣ 你必须写什么
+展示文案分 P0/P1,加 AskUserQuestion 选项映射表。
+
+##### 2️⃣ 写作模板
+##### 3️⃣ ✅ 正例
+```markdown
+## 能力展示
+
+### 展示文案
+
+我帮你定位到「1v1 视频通话」场景,包含以下 5 项能力:
+
+  • 登录与身份认证 (`call/login-auth`)
+  • 发起呼叫 (`call/outgoing-call`)
+  • 接收来电 (`call/incoming-call`)
+  • 通话中工具栏 (`call/in-call-controls`)
+  • 通话结束 (`call/call-end`)
+
+接下来开始集成。
+```
+
+为什么这是正例:
+- ✅ 展示文案完整可抄,topic 不需要二次加工
+- ✅ 中文名 + slice id 一一对应,且与「能力清单」一致
+
+#### 形态 B:能力展示 + coverage(二选一)
+
+##### 1️⃣ 你必须写什么
+展示文案分 P0/P1,加 AskUserQuestion 选项映射表。
+
+##### 2️⃣ 写作模板
 ```markdown
 ## 能力展示与 coverage 选择
 
 ### 展示文案
 
-我帮你定位到「{场景中文名}」场景，包含以下能力：
+我帮你定位到「{场景中文名}」场景,包含以下能力:
+我帮你定位到「{场景中文名}」场景,包含以下能力:
 
-📋 主链路（必装，{P0 count} 项）
+📋 主链路(必装,{P0 count} 项)
+📋 主链路(必装,{P0 count} 项)
   • {P0 slice 1 中文名} (`{slice id}`)
-  • {P0 slice 2 中文名} (`{slice id}`)
   ...
 
-➕ 增强能力（可选，{P1 count} 项）
-  • {P1 slice 1 中文名} (`{slice id}`) {如"推荐默认勾选 = 是"，加 ✓}
+➕ 增强能力(可选,{P1 count} 项)
+  • {P1 slice 1 中文名} (`{slice id}`) {推荐默认勾选 = 是 → 加 ✓}
+➕ 增强能力(可选,{P1 count} 项)
+  • {P1 slice 1 中文名} (`{slice id}`) {推荐默认勾选 = 是 → 加 ✓}
   ...
 
-集成哪种？
-1) 主链路（最快，开箱可用基础{场景类型}）
-2) 完整版（含全部 {总数} 项能力，推荐）
+集成哪种?
+1) 主链路(最快,开箱可用基础{场景类型})
+2) 完整版(含全部 {总数} 项能力,推荐)
+集成哪种?
+1) 主链路(最快,开箱可用基础{场景类型})
+2) 完整版(含全部 {总数} 项能力,推荐)
 
 ### AskUserQuestion 选项
 
@@ -144,95 +604,647 @@ A 形态不向用户提问 coverage，topic 展示完直接进 Step 2。
 | 2 | 完整版 | `enhancement_level: complete` |
 ```
 
-**B-多选变体（必装骨架 + 可选模块多选）**：当增强项彼此独立、不应默认全装时,用这种写法替代上面的二选一表。章节里必须包含:
+#### 形态 B-多选变体(必装骨架 + 可选模块多选)
+
+##### 1️⃣ 你必须写什么
+当增强项彼此独立、不应默认全装时,用这种写法替代二选一表。
+#### 形态 B-多选变体(必装骨架 + 可选模块多选)
 
+##### 1️⃣ 你必须写什么
+当增强项彼此独立、不应默认全装时,用这种写法替代二选一表。
+
+##### 2️⃣ 写作模板
+##### 2️⃣ 写作模板
 ```markdown
 ## 能力展示与 coverage 选择
 
 ### 必装骨架(always on,不向用户提问)
-- `<product>/<skeleton-slice>` —— ...
+- `{product}/{skeleton-slice-1}` —— ...
+- `{product}/{skeleton-slice-2}` —— ...
+- `{product}/{skeleton-slice-1}` —— ...
+- `{product}/{skeleton-slice-2}` —— ...
 
 ### 可选模块(多选,默认只勾选命中用户需求的项)
-- `<product>/<optional-slice>` —— ...
+- `{product}/{optional-slice-1}` —— ...
+- `{product}/{optional-slice-2}` —— ...
+- ...
+- `{product}/{optional-slice-1}` —— ...
+- `{product}/{optional-slice-2}` —— ...
+- ...
 
 ### 执行规则(topic 必须遵守)
-1. 预勾选 = 仅命中 `target_features` / 原始 prompt 的可选模块;其余默认不勾。
-2. 展示文案(说明骨架默认装 + 已识别到的增强项)。
-3. AskUserQuestion 多选(超 4 项分组拆问)。**每组必须包含「以上都不需要」选项（value=`none`），放在末尾，作为用户显式拒绝该组所有能力的出口。选中`none`时该组其他选项视为未勾选。**
-4. 写 `confirmed_plan = 必装骨架 + 选中模块`(唯一下游真源)。
-5. 未选中的模块不得进 `confirmed_plan`,也不得在代码里顺手生成。
-6. `enhancement_level` 仅兼容:全选 → complete,否则 → minimal。
+
+1. **预勾选**:仅命中 `target_features` / 原始 prompt 关键词的可选模块;其余默认不勾。
+2. **展示文案**:说明骨架默认装 + 已识别到的增强项。
+3. **AskUserQuestion 多选**:超 4 项分组拆问。**每组必须包含「以上都不需要」选项（value=`none`），放在末尾，作为用户显式拒绝该组所有能力的出口。选中`none`时该组其他选项视为未勾选。**
+4. **写入 session**:`confirmed_plan = 必装骨架 + 选中模块`(唯一下游真源)。
+5. **未选中模块绝不进 `confirmed_plan`**,也不得在代码里顺手生成。
+6. **`enhancement_level` 仅兼容**:全选 → complete;否则 → minimal。
+
+```
+
+##### 3️⃣ ✅ 正例(参考 conference/base/general-conference)
+```markdown
+### 必装骨架(always on)
+- `conference/login-auth` —— 登录认证
+- `conference/room-lifecycle` —— 房间生命周期
+- `conference/in-room-controls` —— 基础工具栏
+
+### 可选模块(多选,默认只勾选命中用户需求的项)
+- `conference/screen-share` —— 屏幕共享
+- `conference/chat` —— 文字聊天
+- `conference/recording` —— 云端录制
+- `conference/beauty-filter` —— 美颜滤镜
+- `conference/scheduled-meeting` —— 会议预约
+
+### 执行规则
+1. 预勾选:仅命中 target_features 中的可选模块。
+   例:用户输入"团队会议要屏幕共享和预约" → 预勾选 screen-share + scheduled-meeting,
+   其余默认不勾。
+2. AskUserQuestion 展示 5 个可选模块,用户可加选/取消。
+3. confirmed_plan = 骨架 3 项 + 用户最终选中的 N 项。
+4. 未选中的(如 beauty-filter)绝不出现在生成代码中。
+```
+
+为什么这是正例:
+- ✅ 明确预勾选规则(关键词命中)
+- ✅ 给了真实的"用户输入 → 预勾选结果"映射
+- ✅ 强调"未选中的绝不出现"——堵死 over-integration
+
+##### 4️⃣ ❌ 反模式
+```markdown
+### 可选模块
+- `conference/screen-share`
+- `conference/beauty-filter`
+- ...
+
+### 执行规则
+- 默认全部安装,用户可以让我去掉不需要的。
+```
+
+为什么这是反例:
+- ❌ "默认全部安装" = over-integration 根因
+- ❌ "让用户去掉" = 把判断责任甩给用户
+- ❌ 没有预勾选规则
+- → 真实事故:某客户做团队会议,被装上美颜组件,投诉"我没要美颜"
+- → review 直接打回
+
+#### 5️⃣ 必填项语义三件套(章节 3)
+
+- **违反后果**:展示文案与能力清单不一致 → topic 展示给用户的与实际集成的不一样;B-多选写成默认全装 → over-integration 投诉
+- **验证手段**:
+  ```bash
+  python scripts/validate_scenario.py {file}
+  # 通过标准:
+  # - 展示文案中的 slice id 与「能力清单/分层」完全一致
+  # - 形态 B:必有 AskUserQuestion 选项表
+  # - B-多选:必有"未选中模块绝不进 confirmed_plan"的明文声明
+  ```
+- **绕过条件**:无
+
+---
+
+### 章节 4:`## 前置条件` [必填]
+
+#### 1️⃣ 你必须写什么
+集成前用户必须做的事(控制台配置、SDK 版本、账号开通、平台权限等)。topic Step 2 展示给用户。
+
+1. **预勾选**:仅命中 `target_features` / 原始 prompt 关键词的可选模块;其余默认不勾。
+2. **展示文案**:说明骨架默认装 + 已识别到的增强项。
+3. **AskUserQuestion 多选**:超 4 项分组拆问。**每组必须包含「以上都不需要」选项（value=`none`），放在末尾，作为用户显式拒绝该组所有能力的出口。选中`none`时该组其他选项视为未勾选。**
+4. **写入 session**:`confirmed_plan = 必装骨架 + 选中模块`(唯一下游真源)。
+5. **未选中模块绝不进 `confirmed_plan`**,也不得在代码里顺手生成。
+6. **`enhancement_level` 仅兼容**:全选 → complete;否则 → minimal。
+
 ```
 
-topic Step 1.5 会识别这种章节并按「执行规则」走,而不是把整张 `slices:` 当默认全集。
+##### 3️⃣ ✅ 正例(参考 conference/base/general-conference)
+```markdown
+### 必装骨架(always on)
+- `conference/login-auth` —— 登录认证
+- `conference/room-lifecycle` —— 房间生命周期
+- `conference/in-room-controls` —— 基础工具栏
 
-### 4. `## 前置条件`
+### 可选模块(多选,默认只勾选命中用户需求的项)
+- `conference/screen-share` —— 屏幕共享
+- `conference/chat` —— 文字聊天
+- `conference/recording` —— 云端录制
+- `conference/beauty-filter` —— 美颜滤镜
+- `conference/scheduled-meeting` —— 会议预约
+
+### 执行规则
+1. 预勾选:仅命中 target_features 中的可选模块。
+   例:用户输入"团队会议要屏幕共享和预约" → 预勾选 screen-share + scheduled-meeting,
+   其余默认不勾。
+2. AskUserQuestion 展示 5 个可选模块,用户可加选/取消。
+3. confirmed_plan = 骨架 3 项 + 用户最终选中的 N 项。
+4. 未选中的(如 beauty-filter)绝不出现在生成代码中。
+```
 
-集成前用户必须做的事（控制台配置、SDK 版本、账号开通、平台权限等）。topic Step 2 展示给用户。
+为什么这是正例:
+- ✅ 明确预勾选规则(关键词命中)
+- ✅ 给了真实的"用户输入 → 预勾选结果"映射
+- ✅ 强调"未选中的绝不出现"——堵死 over-integration
 
+##### 4️⃣ ❌ 反模式
 ```markdown
-- 已开通 TRTC 服务并获取 SDKAppID 和 SecretKey
+### 可选模块
+- `conference/screen-share`
+- `conference/beauty-filter`
+- ...
+
+### 执行规则
+- 默认全部安装,用户可以让我去掉不需要的。
+```
+
+为什么这是反例:
+- ❌ "默认全部安装" = over-integration 根因
+- ❌ "让用户去掉" = 把判断责任甩给用户
+- ❌ 没有预勾选规则
+- → 真实事故:某客户做团队会议,被装上美颜组件,投诉"我没要美颜"
+- → review 直接打回
+
+#### 5️⃣ 必填项语义三件套(章节 3)
+
+- **违反后果**:展示文案与能力清单不一致 → topic 展示给用户的与实际集成的不一样;B-多选写成默认全装 → over-integration 投诉
+- **验证手段**:
+  ```bash
+  python scripts/validate_scenario.py {file}
+  # 通过标准:
+  # - 展示文案中的 slice id 与「能力清单/分层」完全一致
+  # - 形态 B:必有 AskUserQuestion 选项表
+  # - B-多选:必有"未选中模块绝不进 confirmed_plan"的明文声明
+  ```
+- **绕过条件**:无
+
+---
+
+### 章节 4:`## 前置条件` [必填]
+
+#### 1️⃣ 你必须写什么
+集成前用户必须做的事(控制台配置、SDK 版本、账号开通、平台权限等)。topic Step 2 展示给用户。
+
+#### 2️⃣ 写作模板
+#### 2️⃣ 写作模板
+```markdown
+## 前置条件
+
+- 已开通 {产品名} 服务并获取 {SDKAppID / SecretKey / 其他凭证}
+## 前置条件
+
+- 已开通 {产品名} 服务并获取 {SDKAppID / SecretKey / 其他凭证}
 - {平台} SDK 版本 ≥ {version}
 - {权限 / 配置 / 其他}
+- {该场景特有的前置:如套餐版本、白名单、回调域名等}
+- {该场景特有的前置:如套餐版本、白名单、回调域名等}
 ```
 
-### 5. `## 验收 Checklist`
+#### 3️⃣ ✅ 正例(摘自 general-conference)
+```markdown
+## 前置条件
 
-集成完成后用户用来自检"我这套真的跑起来了吗"的清单。topic Step 完成后展示。
+- 已开通 TRTC 服务并获取 SDKAppID 和 SecretKey
+- Web SDK 版本 ≥ 5.4.3(含 RoomKit Vue3 包)
+- HTTPS 域名(摄像头/麦克风权限要求)
+- 浏览器:Chrome ≥ 86 / Safari ≥ 14 / Edge ≥ 86
+- 若使用云端录制 → 需在控制台开通"云录制"套餐(基础版不支持)
+```
+
+为什么这是正例:
+- ✅ 列了控制台、SDK 版本、传输层、浏览器、套餐 5 类前置
+- ✅ 给出具体版本号,不是"较新版本"
+- ✅ 标注了套餐限制(常见踩坑)
 
+#### 4️⃣ ❌ 反例
 ```markdown
-- [ ] 用户能登录并进入会议
+## 前置条件
+
+- 需要 TRTC 账号
+- SDK 版本要够新
+- 浏览器要支持 WebRTC
+```
+
+为什么这是反例:
+- ❌ "够新""支持" = 模糊
+- ❌ 缺套餐、域名、控制台开通信息
+- → 用户照抄会卡在某个未明示的前置上
+
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:前置缺失 → 用户照集成步骤跑下来在某一步突然报错 → 排查 1+ 小时定位到没开套餐 / 域名不是 HTTPS
+- **验证手段**:必须含 ≥4 类前置(控制台、SDK 版本、平台权限/配置、套餐);版本号必须是具体数字
+- **绕过条件**:场景极简(如纯前端 demo)无控制台/套餐要求 → 在 PR 说明
+
+---
+
+### 章节 5:`## 验收 Checklist` [必填]
+
+#### 1️⃣ 你必须写什么
+集成完成后用户用来自检"我这套真的跑起来了吗"的清单。
+**这是 SuperPowers「验证门」机制在 scenario 层的落地**——没跑过 checklist 不允许声称完成。
+
+topic Step 完成后展示。
+
+#### 2️⃣ 写作模板
+```markdown
+## 验收 Checklist
+
+### 基础联通
+- [ ] 用户能登录并进入{场景实体}
+- [ ] {基础设备/连接} 可以正常打开关闭
+
+### 核心流程
+- [ ] {本场景特有的核心动作 1} 能跑通
+- [ ] {本场景特有的核心动作 2} 能跑通
+
+### 异常处理
+- [ ] {失败分支 1} 时 UI 有可见反馈
+- [ ] {失败分支 2} 时不会卡住或静默失败
+
+### 业务行为
+- [ ] {场景特有的业务正确性,如"主播离开时观众看到提示"}
+```
+
+#### 3️⃣ ✅ 正例(摘自 1v1-video-call)
+#### 3️⃣ ✅ 正例(摘自 general-conference)
+```markdown
+## 前置条件
+
+- 已开通 TRTC 服务并获取 SDKAppID 和 SecretKey
+- Web SDK 版本 ≥ 5.4.3(含 RoomKit Vue3 包)
+- HTTPS 域名(摄像头/麦克风权限要求)
+- 浏览器:Chrome ≥ 86 / Safari ≥ 14 / Edge ≥ 86
+- 若使用云端录制 → 需在控制台开通"云录制"套餐(基础版不支持)
+```
+
+为什么这是正例:
+- ✅ 列了控制台、SDK 版本、传输层、浏览器、套餐 5 类前置
+- ✅ 给出具体版本号,不是"较新版本"
+- ✅ 标注了套餐限制(常见踩坑)
+
+#### 4️⃣ ❌ 反例
+```markdown
+## 前置条件
+
+- 需要 TRTC 账号
+- SDK 版本要够新
+- 浏览器要支持 WebRTC
+```
+
+为什么这是反例:
+- ❌ "够新""支持" = 模糊
+- ❌ 缺套餐、域名、控制台开通信息
+- → 用户照抄会卡在某个未明示的前置上
+
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:前置缺失 → 用户照集成步骤跑下来在某一步突然报错 → 排查 1+ 小时定位到没开套餐 / 域名不是 HTTPS
+- **验证手段**:必须含 ≥4 类前置(控制台、SDK 版本、平台权限/配置、套餐);版本号必须是具体数字
+- **绕过条件**:场景极简(如纯前端 demo)无控制台/套餐要求 → 在 PR 说明
+
+---
+
+### 章节 5:`## 验收 Checklist` [必填]
+
+#### 1️⃣ 你必须写什么
+集成完成后用户用来自检"我这套真的跑起来了吗"的清单。
+**这是 SuperPowers「验证门」机制在 scenario 层的落地**——没跑过 checklist 不允许声称完成。
+
+topic Step 完成后展示。
+
+#### 2️⃣ 写作模板
+```markdown
+## 验收 Checklist
+
+### 基础联通
+- [ ] 用户能登录并进入{场景实体}
+- [ ] {基础设备/连接} 可以正常打开关闭
+
+### 核心流程
+- [ ] {本场景特有的核心动作 1} 能跑通
+- [ ] {本场景特有的核心动作 2} 能跑通
+
+### 异常处理
+- [ ] {失败分支 1} 时 UI 有可见反馈
+- [ ] {失败分支 2} 时不会卡住或静默失败
+
+### 业务行为
+- [ ] {场景特有的业务正确性,如"主播离开时观众看到提示"}
+```
+
+#### 3️⃣ ✅ 正例(摘自 1v1-video-call)
+```markdown
+## 验收 Checklist
+
+### 基础联通
+- [ ] 双方都能登录并完成 UserSig 校验
+## 验收 Checklist
+
+### 基础联通
+- [ ] 双方都能登录并完成 UserSig 校验
 - [ ] 摄像头 / 麦克风可以正常打开关闭
-- [ ] {针对本场景的特有验收点}
-- [ ] {...}
+
+### 核心流程
+- [ ] A 呼叫 B,B 端 5 秒内收到来电界面
+- [ ] B 接听后,双方画面互通,延迟 < 500ms
+- [ ] 任一方挂断,另一方在 2 秒内回到通话结束页
+
+### 异常处理
+- [ ] B 不在线时,A 端展示"对方离线",不会一直转圈
+- [ ] B 拒接时,A 端展示"对方拒接",回到主页
+- [ ] 网络断开时,UI 展示"网络异常"提示,不静默失败
+
+### 业务行为
+- [ ] 通话时长正确(误差 < 1 秒)
+- [ ] 双方挂断后,通话记录写入本地存储
+```
+
+为什么这是正例:
+- ✅ 4 类清晰:基础/核心/异常/业务
+- ✅ 每条带可量化标准("5 秒内""< 500ms""< 1 秒")
+- ✅ 异常分支齐全(离线/拒接/断网)
+- ✅ 业务行为不漏(时长、记录)
+
+#### 4️⃣ ❌ 反例
+```markdown
+## 验收 Checklist
+
+- [ ] 功能正常工作
+- [ ] 没有报错
+- [ ] 用户体验良好
+```
+
+为什么这是反例:
+- ❌ "正常工作""体验良好" = 不可验证
+- ❌ 没有量化标准
+- ❌ 没有异常分支
+- → 用户打勾后仍然有大量未发现的问题
+- → review 直接打回
+
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:checklist 模糊 → 用户打勾交付 → 上线后发现关键流程没跑通 → P1 故障
+- **验证手段**:
+  - 4 类各 ≥1 条(基础联通 / 核心流程 / 异常处理 / 业务行为)
+  - 每条必须可量化或可观察(不出现"正常""良好""合适"等模糊词)
+  - `grep -E "正常|良好|合适|可以" {file}` 在 checklist 段落命中 0 次
+- **绕过条件**:无
+
+---
+
+### 章节 6:`## 排障速查` [条件必填:本场景有跨 slice 故障模式]
+
+#### 触发条件
+满足以下任一即必填:
+- 本场景有 ≥3 个高频出错的"跨 slice"症状(单 slice 内的排障已在 slice 文件覆盖)
+- 用户报障 ticket 中本场景占 top 5 之一
+
+不满足 → 整段删除,但建议至少留 1 条作为种子。
+
+#### 1️⃣ 你必须写什么
+**不重复 slice 内的排障**,只列**跨 slice、属于场景级**的问题。
+
+#### 2️⃣ 写作模板
+```markdown
+## 排障速查
+
+| 症状 | 可能原因 | 排查方向 |
+|---|---|---|
+| {用户报的现象} | {跨 slice 的根因} | {要查哪几个 slice / 配置项} |
+| {现象} | {根因} | {方向} |
+| {现象} | {根因} | {方向} |
+```
+
+#### 3️⃣ ✅ 正例(摘自 general-conference)
+```markdown
+## 排障速查
+
+| 症状 | 可能原因 | 排查方向 |
+|---|---|---|
+| 进得去房但是看不到别人画面 | 推流/拉流任一未启动 | 同时检查 `conference/publish` 推流状态 + `conference/subscribe` 拉流订阅 + 视频布局 slice 状态 |
+| 聊天发不出去 | 会控秩序禁聊 / chat slice 未初始化 | 检查 `conference/host-controls` 禁聊状态 + `conference/chat` 初始化 |
+| 屏幕共享黑屏 | 浏览器权限未授 / 抓屏 API 不支持 | 检查浏览器 getDisplayMedia 权限 + HTTPS 域名 |
+| 录制文件找不到 | 录制配置错误 / COS 未配 | 检查 `conference/recording` 配置 + 控制台 COS 绑定 |
+```
+
+为什么这是正例:
+- ✅ 每条都跨 ≥2 个 slice / 配置项
+- ✅ "排查方向" 列引用具体 slice id,topic 可机械跳转
+- ✅ 不重复单 slice 内的排障(slice 内的"摄像头打不开"不会出现在这)
+
+#### 4️⃣ ❌ 反例
+```markdown
+## 排障速查
+
+- 出问题先重启
+- 看错误码
+- 联系技术支持
 ```
 
-### 6. `## 排障速查`（可选但强烈建议）
+为什么这是反例:
+- ❌ 不是表格
+- ❌ "重启""看错误码" = 万能但无效的话术
+- ❌ "联系技术支持" = 兜底没意义
+- → 等于没写
+
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:跨 slice 故障无场景级排障 → 用户报"进房后没画面",AI 只能查单 slice → 漏掉是另一个 slice 的状态问题 → 排查 1+ 小时
+- **验证手段**:必须是表格;每条"排查方向"列引用 ≥2 个 slice id 或配置项;不出现"重启""联系技术支持"等空洞词
+- **绕过条件**:不满足触发条件 → 可省
+
+### 核心流程
+- [ ] A 呼叫 B,B 端 5 秒内收到来电界面
+- [ ] B 接听后,双方画面互通,延迟 < 500ms
+- [ ] 任一方挂断,另一方在 2 秒内回到通话结束页
+
+### 异常处理
+- [ ] B 不在线时,A 端展示"对方离线",不会一直转圈
+- [ ] B 拒接时,A 端展示"对方拒接",回到主页
+- [ ] 网络断开时,UI 展示"网络异常"提示,不静默失败
+
+### 业务行为
+- [ ] 通话时长正确(误差 < 1 秒)
+- [ ] 双方挂断后,通话记录写入本地存储
+```
+
+为什么这是正例:
+- ✅ 4 类清晰:基础/核心/异常/业务
+- ✅ 每条带可量化标准("5 秒内""< 500ms""< 1 秒")
+- ✅ 异常分支齐全(离线/拒接/断网)
+- ✅ 业务行为不漏(时长、记录)
+
+#### 4️⃣ ❌ 反例
+```markdown
+## 验收 Checklist
 
-把场景下高频出错的 3-5 个症状 → 排查路径列出。**不重复 slice 内的排障**，只列**跨 slice、属于场景级的**问题。
+- [ ] 功能正常工作
+- [ ] 没有报错
+- [ ] 用户体验良好
+```
 
-例如通用会议场景：
-- "进得去房但是看不到别人画面" → 检查推流 + 拉流 + 视频布局三个 slice 的状态
-- "聊天发不出去" → 检查会控秩序是否禁聊 + room-chat slice 状态
+为什么这是反例:
+- ❌ "正常工作""体验良好" = 不可验证
+- ❌ 没有量化标准
+- ❌ 没有异常分支
+- → 用户打勾后仍然有大量未发现的问题
+- → review 直接打回
+
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:checklist 模糊 → 用户打勾交付 → 上线后发现关键流程没跑通 → P1 故障
+- **验证手段**:
+  - 4 类各 ≥1 条(基础联通 / 核心流程 / 异常处理 / 业务行为)
+  - 每条必须可量化或可观察(不出现"正常""良好""合适"等模糊词)
+  - `grep -E "正常|良好|合适|可以" {file}` 在 checklist 段落命中 0 次
+- **绕过条件**:无
+
+---
+
+### 章节 6:`## 排障速查` [条件必填:本场景有跨 slice 故障模式]
+
+#### 触发条件
+满足以下任一即必填:
+- 本场景有 ≥3 个高频出错的"跨 slice"症状(单 slice 内的排障已在 slice 文件覆盖)
+- 用户报障 ticket 中本场景占 top 5 之一
+
+不满足 → 整段删除,但建议至少留 1 条作为种子。
+
+#### 1️⃣ 你必须写什么
+**不重复 slice 内的排障**,只列**跨 slice、属于场景级**的问题。
+
+#### 2️⃣ 写作模板
+```markdown
+## 排障速查
+
+| 症状 | 可能原因 | 排查方向 |
+|---|---|---|
+| {用户报的现象} | {跨 slice 的根因} | {要查哪几个 slice / 配置项} |
+| {现象} | {根因} | {方向} |
+| {现象} | {根因} | {方向} |
+```
+
+#### 3️⃣ ✅ 正例(摘自 general-conference)
+```markdown
+## 排障速查
+
+| 症状 | 可能原因 | 排查方向 |
+|---|---|---|
+| 进得去房但是看不到别人画面 | 推流/拉流任一未启动 | 同时检查 `conference/publish` 推流状态 + `conference/subscribe` 拉流订阅 + 视频布局 slice 状态 |
+| 聊天发不出去 | 会控秩序禁聊 / chat slice 未初始化 | 检查 `conference/host-controls` 禁聊状态 + `conference/chat` 初始化 |
+| 屏幕共享黑屏 | 浏览器权限未授 / 抓屏 API 不支持 | 检查浏览器 getDisplayMedia 权限 + HTTPS 域名 |
+| 录制文件找不到 | 录制配置错误 / COS 未配 | 检查 `conference/recording` 配置 + 控制台 COS 绑定 |
+```
+
+为什么这是正例:
+- ✅ 每条都跨 ≥2 个 slice / 配置项
+- ✅ "排查方向" 列引用具体 slice id,topic 可机械跳转
+- ✅ 不重复单 slice 内的排障(slice 内的"摄像头打不开"不会出现在这)
+
+#### 4️⃣ ❌ 反例
+```markdown
+## 排障速查
+
+- 出问题先重启
+- 看错误码
+- 联系技术支持
+```
+
+为什么这是反例:
+- ❌ 不是表格
+- ❌ "重启""看错误码" = 万能但无效的话术
+- ❌ "联系技术支持" = 兜底没意义
+- → 等于没写
+
+#### 5️⃣ 必填项语义三件套
+- **违反后果**:跨 slice 故障无场景级排障 → 用户报"进房后没画面",AI 只能查单 slice → 漏掉是另一个 slice 的状态问题 → 排查 1+ 小时
+- **验证手段**:必须是表格;每条"排查方向"列引用 ≥2 个 slice id 或配置项;不出现"重启""联系技术支持"等空洞词
+- **绕过条件**:不满足触发条件 → 可省
 
 ---
 
 ## 四、可选章节
 
-按需写，不强制：
+按需写,不强制:
+按需写,不强制:
 
-- `## 子场景命中差异` —— 同一场景下不同子形态（如"日常团队会议" vs "培训会议"）的 slice 增减建议
+- `## 子场景命中差异` —— 同一场景下不同子形态(如"日常团队会议" vs "培训会议")的 slice 增减建议
+- `## 子场景命中差异` —— 同一场景下不同子形态(如"日常团队会议" vs "培训会议")的 slice 增减建议
 - `## 跨产品依赖` —— 本场景依赖其他产品 SDK 时的说明
-- `## 设计取舍` —— 为什么这个场景这么拆、和兄弟场景的边界（给后续 scenario 作者看的设计笔记）
+- `## 设计取舍` —— 为什么这个场景这么拆、和兄弟场景的边界(给后续 scenario 作者看的设计笔记)
+- `## 设计取舍` —— 为什么这个场景这么拆、和兄弟场景的边界(给后续 scenario 作者看的设计笔记)
 
 ---
 
 ## 五、字段一致性检查
 
-写完 scenario 文件，检查：
+写完 scenario 文件,**必须**检查以下一致性。**任何一项不一致 = 不可合并**。
+写完 scenario 文件,**必须**检查以下一致性。**任何一项不一致 = 不可合并**。
 
 | 检查项 | 哪两处必须一致 |
 |---|---|
-| slice id 列表 | `index.yaml` `scenarios.<id>.slices` 数组 ↔ 本文件「能力清单」(A) 或 「能力分层」(B) 总和 |
+| slice id 列表 | `per-product platform index` 中对应场景条目的 `slices` 数组 ↔ 本文件「能力清单」(A) 或 「能力分层」(B) 总和 |
 | 中文名 | 「能力清单 / 能力分层」中的 slice 名 ↔ 「能力展示」展示文案中的 slice 名 |
 | `推荐默认勾选 = 是`（仅 B） | 必须在「能力展示」展示文案的 ✓ 标记列表 |
 
-未来可加 `scripts/validate_scenario.py` 自动跑这些检查。
+### 必填项语义三件套(一致性)
+
+- **违反后果**:不一致 → topic 展示给用户的与实际集成的不一样 → 用户拿到的代码与说明书对不上 → 投诉
+- **验证手段**:`python scripts/validate_scenario.py {file}` 退出码 0
+- **绕过条件**:无
+
+---
+
+## 六、Scenario DoD(提交合并前)
+
+研发写完 scenario 后,对照清单逐条打勾。**任何一项未满足 = 未完成,不允许提 PR**。
+
+> ⚠️ 仅打勾不跑命令 = 视为未验证。每条标了"验证命令"的项,必须在 PR 描述粘贴命令输出。
+
+### 通用 DoD
+
+- [ ] 形态选择(A/B)依据「形态判断准则」走过一遍,在 PR 描述写明依据
+- [ ] `场景概述` 含 ≥2 个具体业务例子 + ≥1 个边界划分
+- [ ] `能力清单/能力分层` 中所有 slice id 与 index.yaml 一致
+      验证:`python scripts/validate_scenario.py {file}` 退出码 0
+- [ ] `能力展示` 中的 slice 名与「能力清单/能力分层」一致
+- [ ] `前置条件` 含 ≥4 类(控制台/SDK 版本/权限/套餐)且版本号是具体数字
+- [ ] `验收 Checklist` 4 类各 ≥1 条,无模糊词
+      验证:`grep -E "正常|良好|合适|可以" {file}` 在 checklist 段命中 0 次
+- [ ] 触发"排障速查"条件 → 必有该章节,每条排查方向引用 ≥2 个 slice id
+
+### 形态 A 专属 DoD
+
+- [ ] 所有 slice 都"少一个就不成立"(写在 PR 描述)
+- [ ] `能力展示` 末尾"接下来开始集成"原话保留(topic 路由所需)
+
+### 形态 B 专属 DoD
+
+- [ ] P0 ≥ 2 条,每条都"少一个就开不了机/进不了场"
+- [ ] P1 ≥ 2 条,每条都标注"推荐默认勾选:是/否"
+- [ ] AskUserQuestion 选项表完整(选项 / label / 写入 session 三列)
+
+### 形态 B-多选专属 DoD
+
+- [ ] 必装骨架 ≥ 2 条,可选模块 ≥ 3 条
+- [ ] 「执行规则」段落必含 6 条规则(预勾选/展示/提问/写入/未选不出现/兼容)
+- [ ] 「执行规则」明文出现"未选中模块绝不进 `confirmed_plan`"或等价句
+      验证:`grep -E "未选中.*绝不进|未选中.*不得" {file}` 命中 ≥1
+- [ ] 给出 ≥1 个真实"用户输入 → 预勾选结果"映射示例
 
 ---
 
-## 六、模板骨架
+## 七、模板骨架
 
-### A 形态模板（单一完整能力）
+### A 形态模板(单一完整能力)
+### A 形态模板(单一完整能力)
 
-适合：1v1-video-call、entertainment-live-room 等场景所有 slice 缺一不可的情况。
+适合:1v1-video-call、entertainment-live-room 等场景所有 slice 缺一不可的情况。
+适合:1v1-video-call、entertainment-live-room 等场景所有 slice 缺一不可的情况。
 
 ```markdown
-# {场景中文名}（{scenario-id}）
+# {场景中文名}({scenario-id})
+# {场景中文名}({scenario-id})
 
 ## 场景概述
 
-{2-4 行散文}
+{2-4 行散文,含 ≥2 个具体业务例子 + ≥1 个边界划分}
+{2-4 行散文,含 ≥2 个具体业务例子 + ≥1 个边界划分}
 
 ## 能力清单
 
@@ -244,7 +1256,8 @@ topic Step 1.5 会识别这种章节并按「执行规则」走,而不是把整
 
 ### 展示文案
 
-我帮你定位到「{场景中文名}」场景，包含以下 {总数} 项能力：
+我帮你定位到「{场景中文名}」场景,包含以下 {总数} 项能力:
+我帮你定位到「{场景中文名}」场景,包含以下 {总数} 项能力:
 
   • {slice 1 中文名} (`{slice id}`)
   • {slice 2 中文名} (`{slice id}`)
@@ -254,27 +1267,57 @@ topic Step 1.5 会识别这种章节并按「执行规则」走,而不是把整
 
 ## 前置条件
 
-- {条件 1}
-- {条件 2}
+- 已开通 {产品名} 服务并获取 {凭证}
+- {平台} SDK 版本 ≥ {version}
+- {权限 / 配置}
+- {套餐 / 白名单}
+- 已开通 {产品名} 服务并获取 {凭证}
+- {平台} SDK 版本 ≥ {version}
+- {权限 / 配置}
+- {套餐 / 白名单}
 
 ## 验收 Checklist
 
-- [ ] {验收点 1}
-- [ ] {验收点 2}
+### 基础联通
+- [ ] {联通项 1}
+
+### 核心流程
+- [ ] {核心动作 1}
+
+### 异常处理
+- [ ] {异常分支 1}
+
+### 业务行为
+- [ ] {业务正确性 1}
+### 基础联通
+- [ ] {联通项 1}
+
+### 核心流程
+- [ ] {核心动作 1}
+
+### 异常处理
+- [ ] {异常分支 1}
+
+### 业务行为
+- [ ] {业务正确性 1}
 
 ## 排障速查
 
 | 症状 | 可能原因 | 排查方向 |
 |---|---|---|
-| {症状 1} | {原因} | {slice / 配置项} |
+| {症状 1} | {原因} | {引用 ≥2 个 slice id} |
+| {症状 1} | {原因} | {引用 ≥2 个 slice id} |
 ```
 
-### B 形态模板（主链路 + 可选增强）
+### B 形态模板(主链路 + 可选增强,二选一)
+### B 形态模板(主链路 + 可选增强,二选一)
 
-适合：general-conference、协作工具等有清晰 P0/P1 边界的场景。
+适合:有清晰 P0/P1 边界、增强项可整体作为"完整版"打包的场景。
+适合:有清晰 P0/P1 边界、增强项可整体作为"完整版"打包的场景。
 
 ```markdown
-# {场景中文名}（{scenario-id}）
+# {场景中文名}({scenario-id})
+# {场景中文名}({scenario-id})
 
 ## 场景概述
 
@@ -282,36 +1325,46 @@ topic Step 1.5 会识别这种章节并按「执行规则」走,而不是把整
 
 ## 能力分层
 
-### P0 主链路（必装）
+### P0 主链路(必装)
+### P0 主链路(必装)
 
 - `{product}/{slice-id-1}` —— {一句话}
 - `{product}/{slice-id-2}` —— {一句话}
 
-### P1 常见增强（可选）
+### P1 常见增强(可选)
+### P1 常见增强(可选)
 
 - `{product}/{slice-id-3}` —— {一句话}
-  - 推荐默认勾选：是
+  - 推荐默认勾选:是
+  - 推荐默认勾选:是
 - `{product}/{slice-id-4}` —— {一句话}
-  - 推荐默认勾选：否
+  - 推荐默认勾选:否
+  - 推荐默认勾选:否
 
 ## 能力展示与 coverage 选择
 
 ### 展示文案
 
-我帮你定位到「{场景中文名}」场景，包含以下能力：
+我帮你定位到「{场景中文名}」场景,包含以下能力:
+我帮你定位到「{场景中文名}」场景,包含以下能力:
 
-📋 主链路（必装，{P0 count} 项）
+📋 主链路(必装,{P0 count} 项)
+📋 主链路(必装,{P0 count} 项)
   • {P0 slice 1 中文名} (`{slice id}`)
   • ...
 
-➕ 增强能力（可选，{P1 count} 项）
+➕ 增强能力(可选,{P1 count} 项)
+➕ 增强能力(可选,{P1 count} 项)
   • {P1 slice 1 中文名} (`{slice id}`) ✓
   • {P1 slice 2 中文名} (`{slice id}`)
   • ...
 
-集成哪种？
-1) 主链路（最快，开箱可用基础{场景类型}）
-2) 完整版（含全部 {总数} 项能力，推荐）
+集成哪种?
+1) 主链路(最快,开箱可用基础{场景类型})
+2) 完整版(含全部 {总数} 项能力,推荐)
+集成哪种?
+1) 主链路(最快,开箱可用基础{场景类型})
+2) 完整版(含全部 {总数} 项能力,推荐)
 
 ### AskUserQuestion 选项
 
@@ -322,29 +1375,177 @@ topic Step 1.5 会识别这种章节并按「执行规则」走,而不是把整
 
 ## 前置条件
 
-- {条件 1}
-- {条件 2}
+{同 A 形态}
 
 ## 验收 Checklist
 
-- [ ] {验收点 1}
-- [ ] {验收点 2}
+{同 A 形态,4 类齐全}
 
 ## 排障速查
 
-| 症状 | 可能原因 | 排查方向 |
-|---|---|---|
-| {症状 1} | {原因} | {slice / 配置项} |
+{同 A 形态}
+```
+
+### B-多选模板(必装骨架 + 可选模块多选)
+
+适合:可选项彼此独立、不应默认全装的场景(如通用会议)。
+
+```markdown
+# {场景中文名}({scenario-id})
+
+## 场景概述
+
+{2-4 行散文}
+
+## 能力分层
+
+### 必装骨架(always on)
+
+- `{product}/{skeleton-slice-1}` —— {一句话}
+- `{product}/{skeleton-slice-2}` —— {一句话}
+
+### 可选模块(用户多选)
+
+- `{product}/{optional-slice-1}` —— {一句话}
+- `{product}/{optional-slice-2}` —— {一句话}
+- ...
+
+## 能力展示与 coverage 选择
+
+### 必装骨架(always on,不向用户提问)
+- `{product}/{skeleton-slice-1}` —— ...
+- `{product}/{skeleton-slice-2}` —— ...
+
+### 可选模块(多选,默认只勾选命中用户需求的项)
+- `{product}/{optional-slice-1}` —— ...
+- `{product}/{optional-slice-2}` —— ...
+- ...
+
+### 执行规则(topic 必须遵守)
+
+1. 预勾选 = 仅命中 `target_features` / 原始 prompt 关键词的可选模块;
+   其余默认不勾。
+2. 展示文案(说明骨架默认装 + 已识别到的增强项)。
+3. AskUserQuestion 多选(超 4 项分组拆问)。
+4. 写 `confirmed_plan = 必装骨架 + 选中模块`(唯一下游真源)。
+5. 未选中的模块**绝不进** `confirmed_plan`,代码里也不得顺手生成。
+6. `enhancement_level` 仅兼容:全选 → complete,否则 → minimal。
+
+### 预勾选示例
+- 用户输入 "{真实例 1}" → 预勾选 {模块 A}、{模块 B}
+- 用户输入 "{真实例 2}" → 预勾选 {模块 C}
+
+## 前置条件
+
+{同 A 形态}
+{同 A 形态}
+
+## 验收 Checklist
+
+{同 A 形态,4 类齐全}
+
+## 排障速查
+
+{同 A 形态}
+```
+
+### B-多选模板(必装骨架 + 可选模块多选)
+
+适合:可选项彼此独立、不应默认全装的场景(如通用会议)。
+
+```markdown
+# {场景中文名}({scenario-id})
+
+## 场景概述
+
+{2-4 行散文}
+
+## 能力分层
+
+### 必装骨架(always on)
+
+- `{product}/{skeleton-slice-1}` —— {一句话}
+- `{product}/{skeleton-slice-2}` —— {一句话}
+
+### 可选模块(用户多选)
+
+- `{product}/{optional-slice-1}` —— {一句话}
+- `{product}/{optional-slice-2}` —— {一句话}
+- ...
+
+## 能力展示与 coverage 选择
+
+### 必装骨架(always on,不向用户提问)
+- `{product}/{skeleton-slice-1}` —— ...
+- `{product}/{skeleton-slice-2}` —— ...
+
+### 可选模块(多选,默认只勾选命中用户需求的项)
+- `{product}/{optional-slice-1}` —— ...
+- `{product}/{optional-slice-2}` —— ...
+- ...
+
+### 执行规则(topic 必须遵守)
+
+1. 预勾选 = 仅命中 `target_features` / 原始 prompt 关键词的可选模块;
+   其余默认不勾。
+2. 展示文案(说明骨架默认装 + 已识别到的增强项)。
+3. AskUserQuestion 多选(超 4 项分组拆问)。
+4. 写 `confirmed_plan = 必装骨架 + 选中模块`(唯一下游真源)。
+5. 未选中的模块**绝不进** `confirmed_plan`,代码里也不得顺手生成。
+6. `enhancement_level` 仅兼容:全选 → complete,否则 → minimal。
+
+### 预勾选示例
+- 用户输入 "{真实例 1}" → 预勾选 {模块 A}、{模块 B}
+- 用户输入 "{真实例 2}" → 预勾选 {模块 C}
+
+## 前置条件
+
+{同 A 形态}
+
+## 验收 Checklist
+
+{同 A 形态}
+{同 A 形态}
+
+## 排障速查
+
+{同 A 形态}
+{同 A 形态}
 ```
 
 ---
 
-## 七、对老文件的迁移建议
+## 八、对老文件的迁移建议
+## 八、对老文件的迁移建议
+
+老文件不强制立刻按 spec 重写。建议路径:
+老文件不强制立刻按 spec 重写。建议路径:
+
+1. **`general-conference.md`** → 走 B 形态(B-多选)。原文已有"P0 默认会议骨架 / P1 按需补命中"结构,只需补「能力展示与 coverage 选择(多选变体)」「验收 Checklist」两节,其他内容可移到「设计取舍」可选章节。
+1. **`general-conference.md`** → 走 B 形态(B-多选)。原文已有"P0 默认会议骨架 / P1 按需补命中"结构,只需补「能力展示与 coverage 选择(多选变体)」「验收 Checklist」两节,其他内容可移到「设计取舍」可选章节。
+
+2. **`entertainment-live-room.md`** → 走 A 形态。原文按"主播端流程 / 观众端流程 / 阶段一 / 阶段二"组织,先按 spec 改为「能力清单」「能力展示」+ 验收 Checklist;流程描述可保留为「子场景命中差异」可选章节。
+2. **`entertainment-live-room.md`** → 走 A 形态。原文按"主播端流程 / 观众端流程 / 阶段一 / 阶段二"组织,先按 spec 改为「能力清单」「能力展示」+ 验收 Checklist;流程描述可保留为「子场景命中差异」可选章节。
+
+3. **新建场景** → 直接走 spec,按形态选 A / B / B-多选模板。
 
-老文件不强制立刻按 spec 重写。建议路径：
+---
+
+## 附录:验证脚本清单
+
+本 spec 引用的所有 `python scripts/xxx.py` 必须真实存在,否则三件套是空头支票。
+
+| 脚本 | 作用 |
+|------|------|
+| `validate_scenario.py` | 检查 slice id 一致性 + 形态字段完整 + B-多选明文声明 |
+3. **新建场景** → 直接走 spec,按形态选 A / B / B-多选模板。
+
+---
 
-1. **`general-conference.md`** → 走 B 形态。原文里已有"P0 默认会议骨架 / P1 按需补命中"分层结构，只需补「能力展示与 coverage 选择」「验收 Checklist」两节，其他内容可移到「设计取舍」可选章节。
+## 附录:验证脚本清单
 
-2. **`entertainment-live-room.md`** → 走 A 形态。原文按"主播端流程 / 观众端流程 / 阶段一 / 阶段二"组织，先按 spec 改为「能力清单」「能力展示」+ 验收 Checklist；流程描述可保留为「子场景命中差异」可选章节。
+本 spec 引用的所有 `python scripts/xxx.py` 必须真实存在,否则三件套是空头支票。
 
-3. **新建场景** → 直接走 spec，按形态选 A 或 B 模板。
+| 脚本 | 作用 |
+|------|------|
+| `validate_scenario.py` | 检查 slice id 一致性 + 形态字段完整 + B-多选明文声明 |