docs: normalize HWLAB issue links
This commit is contained in:
Codex
@@ -14,6 +14,7 @@ UniDesk 受控 GitHub 操作入口，所有 issue/PR 读写走 `bun scripts/cli.
|
||||
- Issue/PR 的正式写入一律使用中文，包括标题、正文、评论、关闭/重开说明、PR 描述、PR 评论和 merge closeout 说明。
|
||||
- 命令、路径、trace/session/job id、API path、代码标识符、英文专有名词、原始日志摘录和外部错误原文可以保留原样；解释性文字、结论、风险、计划和验收说明必须中文。
|
||||
- 除非用户明确要求外文，不要用英文撰写 issue/PR closeout、进展评论或阻塞说明。
|
||||
- Markdown 正文、issue/PR 正文和评论里的 issue/PR 引用必须写完整 HTTPS URL，例如 `https://github.com/pikasTech/HWLAB/issues/1194` 或 `https://github.com/pikasTech/HWLAB/pull/1234`；不要把裸井号编号或 `owner/repo` 加井号编号当成正文引用。`owner/repo#number` 只允许作为 CLI 命令参数 shorthand。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -18,6 +18,7 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
|
||||
- 将 `project-management/PJ2026-01` 下的 Markdown 视为长期规格真相源。
|
||||
- 将 GitHub issue 视为执行控制面、历史讨论入口和长证据承载处：状态、讨论、跨仓引用、PR 链接和收口证据可以在 issue 中流转，但规格正文不得只写在 issue 中。
|
||||
- 长证据、trace、CaseRun registry、运行日志、历史 issue 摘要和证据索引保留在 GitHub issue 或具体执行 issue 中，禁止以 `evidence/` 目录或长证据文件形式污染 `project-management/PJ2026-01`。
|
||||
- 所有写入 Markdown 正文、issue/PR 正文或评论的 issue/PR 引用必须使用完整 `https://github.com/<owner>/<repo>/issues/<number>` 或 `https://github.com/<owner>/<repo>/pull/<number>` URL；不要写裸井号编号或 `owner/repo` 加井号编号。CLI 参数中的 `owner/repo#number` shorthand 只作为命令输入例外。
|
||||
- 不要让日报或阶段报告成为总规划。阶段报告只总结相对总规格的移动，不能替代中心规划。
|
||||
- 当任务缺少上级方向、验收标准或原始验证入口时，先归类为规划/调查，不要直接变成实现任务。
|
||||
- L1 方向必须是直接服务 L0 使命的能力域。文档整理、阶段报告、项目管理机制、看板维护、技能维护、仓库名、工具名和临时执行路径都不能作为 L1 方向。
|
||||
@@ -25,10 +26,10 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
|
||||
|
||||
## HWLAB 标准 issue 锚点
|
||||
|
||||
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `pikasTech/HWLAB#1194`。
|
||||
- 长期导航面板：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。这是面板，不是规格书。
|
||||
- 当前 Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`，历史 issue `pikasTech/HWLAB#644`。
|
||||
- 创建或更新 HWLAB 项目管理 issue 时，非平凡 L1/L2/L3/L4 工作都要链接回 `project-management/PJ2026-01` 中的对应规格文件，并保持 `#645` 只作为导航索引。
|
||||
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `https://github.com/pikasTech/HWLAB/issues/1194`。
|
||||
- 长期导航面板：`https://github.com/pikasTech/HWLAB/issues/645`（`HWLAB 长期总面板`）。这是面板，不是规格书。
|
||||
- 当前 Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`，历史 issue `https://github.com/pikasTech/HWLAB/issues/644`。
|
||||
- 创建或更新 HWLAB 项目管理 issue 时，非平凡 L1/L2/L3/L4 工作都要链接回 `project-management/PJ2026-01` 中的对应规格文件，并保持 `https://github.com/pikasTech/HWLAB/issues/645` 只作为导航索引。
|
||||
- 所有管理 issue 和规格都使用 HWLAB 层级编号：项目编号格式为 `PJ<YYYY>-<path>`；`PJ` 表示项目，`2026` 是立项年份，HWLAB L0 是 `PJ2026-01`；L1 编号是 `PJ2026-0101`、`PJ2026-0102` 等；L2 继续追加两位，例如 `PJ2026-010102` 表示 HWLAB L1 第 1 个方向下的第 2 个 L2 课题。稳定节点短名通常控制在 8 个中文汉字以内，解释写在正文，不写进名称。
|
||||
|
||||
## 工作流
|
||||
|
||||
@@ -32,20 +32,21 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
|
||||
|
||||
不要把稳定需求的唯一副本放在 issue 评论里。长期有效的需求必须蒸馏到 `project-management/PJ2026-01`，再从 issue 链接过去。
|
||||
不要把长证据正文放进项目管理目录。项目管理目录只承载规格、治理和阶段中心；长证据保留在 GitHub issue。
|
||||
所有 Markdown 正文、issue/PR 正文和评论中的 issue/PR 引用都必须写成完整 HTTPS URL，例如 `https://github.com/pikasTech/HWLAB/issues/1194` 或 `https://github.com/pikasTech/HWLAB/pull/1234`；不要使用裸井号编号或 `owner/repo` 加井号编号。`owner/repo#number` 只允许作为 CLI 命令参数 shorthand。
|
||||
|
||||
## 当前 HWLAB issue 锚点
|
||||
|
||||
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`。该规格文档本身承担索引职责；历史 issue 为 `pikasTech/HWLAB#1194`。
|
||||
- 长期面板/导航：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。不要把它当成规格书。
|
||||
- Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`。这是阶段规格，不是 L1 方向；历史 issue 为 `pikasTech/HWLAB#644`。
|
||||
- 新建或更新方向/课题/执行 issue 时，除非用户明确限定在 HWLAB Cloud M1 之外，否则正文应包含 `上级总项目: #1194`。
|
||||
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`。该规格文档本身承担索引职责；历史 issue 为 `https://github.com/pikasTech/HWLAB/issues/1194`。
|
||||
- 长期面板/导航：`https://github.com/pikasTech/HWLAB/issues/645`（`HWLAB 长期总面板`）。不要把它当成规格书。
|
||||
- Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`。这是阶段规格，不是 L1 方向；历史 issue 为 `https://github.com/pikasTech/HWLAB/issues/644`。
|
||||
- 新建或更新方向/课题/执行 issue 时，除非用户明确限定在 HWLAB Cloud M1 之外，否则正文应包含 `上级总项目: https://github.com/pikasTech/HWLAB/issues/1194`。
|
||||
|
||||
## 编号规则
|
||||
|
||||
- HWLAB L0 项目编号是 `PJ2026-01`：`PJ` 表示项目，`2026` 是立项年份，`01` 是 HWLAB L0 序号。
|
||||
- L1 方向编号为 `PJ2026-0101`、`PJ2026-0102`、`PJ2026-0103` 等。
|
||||
- L2 课题编号在 L1 编号后继续追加两位，例如 `PJ2026-010101`、`PJ2026-010102`、`PJ2026-010201`。
|
||||
- L3/L4 长期管理编号继续每级追加两位，例如 `PJ2026-01010203` 表示 HWLAB L1 #01 / L2 #02 / L3 #03。
|
||||
- L3/L4 长期管理编号继续每级追加两位，例如 `PJ2026-01010203` 表示 HWLAB L1 第 01 个 / L2 第 02 个 / L3 第 03 个。
|
||||
- 不要因为优先级变化而重编号。新稳定节点追加新后缀；执行型 PR 或一次性 smoke 可以引用最近的稳定编号，不一定单独编号。
|
||||
- 稳定节点短名通常不超过 8 个中文汉字。issue 标题应以编号和短名开头，例如 `PJ2026-010102 频源造模`；详细解释写在正文。
|
||||
|
||||
@@ -112,7 +113,7 @@ L0 定义：
|
||||
- issue 层级索引。
|
||||
- 偏离指标。
|
||||
|
||||
通常应该有一个 L0 GitHub issue 和一个 L0 总规格文档。对 HWLAB 来说，标准 L0 编号是 `PJ2026-01`，标准 L0 issue 是 `pikasTech/HWLAB#1194`；`#645` 只作为长期面板/导航入口。
|
||||
通常应该有一个 L0 GitHub issue 和一个 L0 总规格文档。对 HWLAB 来说，标准 L0 编号是 `PJ2026-01`，标准 L0 issue 是 `https://github.com/pikasTech/HWLAB/issues/1194`；`https://github.com/pikasTech/HWLAB/issues/645` 只作为长期面板/导航入口。
|
||||
|
||||
### L1 方向
|
||||
|
||||
|
||||
@@ -78,8 +78,8 @@
|
||||
|
||||
编号: PJ2026-01
|
||||
短名: HWLAB
|
||||
上级面板: #645
|
||||
当前 L0 总规格: #1194
|
||||
上级面板: https://github.com/pikasTech/HWLAB/issues/645
|
||||
当前 L0 总规格: https://github.com/pikasTech/HWLAB/issues/1194
|
||||
总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
|
||||
|
||||
## 项目中心
|
||||
@@ -90,12 +90,12 @@
|
||||
|
||||
## L1 方向
|
||||
|
||||
- [ ] PJ2026-0101 #... 硬件池:
|
||||
- [ ] PJ2026-0102 #... Agent编排:
|
||||
- [ ] PJ2026-0103 #... HarnessRL:
|
||||
- [ ] PJ2026-0104 #... 客户端:
|
||||
- [ ] PJ2026-0105 #... 用户管理:
|
||||
- [ ] PJ2026-0106 #... 平台运维:
|
||||
- [ ] PJ2026-0101 https://github.com/pikasTech/HWLAB/issues/<issue-number> 硬件池:
|
||||
- [ ] PJ2026-0102 https://github.com/pikasTech/HWLAB/issues/<issue-number> Agent编排:
|
||||
- [ ] PJ2026-0103 https://github.com/pikasTech/HWLAB/issues/<issue-number> HarnessRL:
|
||||
- [ ] PJ2026-0104 https://github.com/pikasTech/HWLAB/issues/<issue-number> 客户端:
|
||||
- [ ] PJ2026-0105 https://github.com/pikasTech/HWLAB/issues/<issue-number> 用户管理:
|
||||
- [ ] PJ2026-0106 https://github.com/pikasTech/HWLAB/issues/<issue-number> 平台运维:
|
||||
|
||||
方向判定: L1 必须是直接服务 L0 的能力域；文档整理、项目管理、看板维护、技能维护、仓库名、工具名和临时执行路径不得作为 L1。
|
||||
|
||||
@@ -135,7 +135,7 @@
|
||||
|
||||
编号: PJ2026-010N
|
||||
短名: <8字以内>
|
||||
上级总项目: #1194
|
||||
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
|
||||
总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
|
||||
|
||||
## 主责边界
|
||||
@@ -162,7 +162,7 @@
|
||||
|
||||
## L2 课题
|
||||
|
||||
- [ ] #...
|
||||
- [ ] https://github.com/pikasTech/HWLAB/issues/<issue-number>
|
||||
|
||||
## 验收标准
|
||||
|
||||
@@ -187,11 +187,11 @@
|
||||
|
||||
编号: PJ2026-010N0M
|
||||
短名: <8字以内>
|
||||
上级总项目: #1194
|
||||
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
|
||||
主责方向: PJ2026-010N <短名>
|
||||
关联方向: <可空；只列交接方向，不替代主责>
|
||||
所属方向: #...
|
||||
所属课题: #...
|
||||
所属方向: https://github.com/pikasTech/HWLAB/issues/<issue-number>
|
||||
所属课题: https://github.com/pikasTech/HWLAB/issues/<issue-number>
|
||||
规格文档: project-management/PJ2026-01/specs/<对应规格文件>.md
|
||||
|
||||
## 目标
|
||||
|
||||
Reference in New Issue
Block a user