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

docs: migrate HWLAB specs to project management

Browse Source
This commit is contained in:
Codex
2026-06-14 13:57:38 +00:00
parent 85bbc3cd3a
commit 37de91c653
16 changed files with 1367 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.agents/skills/unidesk-oa/SKILL.md
+11 -12
View File
@@ -1,23 +1,22 @@
---
name: unidesk-oa
description: UniDesk/HWLabOA 项目管理运行技能。用户提到 HWLabOA、OA 文档、总项目规格、总规划、重大项目/方向/课题/子课题层级、任务书、实施方案、测试规格、阶段报告、项目偏离，或通过 GitHub issue 层级树管理 HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理时使用。
description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管理目录、HWLAB OA、总项目规格、总规划、重大项目/方向/课题/子课题层级、任务书、实施方案、测试规格、阶段报告、项目偏离，或通过 project-management 与 GitHub issue 管理 HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理时使用。
---
# UniDesk OA
使用本技能时，把 HWLAB Cloud M1 的项目管理稳定地锚定在总规格和相互链接的 GitHub issue 层级上。
使用本技能时，把 HWLAB Cloud M1 的项目管理稳定地锚定在 UniDesk 仓库内的项目编号目录和相互链接的 GitHub issue 执行记录上。
## 仓库
- HWLabOA 真相源：`/root/HWLabOA`（从 `/root/unidesk` 看是 `../HWLabOA`），远端为 `git@github.com:notLabyet/HWLabOA.git`，分支为 `main`。
- UniDesk 控制/工具仓库：`/root/unidesk`，远端为 `git@github.com:pikasTech/unidesk.git`，分支为 `master`。
- 修改 HWLabOA 文档前，必须在 `/root/HWLabOA` 执行 `git status --short --branch` 和 `git pull --ff-only origin main`。
- 使用 UniDesk GitHub CLI 或修改本技能前，必须在 `/root/unidesk` 执行 `git status --short --branch` 和 `git pull --ff-only origin master`。
- UniDesk 项目管理真相源：`/root/unidesk/project-management/PJ2026-01`，其中 `specs/PJ2026-01-HWLAB.md` 是 L0 总规格和项目索引，随 `pikasTech/unidesk` 的 `master` 分支版本化。
- 迁移前 HWLabOA 仓库：`/root/HWLabOA` 只作为历史材料和对照来源，不再作为 HWLAB Cloud M1 规格真相源。
- 使用 UniDesk GitHub CLI、修改本技能或修改项目管理文档前，必须在 `/root/unidesk` 执行 `git status --short --branch` 和 `git pull --ff-only origin master`。
## 运行模型
- 将 HWLabOA Markdown 视为长期规格真相源。
- 将 GitHub issue 视为执行控制面：层级、状态、讨论、跨仓引用、PR 链接和收口证据都在 issue 中流转。
- 将 `project-management/PJ2026-01` 下的 Markdown 视为长期规格真相源。
- 将 GitHub issue 视为执行控制面和历史讨论入口：状态、讨论、跨仓引用、PR 链接和收口证据可以在 issue 中流转，但规格正文不得只写在 issue 中。
- 不要让日报或阶段报告成为总规划。阶段报告只总结相对总规格的移动，不能替代中心规划。
- 当任务缺少上级方向、验收标准或原始验证入口时，先归类为规划/调查，不要直接变成实现任务。
- L1 方向必须是直接服务 L0 使命的能力域。文档整理、阶段报告、项目管理机制、看板维护、技能维护、仓库名、工具名和临时执行路径都不能作为 L1 方向。
@@ -25,10 +24,10 @@ description: UniDesk/HWLabOA 项目管理运行技能。用户提到 HWLabOA、O
## HWLAB 标准 issue 锚点
- L0 总规格：`PJ2026-01`，`pikasTech/HWLAB#1194`（`HWLAB 总规格`）。
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`，历史 issue `pikasTech/HWLAB#1194`。
- 长期导航面板：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。这是面板，不是规格书。
- 当前 Cloud M1 阶段规格：`pikasTech/HWLAB#644`（`HWLAB Cloud SPEC / 云平台开发目标 20260601`）。这是阶段规格，不是 L1 方向。
- 创建或更新 HWLAB 项目管理 issue 时，非平凡 L1/L2/L3/L4 工作都要链接回 `#1194`，并保持 `#645` 只作为导航索引。
- 当前 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` 只作为导航索引。
- 所有管理 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 个中文汉字以内，解释写在正文，不写进名称。
## 工作流
@@ -36,7 +35,7 @@ description: UniDesk/HWLabOA 项目管理运行技能。用户提到 HWLabOA、O
1. 做规划类问题时，读取 `references/project-planning.md`。
2. 创建或更新总规格、issue 正文时，读取 `references/templates.md`。
3. 写入 GitHub issue/PR 评论时，同时使用 `unidesk-gh`；所有写入必须从 `/root/unidesk` 通过 `bun scripts/cli.ts gh ...` 完成。
4. 修改长期 HWLabOA 项目文档时，把稳定规划内容放到总规格/规格文件，阶段报告只保留带日期的总结。
4. 修改长期项目管理文档时，把稳定规划内容放到 `project-management/PJ2026-01` 的总规格/规格文件，阶段报告只保留带日期的总结。
5. 修订 L1/L2 层级时，先按完成标准判断主责，再看实现表面。工具、CLI、Web、API 形态可以形成关联 L1，但主责 L1 必须是定义完成标准的能力域。
## 必需层级和职责
.agents/skills/unidesk-oa/agents/openai.yaml
+2 -2
View File
@@ -1,4 +1,4 @@
interface:
display_name: "UniDesk OA"
short_description: "管理 HWLabOA 总规格和 issue 层级。"
default_prompt: "使用本技能规划 HWLabOA 项目结构、总规格和相互链接的 GitHub issue 层级树。"
short_description: "管理 UniDesk 项目规格目录和 issue 层级。"
default_prompt: "使用本技能规划 project-management/PJ2026-01 项目结构、总规格和相互链接的 GitHub issue 执行记录。"
.agents/skills/unidesk-oa/references/project-planning.md
+22 -13
View File
@@ -29,13 +29,13 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
- 运行 trace、session、job ID。
- 收口评论。
不要把稳定需求的唯一副本放在 issue 评论里。长期有效的需求必须蒸馏到 HWLabOA，再从 issue 链接过去。
不要把稳定需求的唯一副本放在 issue 评论里。长期有效的需求必须蒸馏到 `project-management/PJ2026-01`，再从 issue 链接过去。
## 当前 HWLAB issue 锚点
- L0 总规格：`PJ2026-01`，`pikasTech/HWLAB#1194`（`HWLAB 总规格`）。
- L0 总规格：`project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md`。该规格文档本身承担索引职责；历史 issue 为 `pikasTech/HWLAB#1194`。
- 长期面板/导航：`pikasTech/HWLAB#645`（`HWLAB 长期总面板`）。不要把它当成规格书。
- Cloud M1 阶段规格：`pikasTech/HWLAB#644`（`HWLAB Cloud SPEC / 云平台开发目标 20260601`）。这是阶段规格，不是 L1 方向。
- Cloud M1 阶段规格：`project-management/PJ2026-01/specs/stage-cloud-spec-20260601.md`。这是阶段规格，不是 L1 方向；历史 issue 为 `pikasTech/HWLAB#644`。
- 新建或更新方向/课题/执行 issue 时，除非用户明确限定在 HWLAB Cloud M1 之外，否则正文应包含 `上级总项目: #1194`。
## 编号规则
@@ -47,24 +47,33 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
- 不要因为优先级变化而重编号。新稳定节点追加新后缀；执行型 PR 或一次性 smoke 可以引用最近的稳定编号，不一定单独编号。
- 稳定节点短名通常不超过 8 个中文汉字。issue 标题应以编号和短名开头，例如 `PJ2026-010102 频源造模`；详细解释写在正文。
## 建议的 HWLabOA 结构
## 建议的 UniDesk 项目管理结构
HWLAB Cloud M1 的长期文档放在：
HWLAB Cloud M1 的长期文档放在 UniDesk 仓库内，并使用项目编号命名目录：
```text
/root/HWLabOA/Project Management/[EPIC001][HWLab][PRJ002][CLOUD-M1]/
/root/unidesk/project-management/PJ2026-01/
```
推荐文件：
```text
SPEC-CLOUD-M1-MASTER.md # L0 总规格和 issue 层级树索引
SPEC-CLOUD-M1.md # 既有阶段材料，可以链接到 master 文件
PLAN-CLOUD-M1-DIRECTIONS.md # L1 方向实施方案，可选
TEST-CLOUD-M1-VALIDATION.md # 跨方向验收矩阵，可选
specs/PJ2026-01-HWLAB.md # L0 总规格，同时作为项目索引
specs/stage-cloud-spec-20260601.md # 既有阶段材料
specs/PJ2026-010N-*.md # L1 方向规格
specs/spec-governance.md # 编号、层级、回写与偏离规则
specs/current-center.md # 当前中心和非中心边界
evidence/*.md # 迁出的长证据索引
```
优先维护一个 master 文件。只有当 master 文件过大，或某个部分具有独立生命周期和评审需要时才拆分。
优先维护 L0 总规格作为入口索引。只有当某个部分具有独立生命周期和评审需要时才拆分到 L1、治理、阶段或证据文件。
每个长期规格文件最前面必须有修改历史表格，字段固定为：
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
版本号随稳定规格变更递增；对应 commit id 写入承载该版本内容的 Git commit；变更说明用一句话概括。
## L0-L4 规则
@@ -74,8 +83,8 @@ TEST-CLOUD-M1-VALIDATION.md # 跨方向验收矩阵，可选
| 层级 | 负责 | 不负责 | 回写到 |
| --- | --- | --- | --- |
| L0 | 使命、非目标、当前中心、L1 方向树、全局验收、偏离规则 | PR 细节、CaseRun 日志、日报流水、实现设计 | HWLabOA 总规格和 L1 issue |
| L1 | 能力域范围、成功标准、L2 课题清单、原始验收类型 | 单个 PR、一次性 smoke、仓库/工具/运行面名称、项目管理动作 | L0 issue 和 HWLabOA |
| L0 | 使命、非目标、当前中心、L1 方向树、全局验收、偏离规则 | PR 细节、CaseRun 日志、日报流水、实现设计 | `project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md` 和 L1 issue |
| L1 | 能力域范围、成功标准、L2 课题清单、原始验收类型 | 单个 PR、一次性 smoke、仓库/工具/运行面名称、项目管理动作 | L0 规格和对应 L1 规格文件 |
| L2 | 一个 L1 内的具体课题、交付物、阻塞项、验证计划 | 宽泛能力域或实现细节流水 | L1 issue，重大移动再回写 L0 |
| L3 | 一个有界验收切片和单一验收路径 | 路线图、多课题计划、父级范围变化 | L2/L1 issue 并带证据 |
| L4 | 具体执行：PR、CaseRun、smoke、部署、文档收口 | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1，并带原入口证据 |
.agents/skills/unidesk-oa/references/templates.md
+14 -8
View File
@@ -5,6 +5,12 @@
```markdown
# HWLAB 总规格
## 修改历史
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | <commit> | <YYYY-MM-DD> | <一句话变更说明> |
编号: PJ2026-01
短名: HWLAB
@@ -74,7 +80,7 @@
短名: HWLAB
上级面板: #645
当前 L0 总规格: #1194
总规格文档: <HWLabOA 路径或 GitHub URL>
总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
## 项目中心
@@ -99,8 +105,8 @@
| 层级 | 负责定义 | 不负责 | 回写对象 |
| --- | --- | --- | --- |
| L0 | 项目使命、当前中心、L1 方向树、全局验收、偏离规则 | PR 细节、CaseRun 日志、日报流水 | HWLabOA 总规格、L1 issue |
| L1 | 能力域范围、成功标准、L2 课题清单、原入口验收类型 | 单个 PR、一次 smoke、仓库/工具/运行面名称、项目管理动作 | L0 issue、HWLabOA |
| L0 | 项目使命、当前中心、L1 方向树、全局验收、偏离规则 | PR 细节、CaseRun 日志、日报流水 | L0 规格文件、L1 issue |
| L1 | 能力域范围、成功标准、L2 课题清单、原入口验收类型 | 单个 PR、一次 smoke、仓库/工具/运行面名称、项目管理动作 | L0 规格文件、对应 L1 规格文件 |
| L2 | 单个方向内的具体课题、交付物、阻塞、验收计划 | 总方向定义、实现细节流水 | L1 issue，重大移动再回写 L0 |
| L3 | 一个有界验收切片和单一验收路径 | 路线图、跨课题计划、父级范围变化 | L2/L1 issue |
| L4 | PR、CaseRun、smoke、部署、文档收口等执行和证据 | 新需求、新方向、验收规则变化 | 最近的 L3/L2/L1 |
@@ -118,7 +124,7 @@
## 回写规则
- 下级 issue 关闭时必须评论回写到对应 L1。
- L1 阶段完成时必须回写本 issue，并更新 HWLabOA 总规格。
- L1 阶段完成时必须回写本 issue，并更新 `project-management/PJ2026-01` 中的对应规格文件。
```
## L1 方向 issue 正文
@@ -130,7 +136,7 @@
编号: PJ2026-010N
短名: <8字以内>
上级总项目: #1194
总规格文档: <HWLabOA 路径或 GitHub URL>
总规格文档: project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
## 主责边界
@@ -171,7 +177,7 @@
## 回写规则
- 下级 L2/L3 完成后评论回写本 issue。
- 方向状态变化后更新 L0 issue 和 HWLabOA 总规格。
- 方向状态变化后更新 L0 规格和对应 L1 规格文件。
```
## L2/L3 执行 issue 头部
@@ -186,7 +192,7 @@
关联方向: <可空；只列交接方向，不替代主责>
所属方向: #...
所属课题: #...
规格文档: <HWLabOA 路径或 URL>
规格文档: project-management/PJ2026-01/specs/<对应规格文件>.md
## 目标
@@ -202,7 +208,7 @@
- [ ] 评论回写所属课题
- [ ] 评论回写所属方向
- [ ] 如稳定规则变化，更新 HWLabOA 总规格
- [ ] 如稳定规则变化，更新 `project-management/PJ2026-01` 中的对应规格文件
```
## 阶段报告章节