product-planning：修掉④段改六节后遗留的 5 处内部矛盾（用户选 A 方案）

改成六节后，④段包内还有旧口径没跟上，逐处修掉： 1. ④段 SKILL.md「定位」节：删掉「第一层轴默认按用户路径分段…也可按原型实际状态分段」，改为「两份产物都按六节组织、骨架与模板同构，⛔ 不按状态轴分段、也不把界面状态当文档层级」。 2. ④段 4a 子步：产出由「第一层轴 × 使用场景清单＋需求编号」改为「页面清单 P ＋场景清单 S ＋功能清单 F ＋二级功能 J，编号先占好、各自唯一并按展示顺序通排」。 3. 🔴 `references/doc-area-spec.md` 整份按六节重写（原 76 行讲的是旧版「第一层轴 → 场景 → 横向流程图 → 三段说明：功能作用/输入边界/异常情况」，正是主 skill 沿革条已明令停用的那套）。新版：六节怎么落进原型／场景怎么写／横向流程图规则／每项功能的四项要求（做什么·入口在哪· 输入边界·异常与恢复）／文案红线／自查九条。原文件里有价值的流程图表格规则与文案红线四条保留。 4. `references/doc-language-spec.md` 开头：文档骨架由旧四块改为六节。 5. `funcOnly` 补定义：在原型上点不出结果的场景标 funcOnly（只写进功能清单、不画流程），并在第六节的待确认表里写明为什么点不出来；④段完成标准与 doc-area-spec 自查各一处。 - 验收：grep「第一层轴／三段是固定骨架／需求编号／需求列表／四块」在④段内残留 0（_留痕除外）； check_naming.py --ws E:/ProgramData/AIProject/contentm_agent ＝通过 225 / 失败 0 / 提示 27；工作区 CRLF 文件数 0（新建的 doc-area-spec.md 已转 LF）。
2026-10-15 22:05:34 +08:00
1 parent 5afeb6b78a
commit f2d07b47ad
@@ -10,7 +10,7 @@ description: 产品规划第④段，原型说明文档。在③段已跑通的
 - 本段解释和记录**现有**原型：不重新规划产品，不重新设计界面。
 - 交付两份产物：原型内嵌说明区、可独立发送的产品文档。两份共用同一套编号、场景、流程与功能定义。
 - 原型是界面行为的核对依据；①段的决策表与②段的功能清单是业务意图的补充依据。
- **第一层轴**默认按用户路径分段（例：定依据 → 交待素材 → 出稿 → 只修局部 → 交付）；也可以按③段原型的实际状态分段，**状态名一律以原型为准**，原型里有几个状态就写几个。
+- 两份产物都按**六节**组织（页面结构／功能清单／使用场景／操作流程／跨页与界面状态／待确认与偏离），骨架与 `assets/产品文档模板.html` 同构；⛔ 不按状态轴分段，也不把原型的界面状态当成文档的层级（界面状态只在第五节里写）。
 - 说明区是注解层，不是产品功能。交付时明说，免得让人以为产品里真有一个说明页。

 ## 输入
@@ -29,7 +29,7 @@ description: 产品规划第④段，原型说明文档。在③段已跑通的

 ## 4a 场景盘点（必做，最先）

-读 `references/doc-area-spec.md`。产出：第一层轴 × 使用场景清单，并给每条场景占好关联的需求编号。
+读 `references/doc-area-spec.md`。产出：页面清单（`P`）＋ 使用场景清单（`S`）＋ 功能清单（`F`）＋ 二级功能（`J`），编号先占好、各自全篇唯一并按展示顺序通排。

 ## 4b 说明区（两份产物）

@@ -139,7 +139,7 @@ description: 产品规划第④段，原型说明文档。在③段已跑通的
 - 独立产品文档含规定的六节，顺序固定，双击能开（起手用 `assets/产品文档模板.html`）。
 - 原型内嵌说明区能在原型里直接找到并读到。
 - 每条使用场景有唯一编号 `S00x`，并带前提、目标、原型位置。
- 每条场景至少一条横向流程，每条 2–6 步且能在原型中逐项核对；拿不到结果的场景标 funcOnly，只喂功能层。
+- 每条场景至少一条横向流程，每条 2–6 步且能在原型中逐项核对；在原型上点不出结果的场景标 `funcOnly`（只写进功能清单、不画流程），并在第六节的待确认表里写明为什么点不出来。
 - 每项功能的 做什么／入口在哪／输入边界／异常与恢复 都填了（编号 `F00x`）；二级功能标出对应的 `F00x`。
 - 引用的编号都存在，页面／场景／功能／二级功能四类各自唯一且按展示顺序通排。
 - 两份产物没有互相矛盾的描述。
@@ -1,6 +1,7 @@
 # 原型说明区规范

 > 本文件是 `stage-proto-doc` 的方法论文档，由模型按需加载，没有斜杠命令。
+> 骨架与 `assets/产品文档模板.html` 同构 —— 说明区就是独立产品文档的六节，嵌进原型对应位置。两份产物共用同一套编号、场景、流程与功能定义。

 ## 定位

@@ -8,55 +9,48 @@

 > 站在这个界面上，我这一步在干什么、我能输入什么、什么情况下它不给好脸色。

-所以它必须贴在原型对应位置的下方，随当前所在的那一段（或状态）标出。抽出来写一份独立文档，读者就得自己脑补对应关系。
+所以它贴在原型对应位置的下方，随当前所在的页面一起变。抽出来单独写一份，读者就得自己脑补对应关系。

-## 层级
+## 六节怎么落进原型

-```
-第一层轴（默认＝用户路径段；也可按③段原型的实际状态。
-        状态名以原型为准，⛔ 别硬套「正常态 / 加载中 / 空态 / 加载失败」）
-└── 使用场景（人要完成的一件事，可点开）
-    ├── 场景引言（一句话：什么前提下、要达成什么）
-    ├── 从左到右的流程图（序号节点 + 箭头，横向可滚动）
-    └── 步骤说明（点某一步 → 在流程图下方出三段）
-        ├── 功能作用
-        ├── 输入边界
-        └── 异常情况
-```
-
-四层各管一段：状态说"界面此刻处于什么处境"，场景说"人在这个处境下想干成什么"，流程说"这件事分几步走"，步骤说明说"这一步的职责与边界"。少任何一层，读者都会拿别层的信息去补，然后补错。
+- **一、页面结构**：页面结构图放原型首页顶部，图上标出各页面与其下的功能编号（页面 `P00x`／功能 `F00x`）。
+- **二、功能清单**：表格贴在对应功能区下方 —— 列：编号／页面／层级／功能区／功能（`F00x` ＋ 名称）／功能做什么／租户／待开发；二级功能另起一张表（`J00x`／二级功能项／产出什么／对应页面功能）。重点功能在功能名、说明、租户三处同时标红。
+- **三、使用场景**：每个场景一段，带前提／目标／原型位置（写到「页面 → 模块 → 控件或状态」，能在原型上点到）。
+- **四、操作流程**：每个场景一条横向流程图，规则见下节。
+- **五、跨页与界面状态**：写跨页跳转与数据传递，以及各界面状态（空／加载／失败／禁用等）怎么触发、呈现什么。
+- **六、待确认事项与偏离单**：待确认带三字段（复核人／复核时机／结论落点），偏离写清偏离了什么／原因／影响面。

 ## 场景怎么写

 - 粒度是"人要完成的一件事"，不是一个按钮。"提交驳回"不算场景，"驳回一条片段并完成失败模式归类"才算。
- 一个状态下的场景数控制在 2–4 个。1 个说明不了分支，5 个以上就该拆状态。
+- 一个页面下的场景数控制在 2–4 个。1 个说明不了分支，5 个以上就该拆页面或拆功能区。
 - 顺序按发生频率排，不按界面从上到下排。
- 引言一句话写清前提。例："预审排队、执行中或失败时人工仍可决策，但必须清楚自己在无依据的情况下决策。"
+- 前提一句话写清。例："预审排队、执行中或失败时人工仍可决策，但必须清楚自己在无依据的情况下决策。"

-## 从左到右流程图
+## 横向流程图

 | 规则 | 说明 |
 |---|---|
 | 形态 | 横向 `ol`，每项 = 序号圆点 + 步骤名，项间一个 `→` 箭头 |
-| 溢出 | 横向滚动，不换行——换行会读成两条并行流程 |
-| 交互 | 点步骤 → 流程图下方出说明；再点收起；同级只选中一个 |
+| 每步内容 | 写清 页面／功能／操作／完成判据，「操作」行用强调色 |
+| 溢出 | 横向滚动，不换行 —— 换行会读成两条并行流程 |
+| 步数 | 2–6 步：超过 6 步说明这个场景该拆，1 步说明它还不算流程 |
+| 交互 | 点步骤 → 下方出这一步的四项说明；再点收起；同级只选中一个 |
 | 键盘 | 步骤是 `button`；`aria-current` 标当前项；说明区 `role="region"` 带 `aria-controls` |
 | 箭头 | `aria-hidden`，它只是视觉连接符，不进朗读 |

-步数控制在 2–6 步：超过 6 步说明这个场景该拆，1 步说明它还不算流程。
+## 每项功能的四项要求

-## 步骤说明：三段
-
-三段是固定骨架，不改名、不合并、不省段。
-
-| 段 | 回答的问题 | 合格判据 | 不合格示例 |
+| 项 | 回答的问题 | 合格判据 | 不合格示例 |
 |---|---|---|---|
-| 功能作用 | 这一步做什么、给谁看、落笔后产生什么 | 换一个组件这句话就不成立 | "展示相关信息，提升审核效率" |
+| 做什么 | 这一步做什么、给谁看、落笔后产生什么 | 换一个组件这句话就不成立 | "展示相关信息，提升审核效率" |
+| 入口在哪 | 可定位的页面与控件 | 能在原型上点到 | "相关入口" |
 | 输入边界 | 取值域 / 上限 / 前置条件 / 必填与选填 | 说得出"什么不被接受"或"最多几条" | "支持筛选" |
-| 异常情况 | 失败 / 空 / 禁用 / 重复提交 / 恢复路径 / 文案红线 | 至少一种"坏了怎么办"，且给出出路 | "暂不支持" |
+| 异常与恢复 | 失败 / 空 / 禁用 / 重复提交 / 恢复路径 / 文案红线 | 至少一种"坏了怎么办"，且给出出路 | "暂不支持" |

 写输入边界，常见切入点：数量上限、字数或时长范围、哪些状态才可用、必填项有哪些、一次作用于一条还是全部。
-写异常情况，常见切入点：加载中能不能点、失败了怎么重试、重复提交怎么挡、空的时候显示什么、禁用要不要给原因、文案不能写成什么。
+
+写异常与恢复，常见切入点：加载中能不能点、失败了怎么重试、重复提交怎么挡、空的时候显示什么、禁用要不要给原因、文案不能写成什么。

 ### 文案红线

@@ -67,9 +61,12 @@

 ## 自查（逐条打勾）

- [ ] 第一层轴覆盖完整（用户路径的每一段、或原型实际有的每个状态都有场景），缺的写明原因
- [ ] 第一层轴的每一段 1–4 个场景，每个场景 2–6 步
- [ ] 每步三段齐全，且各自能通过上面的合格判据
+- [ ] 六节都落到原型对应位置，顺序与模板一致
+- [ ] 页面 `P`／场景 `S`／功能 `F`／二级功能 `J` 各自唯一且按展示顺序通排
+- [ ] 每个场景 2–6 步，每步写清页面／功能／操作／完成判据
+- [ ] 每项功能的四项都填了，且各自能通过上面的合格判据
+- [ ] 重点功能在功能名、说明、租户三处同时标红
 - [ ] 全文没有"通过 / 已认可"这类把机器结论说成人审的词
 - [ ] 每个禁用态都给了原因，每个异常态都给了恢复路径
 - [ ] 说明区文案与②段术语逐词一致
+- [ ] 点不出结果的场景已标 `funcOnly`，并在第六节写明为什么点不出来
@@ -2,7 +2,7 @@

 > 来源：ChatGPT 网页版（2026-10-14，会话 `6acf7fc1-8d10-83e8-b328-8e885f5efb8c`）。
 > 用法：写④段的两份产物时逐句过一遍；第五节自检清单任一项不通过就改。
-> 它管**语言**；文档骨架（需求列表／用户场景／操作流程／功能）见上一级 `SKILL.md`。
+> 它管**语言**；文档骨架（六节：页面结构／功能清单／使用场景／操作流程／跨页与界面状态／待确认与偏离）见上一级 `SKILL.md`。

 ---