mirrors/pikasTech-unidesk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: shorten HWLAB issue link labels

Browse Source
This commit is contained in:
Codex
2026-06-14 14:56:10 +00:00
parent d6638655cc
commit b5d8cee438
14 changed files with 286 additions and 276 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.agents/skills/unidesk-gh/SKILL.md
+2 -2
View File
@@ -14,7 +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。
- Markdown 正文、issue/PR 正文和评论里的 issue/PR 引用必须写成 `[#<number>](https://github.com/<owner>/<repo>/issues/<number>)` 或 `[#<number>](https://github.com/<owner>/<repo>/pull/<number>)`，显示短号、链接目标保留完整 URL；不要显示裸长链接、裸井号编号或 `owner/repo` 加井号编号。`owner/repo#number` 只允许作为 CLI 命令参数 shorthand。
---
@@ -253,7 +253,7 @@ PATCH
---
## 看板命令 (#20 总看板)
## 看板命令 ([#20](https://github.com/pikasTech/unidesk/issues/20) 总看板)
```bash
# 结构审计
.agents/skills/unidesk-oa/SKILL.md
+5 -5
View File
@@ -18,7 +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 只作为命令输入例外。
- 所有写入 Markdown 正文、issue/PR 正文或评论的 issue/PR 引用必须写成 `[#<number>](https://github.com/<owner>/<repo>/issues/<number>)` 或 `[#<number>](https://github.com/<owner>/<repo>/pull/<number>)`，显示短号、链接目标保留完整 URL；不要显示裸长链接、裸井号编号或 `owner/repo` 加井号编号。CLI 参数中的 `owner/repo#number` shorthand 只作为命令输入例外。
- 不要让日报或阶段报告成为总规划。阶段报告只总结相对总规格的移动，不能替代中心规划。
- 当任务缺少上级方向、验收标准或原始验证入口时，先归类为规划/调查，不要直接变成实现任务。
- L1 方向必须是直接服务 L0 使命的能力域。文档整理、阶段报告、项目管理机制、看板维护、技能维护、仓库名、工具名和临时执行路径都不能作为 L1 方向。
@@ -26,10 +26,10 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
## HWLAB 标准 issue 锚点
- 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` 只作为导航索引。
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `[#1194](https://github.com/pikasTech/HWLAB/issues/1194)`。
- 长期导航面板：`[#645](https://github.com/pikasTech/HWLAB/issues/645)`（`HWLAB 长期总面板`）。这是面板，不是规格书。
- 当前 Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`，历史 issue `[#644](https://github.com/pikasTech/HWLAB/issues/644)`。
- 创建或更新 HWLAB 项目管理 issue 时，非平凡 L1/L2/L3/L4 工作都要链接回 `project-management/PJ2026-01` 中的对应规格文件，并保持 `[#645](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 个中文汉字以内，解释写在正文，不写进名称。
## 工作流
.agents/skills/unidesk-oa/references/project-planning.md
+6 -6
View File
@@ -32,14 +32,14 @@ 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。
所有 Markdown 正文、issue/PR 正文和评论中的 issue/PR 引用都必须写成 `[#<number>](https://github.com/<owner>/<repo>/issues/<number>)` 或 `[#<number>](https://github.com/<owner>/<repo>/pull/<number>)`，显示短号、链接目标保留完整 URL；不要显示裸长链接、裸井号编号或 `owner/repo` 加井号编号。`owner/repo#number` 只允许作为 CLI 命令参数 shorthand。
## 当前 HWLAB issue 锚点
- 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`。
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`。该规格文档本身承担索引职责；历史 issue 为 `[#1194](https://github.com/pikasTech/HWLAB/issues/1194)`。
- 长期面板/导航：`[#645](https://github.com/pikasTech/HWLAB/issues/645)`（`HWLAB 长期总面板`）。不要把它当成规格书。
- Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`。这是阶段规格，不是 L1 方向；历史 issue 为 `[#644](https://github.com/pikasTech/HWLAB/issues/644)`。
- 新建或更新方向/课题/执行 issue 时，除非用户明确限定在 HWLAB Cloud M1 之外，否则正文应包含 `上级总项目: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)`。
## 编号规则
@@ -113,7 +113,7 @@ L0 定义：
- issue 层级索引。
- 偏离指标。
通常应该有一个 L0 GitHub issue 和一个 L0 总规格文档。对 HWLAB 来说，标准 L0 编号是 `PJ2026-01`，标准 L0 issue 是 `https://github.com/pikasTech/HWLAB/issues/1194`；`https://github.com/pikasTech/HWLAB/issues/645` 只作为长期面板/导航入口。
通常应该有一个 L0 GitHub issue 和一个 L0 总规格文档。对 HWLAB 来说，标准 L0 编号是 `PJ2026-01`，标准 L0 issue 是 `[#1194](https://github.com/pikasTech/HWLAB/issues/1194)`；`[#645](https://github.com/pikasTech/HWLAB/issues/645)` 只作为长期面板/导航入口。
### L1 方向
.agents/skills/unidesk-oa/references/templates.md
+13 -13
View File
@@ -78,8 +78,8 @@
编号: PJ2026-01
短名: HWLAB
上级面板: https://github.com/pikasTech/HWLAB/issues/645
当前 L0 总规格: https://github.com/pikasTech/HWLAB/issues/1194
上级面板: [#645](https://github.com/pikasTech/HWLAB/issues/645)
当前 L0 总规格: [#1194](https://github.com/pikasTech/HWLAB/issues/1194)
总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
## 项目中心
@@ -90,12 +90,12 @@
## L1 方向
- [ ] 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> 平台运维:
- [ ] PJ2026-0101 [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>) 硬件池:
- [ ] PJ2026-0102 [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>) Agent编排:
- [ ] PJ2026-0103 [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>) HarnessRL:
- [ ] PJ2026-0104 [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>) 客户端:
- [ ] PJ2026-0105 [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>) 用户管理:
- [ ] PJ2026-0106 [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>) 平台运维:
方向判定: L1 必须是直接服务 L0 的能力域；文档整理、项目管理、看板维护、技能维护、仓库名、工具名和临时执行路径不得作为 L1。
@@ -135,7 +135,7 @@
编号: PJ2026-010N
短名: <8字以内>
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
上级总项目: [#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>
- [ ] [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>)
## 验收标准
@@ -187,11 +187,11 @@
编号: PJ2026-010N0M
短名: <8字以内>
上级总项目: https://github.com/pikasTech/HWLAB/issues/1194
上级总项目: [#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>
所属方向: [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>)
所属课题: [#<issue-number>](https://github.com/pikasTech/HWLAB/issues/<issue-number>)
规格文档: project-management/PJ2026-01/specs/<对应规格文件>.md
## 目标