docs: rewrite HWLAB L1 specs

This commit is contained in:
Codex
2026-06-14 16:59:38 +00:00
parent b091cb63aa
commit 4ee530b7cf
9 changed files with 596 additions and 409 deletions
+1
View File
@@ -30,6 +30,7 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
- 需求规格是对外系统能力、边界和职责说明,不写内部治理、issue 关闭规则、长期面板、阶段报告、执行控制面、单次验证流水、PR 过程或证据堆叠。
- 文档控制表只保留规格自身必要字段;状态只能写 `已生效``已废弃``未生效`。不要在文档控制表里写长期面板、阶段规格、L1 划分、规格来源或迁移来源。
- 修改历史只记录已经定稿的版本。用户未明确说“可以定稿”前,不新增 `待提交` 版本号,也不把每次小编辑拆成一个版本。
- L0、L1、L2 需求规格正文固定使用裁剪后的 1-6 章结构:文档控制、目的和范围、术语表、系统边界和接口、内部分工与规格索引、原子需求。不要在 SPEC 正文追加假设和风险、变更控制、回写规则、开放缺口、验收标准或执行过程章节。
- L0 系统边界必须把 HWLAB 作为完整系统看待,描述外部使用者、外部输入、受控资源、外部输出、用户接口和系统责任边界,不写内部治理材料。
- 稳定概念用术语表表达;不要写没有判定价值的“运行概念”流水。
- L0 的 L1 方向树和项目规格索引合并为内部模块分工与规格索引,用相对路径索引到每个内部模块规格文档。