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。
This commit is contained in:
1 parent
956382944d
commit
f64a172b5a
10 files changed
+803
-41
No files matched your search
@@ -0,0 +1,86 @@
|
||||
---
|
||||
name: stage-proto-doc
|
||||
description: 产品规划第④段,原型说明文档。在已交付的原型 HTML 上补说明区:第一层轴默认按用户路径分段(也可按③段原型的实际状态,状态名一律以原型为准),每段下按「使用场景 → 从左到右流程图 → 步骤说明(功能作用 / 输入边界 / 异常情况)」铺开,并给每条流程配逐步骤的演示引导。当用户要给原型加功能说明区、写原型说明文档、做操作指引演示,或说"只做原型说明文档"时调用。
|
||||
---
|
||||
|
||||
# ④ 原型说明文档
|
||||
|
||||
回答"第一层轴怎么分段、每段有哪些场景、每个场景怎么走、每一步到底做什么、边界在哪、坏了会怎样"。
|
||||
|
||||
产出长在原型 HTML 自身(`designs/<项目>/*.html`),不额外落 md,免得两处维护、说法对不上。
|
||||
|
||||
顺序 4a → 4b → 4c。说明区先齐,再挂演示引导。
|
||||
|
||||
> 表格「读」列是该方法论文档,相对路径的基准是本 skill 目录。执行子步前先读它。
|
||||
|
||||
## 输入
|
||||
|
||||
| 来自 | 读什么 | 用来定什么 |
|
||||
|---|---|---|
|
||||
| ③ | `designs/<项目>/*.html` | 要挂说明区的原型本体;状态数与状态名以它为准 |
|
||||
| ② | `docs/pm/<项目>/prd/2a-产品功能.md` · `docs/pm/<项目>/prd/2b-界面布局.md` | 术语口径、状态流转、异常路径、页面骨架 |
|
||||
| ① | `docs/pm/<项目>/research/1d-产品策略.md` | "不做什么"的边界,说明区不得写出范围外的能力 |
|
||||
|
||||
上游缺失时标 `【假设】`继续,不强制回补。
|
||||
|
||||
## 4a 场景盘点
|
||||
|
||||
| 子步 | 读 | 产出 |
|
||||
|---|---|---|
|
||||
| 场景盘点(必做,最先) | `references/doc-area-spec.md` | 第一层轴 × 使用场景清单 |
|
||||
|
||||
**第一层轴怎么定**:默认按**用户路径**编排 —— 用户从进来到交付要走过的几段(例:定先决条件 → 交待素材 → 出稿 → 只修局部 → 交付)。
|
||||
**界面状态数与状态名一律以③段原型的实际为准**,⛔ 不许硬套「正常态 / 加载中 / 空态 / 加载失败」四态;原型里有几个状态就盘几个,
|
||||
状态降级成场景上的一枚徽标即可(同一场景只属于一段)。无论用哪种轴,都不许只写正常路径。
|
||||
场景粒度是"人要完成的一件事",不是"一个按钮"。典型一条:拿到一批数据 → 判一条 → 遇到没跑完的怎么办 → 批量的影响范围 → 筛不到东西时。
|
||||
|
||||
## 4b 说明区
|
||||
|
||||
读 `references/doc-area-spec.md`,按它给的层级与交互铺:
|
||||
|
||||
1. 说明区挂在原型对应位置的下方,随当前所在的那一段(或状态)一起变
|
||||
2. 每个场景一条:可点开,点开后是该场景的从左到右流程图(序号节点 + 箭头)
|
||||
3. 点流程里的某一步,在流程图下方出该步说明,固定三段:功能作用 / 输入边界 / 异常情况
|
||||
4. 同级单开:一次只展开一个场景、一次只选中一个步骤;再点已选中的步骤即收起
|
||||
|
||||
三段缺一不可,且必须是对着原型实测过的事实,不是套话:
|
||||
|
||||
| 段 | 写什么 | 判定标准(可核对) |
|
||||
|---|---|---|
|
||||
| 功能作用 | 这个组件做什么、给谁看、落笔后产生什么 | 换一个组件,这句话就不成立 |
|
||||
| 输入边界 | 取值域 / 上限 / 前置条件 / 可选与必填 | 能说出"什么不被接受"或"最多几条" |
|
||||
| 异常情况 | 失败 / 空 / 禁用 / 重复提交 / 文案红线 | 至少覆盖一种"坏了怎么办",且给出恢复路径 |
|
||||
|
||||
## 4c 演示引导
|
||||
|
||||
读 `references/guided-tour.md`,给每条流程挂"演示"按钮:
|
||||
|
||||
1. 每个步骤补三样数据:`target`(要高亮的选择器)、`setup`(这一步的前置条件)、`hint`(操作指引,与功能说明 `desc` 分开写)
|
||||
2. 演示按 `上一步 / 下一步 / 完成` 逐步骤推进,气泡给"第 N / M 步"
|
||||
3. 纯概念步骤不给 target,不参与演示,按钮置灰并写明原因
|
||||
|
||||
## 硬约束
|
||||
|
||||
- 说明区是非产品功能,它是原型的自解释注解层。交付时要明说,别让人误以为产品里真有一个说明页。
|
||||
- 只有原型上有的事实才许写。每一段说明都要能在原型里点到对应元素;写不出 `target` 的步骤,要么承认是概念步骤,要么回去改原型。
|
||||
- 不得把自动结论表述为人工认可(红线,本项目实测抓过):机器判定只能说"进入队列 / 待人工逐条查看",不许写成"通过 / 已认可"。
|
||||
- 文案口径跟②段走。同一个概念在说明区与②段里必须同名,冲突时改说明区。
|
||||
- 4c 交付前必须浏览器实测,逐步骤真点一遍,走完全流程再退出。未跑实测不得报完成。
|
||||
- 段内子步之间不反问,做完直接进下一个子步;**停线规则**见 `product-planning` 的「执行规则」,⛔ 本段不复述。
|
||||
- `<项目>` 按 `product-planning` 的「项目与路径约定」定;定不出来就停下问用户,不许猜。
|
||||
|
||||
## 完成标准
|
||||
|
||||
- 原型的每个状态都有场景,四态齐备(缺哪个要写明为什么)
|
||||
- 每个场景有从左到右流程图,每个步骤都有 `功能作用 / 输入边界 / 异常情况` 三段且非空
|
||||
- 演示引导能从第一步走到完成,退出后界面回到演示前(含筛选、抽屉)
|
||||
- 有实测回报(走过的步骤数、失败项、控制台报错原文)
|
||||
|
||||
## 反面清单
|
||||
|
||||
- 只写正常路径,跳过加载 / 空 / 错误三个状态的说明
|
||||
- 三段说明写成语义重复的三句话,或整段是"该功能可以提升效率"这类空话
|
||||
- 把演示引导做成遮罩弹窗,挡住它要教人点的那个东西
|
||||
- 演示中途改动了用户的筛选 / 抽屉,退出后不还原
|
||||
- 概念步骤硬凑一个 target,或演示到一半被判"元素不可见"直接结束
|
||||
- 只写说明区就报完成,没跑过逐步骤实测(自查看不出死按钮)
|
||||
Reference in new issue
Block a user