Workhub 是文档管理与任务跟踪工具,强制执行 SSOT(Single Source of Truth)原则,支持 GitHub 风格的 Issues 和 PRs 工作流。
用途与结构:主脚本位于 ~/.pi/agent/skills/workhub/lib.ts,项目文档目录为执行命令时的当前目录下的 ./docs/。标准结构包含 adr/(架构决策记录)、architecture/(架构设计)、issues/(任务跟踪,可选模块分类,文件名形如 yyyymmdd-[描述].md)、pr/(变更记录,同样支持分类)、guides/(使用指南)。
主要能力:init 初始化标准目录;tree 显示文档目录树;audit 审计 docs/ 是否遵循规范;read 按关键词或相对路径读取文档;create issue / create pr 使用模板创建文件(可带分类参数);list issues / list prs 列出条目及状态;status 显示整体概览;search 在 Issues 与 PRs 中搜索关键词。
使用方式:需从项目目录执行,例如 cd /path/to/your/project 后运行 ~/.pi/agent/skills/workhub/lib.ts <command>。常用命令包括 ~/.pi/agent/skills/workhub/lib.ts init、tree、audit、read issues/20250106-添加深色模式.md、create issue "添加深色模式" 前端、create pr "修复登录bug" 后端、list issues、list prs、status、search "深色模式"。
工作流:创建 Issue 后填写 Goal、Phases、Acceptance Criteria;执行阶段读取 Issue 刷新目标,完成子任务标记复选框 [x],错误记录到 Errors Encountered,Notes 保存研究发现;完成后创建 PR 文件,关联 Issue 文件名,填写背景、变更内容、测试验证与回滚计划。
核心原则:每个知识领域只有一个权威文档,Issues 是任务跟踪唯一来源,PRs 是变更记录唯一来源;文件系统即记忆,大输出保存到文件而非堆砌上下文,需要时用 read 读取;决策前读取 Issue,行动后更新状态,错误记录可追溯;每个 PR 必须关联 Issue。
限制:资料未提供收费、价格、平台兼容性等信息,暂未提供。扩展计划(交互式创建 Issue/PR、关联 Issue 和 PR)为未来可能功能,尚未提供。