返回板块LHB-WB-SPEC-PRD-001 PRD编写范式技术标准
V1.0.02026-10-16行政法规 · 范式
源文件：C:/Users/xub/.workbuddy/spec/3.行政法规/范式/LHB-WB-SPEC-PRD-001_PRD编写范式技术标准_V1.0.0_2026-10-16.md
编号：LHB-WB-SPEC-PRD-001
版本：V1.0.0
批准生效日：2026-10-16（炳哥批准，批准即生效）
批准登记：批准人＝炳哥 ｜ 批准日＝2026-10-16 ｜ 登记人＝WorkBuddy（非手签）｜ 批准日与登记日同日，不倒填
类别：范式标准（行政法规级技术标准）
蓝本：《PRD：利衡辨_DSH 全域全流程阻偏管控范式技术标准升级 V1.1.0》（PRD-LHB-DSH-CONTROL-UP-2026-001，DSH 侧）
上位判据：《全域任务脑手架构宪法》V1.2.0 ／《全域文件体系基本法》V2.3.0（冲突以上位为准，先请示炳哥）
落地范围：WorkBuddy（W）侧全部新任务、新对话、载体施工、标准升版、跨链交付、出件
配套件：《PRD 类文档 HTML 出件范式技术标准》V1.0.0（同目录）——本件管内容，那件管版式
本文性质：范式标准。只规定「PRD 该长成什么样」，不施工、不代裁、不动母版。
0 规范缘由（为什么有这份规范）
2026-10-16 实录：拿到一份写得很好的 DSH 侧 PRD（十节齐全、A 级硬指标十二项、附录 A—I），但它是一篇孤例。
问题不在这一篇写得好不好，在于：
| 症结 |
表现 |
后果 |
| 结构没固化 |
每篇 PRD 各写各的节数与命名 |
校验器无法机器判，缺项靠人眼 |
| 关键节缺失无拦截 |
有的 PRD 缺「非目标」、缺「已知约束」照样开工 |
范围蔓延、约束漏项 |
| 量化参数不签署 |
阈值、样本量、误差带凭脑定 |
同类任务两次两个口径，无法复算 |
| 待裁项被代裁 |
编制方顺手替批准人拍板 |
越权定标，四红线破防 |
| 只读豁免滥用 |
「这条只是看一下」顺手豁免 |
闸门被绕过 |
修法：把好件里已经跑通的东西抽成判据 —— 节位固化 + 字段可判 + 签署集中 + 待裁 fail-closed + 呈报入正文。
1 适用范围
1.1 必须写 PRD 的六类事件
| # |
事件 |
无 PRD 时 |
依据 |
| 1 |
每次新对话 |
拒绝进入授权 |
铁律五 · 呈报层 |
| 2 |
每次新任务 |
拒绝进入执行 |
铁律五 · 呈报层 |
| 3 |
每次载体施工（skill／expert／spec 增改升版） |
拒绝进入出件 |
铁律五 |
| 4 |
每次标准升版 |
拒绝进入版本发布 |
铁律五 |
| 5 |
每次跨链交付 |
拒绝进入交割 |
铁律五 |
| 6 |
每次出件（落盘、交件、发布） |
拒绝进入落盘 |
铁律五 |
1.2 豁免边界
- 纯只读查询默认不豁免；是否豁免须炳哥书面裁定并登记；
- 豁免登记必含六字段：豁免编号、触发事件、豁免范围、批准人、生效时间、失效时间；
- 豁免不得扩大至写操作、发布、备份、恢复、网络外传；
- 未裁定前 → fail-closed（不默认放行）。
2 PRD 关键节八项（硬要求 · 缺一即不合格）
这是 W 侧铁律五的落标。八项齐备才算 PRD；缺任一项，判 prd_incomplete，拒绝往下走。
| # |
节名 |
必含内容 |
常见不合格写法 |
| 1 |
项目名称与背景 |
项目名 + 为什么现在做 + 现状是什么 |
只写项目名，不写现状 |
| 2 |
目标用户与核心场景 |
谁用 + 在什么场景下用 |
写「通用」 |
| 3 |
要解决的问题 |
编号列问题，一条一句 |
写成一段散文 |
| 4 |
期望结果与成功指标 |
可量化指标 + 阈值 |
只写「提升质量」 |
| 5 |
非目标 |
明确不做什么 |
整节缺失（本范式新增硬要求） |
| 6 |
交付物 |
编号 + 件名 + 格式 + 是否必需 |
只写「一份报告」 |
| 7 |
验收标准 |
逐条可判，含通过线 |
只写「验收通过」 |
| 8 |
已知约束 |
约束 + 边界 + 不可越线项 |
整节缺失（本范式新增硬要求） |
判定规则：
- 八项节名逐字一致（允许带序号前缀，如「1 项目名称与背景」）；
- 任一节仍带方括号占位符（待填 / 待澄清）且未澄清 → 判不合格，不得作为可执行依据；
- 「非目标」「已知约束」两节为本标准新增硬要求 —— 缺这两节是历史 PRD 最常见漏项，漏则范围与边界无人守。
3 推荐节位（十节制 · 蓝本沿用）
八项关键节是底线；十节制是推荐骨架，两者是包含关系，不是二选一。
| 节 |
名称 |
与关键节的关系 |
作用 |
| 0 |
文档信息 |
新增 |
编号、版本、状态、提交/审核/批准三签署位 |
| 1 |
项目名称与背景 |
＝关键节 1 |
现状 + 动因 + 目标 |
| 2 |
目标用户与核心场景 |
＝关键节 2 |
受众 + 场景 |
| 3 |
要解决的问题 |
＝关键节 3 |
问题清单 |
| 4 |
期望结果与成功指标 |
＝关键节 4 |
G01—Gnn 量化目标 |
| 5 |
非目标 |
＝关键节 5 |
划边界 |
| 6 |
适用范围 |
新增 |
受控对象 + 触发事件 + 豁免边界 |
| 7 |
输入资料 |
新增 |
编号 + 绝对路径 + 权威性确认 |
| 8 |
核心需求 |
新增 |
融合/保留/删除/新增 四栏 |
| 9 |
交付物 |
＝关键节 6 |
O01—Onn |
| 10 |
质量与治理要求 |
新增 |
闸门、双盘、审计、禁止项 |
| 11 |
约束与风险 |
新增 |
约束 + RK 风险登记册 |
| 12 |
验收标准 |
＝关键节 7 |
硬指标 + 通过线 |
| 13 |
验收与签署 |
新增 |
签署表 + 签署前后动作 |
节位纪律：
- 关键节不可合并、不可改名、不可删；确需调整顺序，只调非关键节；
- 增设自定义节允许，但须插在第 12 节之前，且不得占用关键节编号位；
- 节号与目录锚点须一一对应，侧栏目录层级与正文层级一致。
4 字段可判化（四类字段写法）
4.1 目标字段（G 类）
G01 | 目标陈述 | 量化口径 | 判定方式
- 量化口径必须可数：比率、计数、阈值、时限；
- 禁写「显著提升」「基本达成」「大幅优化」。
4.2 交付物字段（O 类）
O01 | 件名 | 格式 | 是否必需 | 落盘路径
- 「是否必需」只取
是 / 否，不留空；
- 「落盘路径」写完整绝对路径，含扩展名。
4.3 输入资料字段（I 类）
I01 | 件名 | 完整绝对路径 | 格式 | 权威盘状态
- 权威盘状态取：
已核验 / 待核验 / 不适用；
- 禁写目录名当输入件、禁通配符、禁网络路径；
- 路径含中文、空格、特殊符号须逐字核对。
4.4 需求边界字段（F／D／N 三类）
| 类别 |
含义 |
编号段 |
必填列 |
| F 融合 |
从他件并入本标准 |
F01—Fnn |
来源件、来源章节、目标位置、融合方式 |
| D 废止 |
建议删除或停用 |
D01—Dnn |
项、建议、理由、处置、批准状态 |
| N 新增 |
本标准新增 |
N01—Nnn |
新增项、落位、说明 |
纪律：D 类每一项都必须写清「处置」；处置为「待批准」时，本标准不得代裁。
5 量化参数签署集中制
所有需要拍板的数字，一律集中在「量化参数签署清单」，不在正文里散落。
| 列 |
说明 |
| 序号 |
连续编号 |
| 参数 |
参数名（如「配对样本量」「允许误差」） |
| 建议默认值 |
编制方给建议，不替批准人定 |
| 状态 |
待批准 / 已签署 / 已驳回 |
硬规则：
- 建议默认值必须标注「建议默认值 · 须批准人签署确认」；
- 未签署的参数不得作为验收判据；
- 参数未签署期间，相关结论一律 fail-closed（不得以「暂按建议值」放行）。
6 待裁项 fail-closed
6.1 什么算待裁项
- 阈值、样本量、误差带、目标版本号 —— 需批准人签署的；
- 归属、命名、落位、回退 —— 属载体治理链的；
- 跨件口径冲突（同一判据两处说法）—— 属判据侧定标的。
6.2 待裁登记五列
序号 | 待裁事项 | 为何不能代裁 | 定不下来的后果 | 状态
纪律：
- 「为何不能代裁」必填 —— 写不清就说明它本该由编制方定；
- 「定不下来的后果」必填 —— 说不出后果就说明它不紧急；
- 状态只取
待批准 / 已裁定，禁「先这样吧」类状态；
- 待裁项不因工期紧而自动放行。
7 呈报层（本标准最要紧的一条）
7.1 落盘 ≠ 呈报
PRD 落盘不等于 PRD 呈报。 开工前必须把 PRD 核心内容摆进对话正文给炳哥过目。
7.2 呈报合格线（五项全中才算呈报）
| # |
项 |
合格形态 |
| 1 |
正文摘报 |
对话正文里能看见八节要点或全文 |
| 2 |
给出路径 |
PRD 全文的绝对路径 |
| 3 |
标 approval_ref |
明示放行依据编号 |
| 4 |
标 prd_status |
明示 presented / pending |
| 5 |
标 token 档位 |
明示甲档 / 超甲档 / 超乙档 |
7.3 不算呈报的六种形态
- 只说「已落盘」；
- 只说「已归档」；
- 只给文件卡片、不摘报内容；
- 开工后补呈报；
- 呈报里节位不全（只报三节）；
- 呈报里仍带方括号占位符未澄清。
判据：prd_not_presented → 拒绝开工 / 拒绝施工。
7.4 登记与边界（不得夸大）
- 机器闸查的是「工作目录是否留有呈报登记」；
- 因此表述只能用「工作目录未找到呈报登记」；
- 不得称「运行时全域受控」，不得称「本轮已呈报」「历史轮已呈报」；
- 登记缺失 ≠ 呈报缺失 —— 这是两件事。
8 验收标准
8.1 PRD 自身合格判据（P 类）
| # |
判据 |
通过线 |
| P01 |
八关键节齐备率 |
= 100% |
| P02 |
方括号占位符（待填/待澄清）未澄清数 |
= 0 |
| P03 |
量化参数签署率 |
= 100%（未签者标 fail-closed） |
| P04 |
待裁项登记完整率 |
= 100%（五列全填） |
| P05 |
呈报五项合格率 |
= 100% |
| P06 |
O 类交付物「落盘路径」完整率 |
= 100% |
| P07 |
I 类输入件「绝对路径」完整率 |
= 100% |
| P08 |
非目标节存在率 |
= 100% |
| P09 |
已知约束节存在率 |
= 100% |
8.2 判定规则
- P01—P09 全部满足 → 判「PRD 合格」；
- 任一不满足 → 最高判「待补」，不得作为可执行依据；
- PRD 结论不得由模型自述，须人工签署。
9 交付物
| 编号 |
交付物 |
格式 |
是否必需 |
| PO1 |
本标准正文 |
Markdown |
是 |
| PO2 |
PRD 空白模板（十节骨架 + 占位） |
HTML |
是 |
| PO3 |
PRD 字段校验清单（可勾选表） |
Markdown |
是 |
| PO4 |
本标准升版记录 |
Markdown |
是 |
10 约束与风险
10.1 约束
- 本标准只定标，不施工：不替任何任务写 PRD；
- 本标准不代裁：所有待裁项保持
待批准；
- 本标准不改母版：版式判据归《PRD 类文档 HTML 出件范式技术标准》与母版；
- 本标准不升 G07／G28：与两份版式件并列，不覆盖。
10.2 风险登记册
| 编号 |
风险 |
影响 |
缓解 |
责任侧 |
| PRK01 |
编制方为赶工跳过呈报层 |
无据开工 |
P05 判据 + 机器登记 |
编制方 |
| PRK02 |
「非目标」被写成空话 |
边界仍失守 |
P08 存在率 + 抽查实质 |
编制方 |
| PRK03 |
建议默认值被当已定值 |
越权定标 |
第 5 节硬规则 2 |
批准人 |
| PRK04 |
待裁项被「先按建议值跑」 |
fail-closed 失效 |
第 6 节纪律 4 |
编制方 |
| PRK05 |
只读豁免被扩大解释 |
闸门旁路 |
第 1.2 节豁免不得扩大 |
批准人 |
| PRK06 |
十节制被当硬要求强套小任务 |
形式主义 |
第 3 节明确「八项是底线，十节是推荐」 |
编制方 |
| PRK07 |
两份标准（内容/版式）打架 |
出件返工 |
版式判据单一真源在母版 |
编制方 |
11 验收与签署
11.1 签署表
| 角色 |
姓名 / 身份 |
状态 |
日期 |
| 提交方 |
WorkBuddy（K3 定标，不施工） |
待提交 |
2026-10-16 |
| 审核方 |
待炳哥指定 |
待审核 |
|
| 批准方 |
炳哥 |
待批准 |
|
11.2 当前状态声明
- 本标准经炳哥批准，2026-10-16 批准即生效；
- 本标准不追溯任何历史 PRD —— 不表示历史 PRD 已按本标准重做，亦不据此判历史件不合格；
- 本标准不代裁任何待裁事项，一律保持 fail-closed；
- 本标准生效不豁免任何在途任务的已开工状态；
- 机器闸已部署：
~/.workbuddy/_tools/prd_html_gate.py（H 类十项），与 format_gate.py（版式四查）串联执行，两闸皆 RC=0 方为可交付；
- 配套件已落母版目录：
template_prd_universal.html（PRD 空白模板）＋ PRD字段校验清单_V1.0.0_2026-10-16.md（可勾选校验表）；
- 本标准与《PRD 类文档 HTML 出件范式技术标准》配套使用，单独一份不完整；
- 本标准判结构与字段齐备，不判内容实质 —— 实质抽查仍需人工。
本标准结束。内容判据在此，版式判据在配套件。