pikastech
53 lines
2.9 KiB
Markdown
53 lines
2.9 KiB
Markdown
---
|
||
name: unidesk-oa
|
||
description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管理目录、HWLAB OA、总项目规格、总规划、重大项目/方向/课题/子课题层级、任务书、实施方案、测试规格、阶段报告、项目偏离、产品/前端设计 spec、CaseRun、HarnessRL、AgentRun、Temporal、native 调试，或通过 project-management 与 GitHub issue 管理 HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理时使用。
|
||
---
|
||
|
||
# UniDesk OA
|
||
|
||
HWLAB Cloud M1 / UniDesk / AgentRun 跨仓项目治理锚定在 UniDesk 仓库的 `project-management/` 项目编号目录和 GitHub issue 执行记录上。
|
||
|
||
## 触发与前置
|
||
|
||
出现以下任一语义时必须加载本 skill，并先读取对应 `project-management/PJ*/specs/` 规格再写代码：
|
||
|
||
- HWLAB、UniDesk、AgentRun、HarnessRL、CaseRun、Temporal、跨仓库或 v0.2/v0.3 能力迁移。
|
||
- 新页面、前端重设计、交互/视觉设计、Web/API/CLI 统一入口、native/L1 调试形态。
|
||
- 新增或改变长期 API、数据模型、运行生命周期、验收契约、架构边界或多阶段交付。
|
||
|
||
仅有一次性修复时，也要先确认所属 L1 规格和主责边界；找不到对应规格时先登记规格缺口，不得用源码注释或 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
|
||
```
|