workhublisted

# Workhub 文档管理与任务跟踪工具，强制执行 SSOT（Single Source of Truth）原则，支持 GitHub 风格的 Issues 和 PRs 工作流。 ## 执行环境 | 路径类型 | 路径 | 基准目录 | |---------|------|---------| | **技能目录** | `~/.pi/agent/skills/workhub/` | 固定位置 | | **主脚本** | `~/.pi/agent/skills/workhub/lib.ts` | 技能目录 | | **模板目录** | `~/.pi/agent/skills/workhub/templates/` | 技能目录 | | **项目文档目录** | `./docs/` | **工作目录** (执行命令时的当前目录) | ## 重要区分 ``` 注意：这是两个完全不同的目录！ 1. 脚本位置（固定）：~/.pi/agent/skills/workhub/lib.ts - 这个文件在技能安装目录中，不会移动 2. 文档位置（可变）：./docs/ - 这个目录在**执行命令时的当前目录**中 - 即用户的项目根目录 ``` ## 标准文档结构 ``` docs/ ├── adr/ # 架构决策记录 (Architecture Decision Records) │ └── yyyymmdd-[decision].md ├── architecture/ # 架构设计文档 │ ├── boundaries.md │ └── data-flow.md ├── issues/ # 任务跟踪 (GitHub Issues 风格) │ ├── [模块分类]/ # 可选：按职责模块分类（前端/后端/数据库等） │ │ └── yyyymmdd-[描述].md │ └── yyyymmdd-[描述].md # 或直接在 issues/ 根目录 ├── pr/ # 变更记录 (GitHub PR 风格) │ ├── [模块分类]/ # 可选：按职责模块分类（前端/后端/数据库等） │ │ └── yyyymmdd-[描述].md │ └── yyyymmdd-[描述].md # 或直接在 pr/ 根目录 └── guides/ # 使用指南 └── [topic].md ``` **说明：** - `issues/` 和 `pr/` 目录可以包含子目录分类 - 常见分类方式：按职责模块（前端/后端/数据库/运维）、按功能模块（用户系统/订单系统/支付系统） - 如果项目规模较小，可以直接在 `issues/` 和 `pr/` 根目录下创建文件 - 如果项目规模较大或有明确模块划分，建议使用子目录分类 ## 调用命令 ```bash # 正确方式 1：从项目目录执行（推荐） cd /path/to/your/project ~/.pi/agent/skills/workhub/lib.ts tree # 查看文档结构 ~/.pi/agent/skills/workhub/lib.ts audit # 审计文档规范 ~/.pi/agent/skills/workhub/lib.ts