docs: keep HWLAB requirements focused

2026-06-14 16:19:08 +00:00
parent 03b47aefff
commit 43b713a553
4 changed files with 45 additions and 43 deletions
@@ -33,7 +33,8 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
 - L0 系统边界必须把 HWLAB 作为完整系统看待，描述外部使用者、外部输入、受控资源、外部输出、用户接口和系统责任边界，不写内部治理材料。
 - 稳定概念用术语表表达；不要写没有判定价值的“运行概念”流水。
 - L0 的 L1 方向树和项目规格索引合并为内部模块分工与规格索引，用相对路径索引到每个内部模块规格文档。
- 原子需求每条独立成节，信息表使用横向表格 `编号 | 需求 | 主责模块 | 职责划分`。主责模块必须带项目编号和相对路径链接；不写 `类型`、`验证方法`、`验证入口`、`必需证据`、`接受标准`，正文只说明意图和边界，不重复需求句。
+- 原子需求每条独立成节，信息表使用横向表格且只放短元数据，推荐列为 `编号 | 短名 | 主责模块 | 关联模块`。主责模块必须带项目编号和相对路径链接；禁止把需求句、职责划分、验收口径或大段说明塞进表格，正文必须承载需求定义、职责边界、意图和范围。
+- 不要为了凑全局原子需求条数自动添加次要派生能力。证据收集、硬编码诊断、硬编码建议、任务状态收集、结果包/结果收集等需求，除非用户明确授意，不得写入 OA 规格或 L0 原子需求。
 - 平台运维在 L0 中只能作为支撑后勤职责出现；对外需求应写成系统可用性、可恢复、资源可控等用户可感知能力，不写成“HWLAB 对外提供平台运维能力”。
 - 单一主责、关闭验收、规格沉淀、回写和偏离判定是治理规则，不得伪装成 L0 原子需求。

@@ -71,11 +71,11 @@

 ### 6.1 HWLAB-L0-REQ-001 <需求短名>

-| 编号 | 需求 | 主责模块 | 职责划分 |
+| 编号 | 短名 | 主责模块 | 关联模块 |
 | --- | --- | --- | --- |
-| HWLAB-L0-REQ-001 | <HWLAB 应提供的对外系统能力> | [PJ2026-0101 <主责模块>](<相对路径>) | <主责负责什么；关联模块负责什么；哪些内容不属于本需求> |
+| HWLAB-L0-REQ-001 | <需求短名> | [PJ2026-0101 <主责模块>](<相对路径>) | [<关联模块>](<相对路径>) |

-<正文说明该原子需求的意图、范围和边界。正文不重复需求句，不写类型、验证方法、验证入口、必需证据或接受标准。>
+<正文第一段写完整需求定义。正文后续段落写主责职责、关联模块职责、意图、范围和边界。不要把需求句、职责划分、类型、验证方法、验证入口、必需证据或接受标准塞进表格。不要为了凑条目自动添加证据收集、硬编码诊断、硬编码建议、任务状态收集、结果包或结果收集类次要需求。>
 ```

 ## L0 issue 正文