---
name: unidesk-oa
description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管理目录、HWLAB OA、总项目规格、总规划、重大项目/方向/课题/子课题层级、任务书、实施方案、测试规格、阶段报告、项目偏离，或通过 project-management 与 GitHub issue 管理 HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理时使用。
---

# UniDesk OA

HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理锚定在 UniDesk 仓库的 `project-management/` 项目编号目录和 GitHub issue 执行记录上。

## 高频规则

- 项目管理稳定事实源按项目编号维护在 `project-management/PJ*/`，GitHub issue 承载执行流和证据索引。
- 重大项目/方向/课题/子课题层级、任务书、实施方案、测试规格、阶段报告和项目偏离按项目编号目录维护。
- 形成多阶段实施、架构或长期 API/数据模型时，先 SPEC，再实现和 issue 阶段计划。
- SPEC 规范性正文只定义预期终态：
  - 目标能力；
  - 稳定边界；
  - 目标架构、数据流和接口；
  - 原子需求；
  - 验收契约。
- SPEC 不得写入执行态内容：
  - 当前实现状态或能力基线；
  - 已完成、未完成和当前阻塞；
  - 临时运行面、本轮差距和一次性证据；
  - 源码路径、作业编号、日志、截图或样片清单。
- 规格生命周期状态与实现进度必须分离：
  - 文档控制可以记录规格已生效、未生效或已废弃；
  - 不得在 SPEC 中增加“实现状态”字段或用目标需求宣称能力已经上线。
- 当前状态进入阶段报告、任务报告、偏离记录或 GitHub issue；验证证据只从这些执行态载体引用 SPEC，不反向写入 SPEC 正文。
- GitHub issue/PR 写入仍走 `$unidesk-gh`；正文必须写目标合并分支/lane。

## Reference 路由

- 项目规划细则读 [references/project-planning.md](references/project-planning.md)。
- 模板读 [references/templates.md](references/templates.md)。

## 常用检查

```bash
find "project-management/${PJ_ID:?请先设置 PJ_ID}" -maxdepth 3 -type f | sort
bun scripts/cli.ts gh issue list --repo pikasTech/unidesk --state open --limit 30
```
