product-planning：用备份里的新版④段装回（四段恢复），替换 10-14 删掉的旧版

- 来源：E:/技能备份/product-planning/references/stage-proto-doc/（4 份，与备份逐字一致，md5 逐个核过）。
- 新版与旧版的差别：新版定位改成「解释与记录**现有**原型，不重新规划产品、不重新设计界面」；
  交**两份产物**（原型内嵌说明区 ＋ 独立产品文档 designs/<项目>/产品文档.html）；
  内容按「需求列表 → 用户场景 → 操作流程 → 功能」四块 ＋ 附录「原型页面地址」铺；
  配 R/S/F 编号体系与三份方法论（doc-area-spec / doc-language-spec 322 行 / guided-tour）。
  旧版那套（状态轴、三段必填、逐步骤演示）不再使用。
- 总入口 SKILL.md 同步改回四段：description、「四段结构」表（④子步＝4a 场景盘点 / 4b 说明区 /
  4c 演示引导（可选））、交接口加 ③→④、产物落哪加④行、进入方式加回两行、只读清单加④条、
  执行规则与反面清单（加回两条：③别顺手写说明区/产品文档、④别重新规划产品）；段名链恢复
  「产品 / 功能 / 界面 / 说明」；留痕位改写为④段的完整沿革（10-14 删旧版 → 10-15 装新版）。
- ③段 stage-delivery：「与④段的界」改回（③造物、④解释与记录），两处约束改回「说明区与独立产品文档归④段」，
  反面清单加回一条。①②段的段名对称链与越界条目改回四段。
- 闸门 check_naming.py：STAGES 恢复 stage-proto-doc（圈号数组回 ①②③④、交接口回三条边、
  子步例外列表回 4b/4c），DEPRECATED 去掉④段名（段名与子步名仍在使用）。
- 补入配套留痕：references/_留痕/stage-proto-doc-SKILL-20261014-替换前.md（旧版 SKILL 存档，转 LF）。
- 验收：check_naming.py --ws E:/ProgramData/AIProject/contentm_agent ＝ 通过 2063 / 失败 0 / 提示 27。

product-planning/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: product-planning
-description: 产品规划总入口（唯一入口），三段式调度：① 产品需求 ② 产品功能 ③ 界面交互。三段以 references/stage-* 承载，本文件是总调度与约束。可整段跑也可只调一段。当用户要做产品规划、从零做新产品、只做某一阶段、或不知道从哪开始时调用。
+description: 产品规划总入口（唯一入口），四段式调度：① 产品需求 ② 产品功能 ③ 界面交互 ④ 原型说明文档。四段以 references/stage-* 承载，本文件是总调度与约束。可整段跑也可只调一段。当用户要做产品规划、从零做新产品、只做某一阶段、或不知道从哪开始时调用。
 ---
 
 # 产品规划总入口
@@ -13,27 +13,29 @@ description: 产品规划总入口（唯一入口），三段式调度：① 产
 
 本文件管调度与约束。各段怎么做，写在 `references/stage-*` 各自的文件里。
 
-## 三段结构（可整段跑，也可只调一段）
+## 四段结构（可整段跑，也可只调一段）
 
 | 段 | 回答的问题 | 子步 | 调用 | 产出物 |
 |---|---|---|---|---|
 | **① 产品需求** | 要做的东西凭什么成立：什么问题、为谁、为什么值得做 | 1a 需求文档（grill 压测）/ 1b 竞品分析 / 1c 用户画像 / 1d 产品策略 / 1e 使用场景 | `stage-discovery` | `docs/pm/<项目>/research/*`。其中 1b 交两种体例：`research/1b-竞品分析.md`（汇总对比）＋ `research/1b-独立分析/<竞品名>.md`（独立分析） |
 | **② 产品功能** | 要做哪些功能、什么不做、长成什么骨架 | 2a 产品功能 / 2b 界面布局 | `stage-requirements` | `docs/pm/<项目>/prd/2a-产品功能.md` 与 `prd/2b-界面布局.md`（两份） |
 | **③ 界面交互** | 长什么样、怎么操作 | 3a 视觉规范 / 3b 原型 / 3c GPT参考版 / 3d 审查打磨 | `stage-delivery` | `docs/pm/<项目>/DESIGN.md`、`designs/<项目>/*.html`、`designs/<项目>/3c-GPT参考版.md` |
+| **④ 原型说明文档** | 现有原型怎么用、每条需求落到哪、坏了怎样、怎么核对 | 4a 场景盘点 / 4b 说明区 / 4c 演示引导（可选） | `stage-proto-doc` | 原型内嵌说明区 ＋ 独立产品文档 `designs/<项目>/产品文档.html`（两份共用同一套 R/S/F 编号） |
 
-三段只通过落盘文件耦合。段间交接口如下，这是唯一的契约，越界即失效：
+四段只通过落盘文件耦合。段间交接口如下，这是唯一的契约，越界即失效：
 
 | 交接 | 由谁给 | 给什么 | 给到哪为止 |
 |---|---|---|---|
 | ① → ② | ① | 问题定义、需求澄清决策表（含 grill 压测的 B 节：做成什么样 / 哪些情况不成立 / 状态怎么流转）、取证结论（1b 汇总对比体 ＋ 1b 独立分析体、1c 用户画像）、产品定位、《使用场景》＝用户故事（②段功能的直接推导依据） | 功能清单归②段产出，1a 写到需求与形态为止 |
 | ② → ③ | ② | 功能清单（每条带优先级 ＋ 状态流转）、界面布局（有哪几页 / 每页几个板块 / 板块怎么排 / 跨页关系）、每页主操作、信息承载分档（主屏常驻 / 可点入） | 视觉归③段。骨架必须给全，骨架不给全，③段就一版一个样 |
+| ③ → ④ | ③ | 已跑通的单文件原型 HTML（页面、模块、控件、状态、交互、跳转、反馈＝界面事实的唯一依据） | 说明区与独立产品文档归④段；⛔ ④段不重新规划产品、不重新设计界面 |
 
 > 口径：②段钉骨架，③段做皮肉。两侧逐行对照与用户原话只在②段 `references/stage-requirements/SKILL.md` 的 §②—③ 交接口 定义一次 —— 本入口不复述。要点两条：②段要给全「归②段」列；③段不许增删移动板块，缺板块回②段改。
 
 > ②→③ 最容易搞坏。旧病灶：②段说「必须能读到」，③段读成「必须常驻主屏」，五类信息就全铺一屏成了信息墙。分档表把「读到」明确成「一次点击内可达」，防的就是这句歧义。骨架是灰块（有哪些块、什么顺序），③段给的是视觉与交互实现（排版、点哪有什么反馈、空态、响应式）。两件事各管一维，③段不会退化成照抄。
 
-> 三段各占一个词，互不共用（2026-10-02 定）：产品 / 功能 / 界面。改段名前先对照这张表；两个段名里出现同一个词，边界一定在漂。旧名「调研与方案 / 需求与结构」都含「需求」，③段旧名里的「交付」是三段共有的属性，都属名实不符，已改。
-> 🔴 **④段「原型说明文档」已于 2026-10-14 删除**（用户令：「第4部分完全没法用，都删除」）。原做法是往原型 HTML 里注入说明区注解层（场景 / 流程图 / 三段说明 / 演示引导），实测不好用 ⇒ 整段连方法论一并撤掉。新写法待定（正另行征询）。原件已按改包纪律留备份，备份位置与删段理由见当日 memory 记录。
+> 四段各占一个词，互不共用（2026-10-02 定）：产品 / 功能 / 界面 / 说明。改段名前先对照这张表；两个段名里出现同一个词，边界一定在漂。旧名「调研与方案 / 需求与结构」都含「需求」，③段旧名里的「交付」是三段共有的属性，都属名实不符，已改。
+> 🔴 **④段的沿革（2026-10-14 → 10-15）**：10-14 按用户令删掉**旧版**④段 —— 旧做法是往原型 HTML 注入说明区注解层（状态 → 场景 → 从左到右流程图 → 功能作用/输入边界/异常情况 三段 → 逐步骤演示引导），实测没法用，整段连方法论一并撤掉。10-15 用备份里的**新版**④段装上：改成「解释与记录现有原型」，交**两份产物**（原型内嵌说明区 ＋ 独立产品文档 `designs/<项目>/产品文档.html`），内容按「需求列表 → 用户场景 → 操作流程 → 功能」四块 ＋ 附录铺，配 R/S/F 编号体系与语体规范。判据正文在 `references/stage-proto-doc/`，⛔ 旧版那套（状态轴、三段必填、逐步骤演示）不再使用。
 > ①叫「产品需求」不叫「需求调研」：该段产出 `research/1a-需求文档.md`、`1b-竞品分析.md`、`1c-用户画像.md`，也产出 `1d-产品策略.md`、`1e-使用场景.md`，「调研」二字盖不住后半截。
 > ⭐ 1b 是①段唯一交两种体例的子步：独立分析体 `research/1b-独立分析/<竞品名>.md`（竞品池每一个一份），汇总对比体 `research/1b-竞品分析.md`（恒一份）。职责边界与定案原话见 `references/stage-discovery/references/competitor-analysis.md` §0.4。
 
@@ -51,7 +53,7 @@ description: 产品规划总入口（唯一入口），三段式调度：① 产
 
 ## 项目与路径约定（单一真源）
 
-> 三段全部遵守本节。各段 `SKILL.md` 与 `references/` 里出现 `docs/pm/...` 时，`<项目>` 一律指本节定义的 slug。
+> 四段全部遵守本节。各段 `SKILL.md` 与 `references/` 里出现 `docs/pm/...` 时，`<项目>` 一律指本节定义的 slug。
 
 ### `<项目>` 是什么
 
@@ -75,6 +77,7 @@ description: 产品规划总入口（唯一入口），三段式调度：① 产
 | ① 产品需求 | `docs/pm/<项目>/research/` |
 | ② | `docs/pm/<项目>/prd/` |
 | ③ | `docs/pm/<项目>/DESIGN.md`、`designs/<项目>/*.html`、`designs/<项目>/3c-GPT参考版.md` |
+| ④ | 原型内嵌说明区（写进 `designs/<项目>/*.html` 自身）＋ 独立产品文档 `designs/<项目>/产品文档.html` |
 
 ### 文档的两态：当前版与过期版
 
@@ -142,16 +145,18 @@ DESIGN.md 说明：`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
 
 | 你说什么 | 模式 | 从哪开始 |
 |---|---|---|
-| 「规划 XX」「从零做 XX」 | 全流程（自动处理） | `stage-discovery` → `stage-requirements` → `stage-delivery`，一路跑完，段间不停下来问（含①段末） |
-| 「先确认方案」「跑完方案停下等我」「规划 XX，先给方案」 | 方案确认 | 同一套三段，唯一差别是①段末停下等你确认方案，确认后才进②③ |
-| 「只做产品需求」「只做产品功能」「只做界面交互」 | 单段 | 只调对应那一个 stage skill，不展开其他段 |
+| 「规划 XX」「从零做 XX」 | 全流程（自动处理） | `stage-discovery` → `stage-requirements` → `stage-delivery` → `stage-proto-doc`，一路跑完，段间不停下来问（含①段末） |
+| 「先确认方案」「跑完方案停下等我」「规划 XX，先给方案」 | 方案确认 | 同一套四段，唯一差别是①段末停下等你确认方案，确认后才进②③④ |
+| 「只做产品需求」「只做产品功能」「只做界面交互」「只做原型说明文档」 | 单段 | 只调对应那一个 stage skill，不展开其他段 |
 | 已有②段，要出原型 | 单段 | 直接调 `stage-delivery`，从它的 3a 起 |
+| 已有原型，要补说明 | 单段 | 直接调 `stage-proto-doc`，从它的 4a 起 |
 | 只问某个单点 | 单段 | 不跑任何段，在对应 stage skill 内点名子步，或直接说要看哪份方法论 |
 
-「只调一段」成立的原因：三段之间只通过落盘文件耦合，没有隐式状态。
+「只调一段」成立的原因：四段之间只通过落盘文件耦合，没有隐式状态。
 
 - ②只读 `docs/pm/<项目>/research/*`；缺失时标注 `【假设】`继续，不催促回补①
 - ③只读 `docs/pm/<项目>/prd/*`；缺失时同样标 `【假设】`继续
+- ④只读 `designs/<项目>/*.html`（界面事实的唯一依据），另按需读 `docs/pm/<项目>/prd/*` 与 `research/1a-需求文档.md` 定业务意图；缺失时标 `【假设】`继续，并在段末偏离单里写明
 
 ## 执行规则
 
@@ -160,7 +165,7 @@ DESIGN.md 说明：`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
 | 模式 | 段之间 | 段之内 |
 |---|---|---|
 | 全流程（自动处理） | 一路跑完，段间不停下来问（含①段末）。每段结束按「标准收尾格式」输出一段报告，输出完即刻进下一段 | 子步之间不反问，做完直接进下一个子步 |
-| 方案确认 | 与全流程完全相同，只有一处不同：①段末停下等你确认方案；确认后②③一路跑完、段间不停 | 同上 |
+| 方案确认 | 与全流程完全相同，只有一处不同：①段末停下等你确认方案；确认后②③④一路跑完、段间不停 | 同上 |
 | 单段 | 不涉及 | 不越界，不催促回补前段 |
 
 这两条是全流程模式下的两个独立分支，不要混：全流程（自动处理）没有①段末的强制停；「停下等确认方案」只在「方案确认」模式下发生。二选一由用户定（界面里点【生成原型和文档】时选「自动处理」或「先确认方案」，或在会话里直接说明）；用户没明说时按自动处理走，不要在自动处理模式下自作主张停下来问。
@@ -235,16 +240,18 @@ DESIGN.md 说明：`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
 - 只跑一次 `grill-me`：①没定义需求就去取证，或②拿①段的需求定义代替功能压测直接写②段
 - 把自动补全当默认动作：用户没说话就替用户拍板，还没标 `【假设】`、没进待复核清单
 - 手写 Mermaid 代替 diagram-design，手写 token 表代替 DESIGN.md
-- 绕过三段自己手搓，或重写它们的内容（该调 `stage-*` 就调）
+- 绕过四段自己手搓，或重写它们的内容（该调 `stage-*` 就调）
 - 把供给件的内部路径按本 skill 目录去拼，或改它们的正文 —— 供给件指③段自带的 `oil-ui-pro`，以及 §供给 各档落在 `assets/` 下的件（它们是随③段携带的供给件，改动只写 `stage-delivery` 自己的 `SKILL.md` / `references/`；默认档与可选档平行，不缝成一条流水线，也不把 `oil-ui-pro` 的评分循环当成本段 Gate 的替代）
 - 猜 `<项目>`：定不出来还硬写，把产物落到别的项目目录下
 - 把 `DESIGN.md` 写到仓库根：多项目会互相覆盖
 - 段间停下来问「要不要继续」：全流程（自动处理）模式下直接进下一段，只在段末输出报告
-- 把两种模式混用：在自动处理模式下自作主张停下问方案，或在「方案确认」模式下确认前就开跑②③
+- 把两种模式混用：在自动处理模式下自作主张停下问方案，或在「方案确认」模式下确认前就开跑②③④
 - 在「方案确认」模式下把①段的方案当成已确认就往下跑：该模式下①段末必须停下等用户确认（含「不做什么」）
-- 下游擅自裁剪上游已拍板项：②③发现要砍①段或决策表里已拍板的东西时，不许自行裁掉或改口径，必须列成「与已定决策的差异」交用户显式确认
-- 把模式当成段：模式是「要不要在①段末停」的开关，不是第四个段，别为它单独造段或造产物
+- 下游擅自裁剪上游已拍板项：②③④发现要砍①段或决策表里已拍板的东西时，不许自行裁掉或改口径，必须列成「与已定决策的差异」交用户显式确认
+- 把模式当成段：模式是「要不要在①段末停」的开关，不是第五个段，别为它单独造段或造产物
 - 跑了却不说：没声明当前段 / 子步与依据文件，或偏离了被调 skill 的主流程却不声明、不记偏离单（应为：开工先声明、每个子步再声明、偏离当场声明）
+- 让③段顺手把说明区或产品文档写了（那是第④段 `stage-proto-doc` 的活）
+- ④段里重新规划产品、重新设计界面，或写原型上没有的页面 / 功能 / 业务规则（④段只解释与记录**现有**原型）
 - 问外部模型时堆砌背景：把过程留痕、废弃做法、内部约束清单整段贴进去（应按「征询外部模型（GPT）的提问口径」只给关键背景 ＋ 明确问题）
 
 ## 改名 / 改供给后的自检
@@ -253,7 +260,7 @@ DESIGN.md 说明：`@google/design.md` 提供 `lint` / `diff` / `export` / `spec
 python scripts/check_naming.py --ws <工作区>
 ```
 
-它查三段段名与子步名在「总入口 ↔ 各段 `SKILL.md` ↔ 各段 `references/`」之间有没有漂，包括 H1 与子步表是否一致、总入口子步列有没有漏项、runbook 必读表有没有引用已移除的资产、两份副本是否一致。纯静态比对，不需要渲染，不需要外部依赖。
+它查四段段名与子步名在「总入口 ↔ 各段 `SKILL.md` ↔ 各段 `references/`」之间有没有漂，包括 H1 与子步表是否一致、总入口子步列有没有漏项、runbook 必读表有没有引用已移除的资产、两份副本是否一致。纯静态比对，不需要渲染，不需要外部依赖。
 
 为什么必须有它：实测当天漏过两次，当时没有任何门禁会报错。
 
@@ -261,7 +268,7 @@ python scripts/check_naming.py --ws <工作区>
 
 第二次（2026-10-06）：②段收窄为「只细化功能」（7 份产出变 1 份）后，各段 `SKILL.md` 都改了，但总入口的三处仍写着旧结构——四段表的②段子步列仍是「2a 功能定义与压测 / 2b 功能流转 / 2c 功能图示」，四段表的①段子步列「1c 产品定位与商业设计」未随段内改名（段内已改称「产品定位与场景」），正文仍写「①与②各跑一次 `grill-me`」并指向两份同名文档，实际全场只有①段一份。闸门当场报 6 个 FAIL，根因是「改了承载段、忘了总入口」。
 
-由此立一条硬纪律，与「换供给不能只改承载段」同型：凡改子步结构 / 段内产出清单 / 段间交接口，必须连带改总入口 `product-planning/SKILL.md` 的「三段结构」表与「交接口」表，不改就是半改状态。
+由此立一条硬纪律，与「换供给不能只改承载段」同型：凡改子步结构 / 段内产出清单 / 段间交接口，必须连带改总入口 `product-planning/SKILL.md` 的「四段结构」表与「交接口」表，不改就是半改状态。
 
 改了段名 / 子步名 / 判据供给源之后必须跑一次，并把结果记进当日 memory。改完不校验，下次读契约的人拿到的是错的配方。