pikasTech-unidesk/.agents/skills/unidesk-oa/SKILL.md

name, description

name	description
unidesk-oa	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/templates.md。

常用检查

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