メニュー
工作文档枢纽，强制执行 SSOT（Single Source of Truth）原则，管理 `docs/` 目录下的架构决策、设计文档、Issues（任务规划）、PRs（变更记录）。支持 GitHub 协作开发模式。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/Dwsy/agent --skill workhubコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | workhub |
| description | 工作文档枢纽，强制执行 SSOT（Single Source of Truth）原则，管理 `docs/` 目录下的架构决策、设计文档、Issues（任务规划）、PRs（变更记录）。支持 GitHub 协作开发模式。 |
文档管理与任务跟踪工具，强制执行 SSOT（Single Source of Truth）原则，支持 GitHub 风格的 Issues 和 PRs 工作流。
| 路径类型 | 路径 | 基准目录 |
|---|---|---|
| 技能目录 | ~/.pi/agent/skills/workhub/ | 固定位置 |
| 主脚本 | ~/.pi/agent/skills/workhub/lib.ts | 技能目录 |
| 项目文档目录 | ./docs/ | 工作目录 (执行命令时的当前目录) |
docs/
├── adr/ # 架构决策记录
├── architecture/ # 架构设计文档
├── issues/ # 任务跟踪
│ ├── [模块分类]/ # 可选：按模块分类
│ │ └── yyyymmdd-[描述].md
│ └── yyyymmdd-[描述].md
├── pr/ # 变更记录
│ ├── [模块分类]/
│ │ └── yyyymmdd-[描述].md
│ └── yyyymmdd-[描述].md
└── guides/ # 使用指南
# 正确方式：从项目目录执行
cd /path/to/your/project
~/.pi/agent/skills/workhub/lib.ts <command>
init)创建标准文档目录结构。
~/.pi/agent/skills/workhub/lib.ts init
tree)显示文档目录树。
~/.pi/agent/skills/workhub/lib.ts tree
audit)检查 docs/ 文件夹是否遵循标准规范。
~/.pi/agent/skills/workhub/lib.ts audit
read)通过关键词或相对路径读取文档。
~/.pi/agent/skills/workhub/lib.ts read issues/20250106-添加深色模式.md
create issue)创建新的 Issue 文件，自动使用模板。
~/.pi/agent/skills/workhub/lib.ts create issue "添加深色模式" 前端
create pr)创建新的 PR 文件，自动使用模板。
~/.pi/agent/skills/workhub/lib.ts create pr "修复登录bug" 后端
list issues)列出所有 Issues 及其状态。
~/.pi/agent/skills/workhub/lib.ts list issues
list prs)列出所有 PRs 及其状态。
~/.pi/agent/skills/workhub/lib.ts list prs
status)显示所有 Issues 和 PRs 的状态概览。
~/.pi/agent/skills/workhub/lib.ts status
search)在 Issues 和 PRs 中搜索关键词。
~/.pi/agent/skills/workhub/lib.ts search "深色模式"
1. 创建 Issue 文件 (使用模板)
→ docs/issues/yyyymmdd-[描述].md
或 docs/issues/[模块分类]/yyyymmdd-[描述].md
2. 填写 Goal、Phases、Acceptance Criteria
3. 执行阶段：
- Read Issue 文件（刷新目标）
- 完成子任务 → 更新复选框 [x]
- 遇到错误 → 记录到 "Errors Encountered"
- 记录 Notes → 保存研究发现
4. 完成后创建 PR 文件
→ docs/pr/yyyymmdd-[描述].md
5. PR 文件关联 Issue 文件名
→ 包含回滚计划、测试验证
1. 创建 PR 文件 (使用模板)
→ docs/pr/yyyymmdd-[描述].md
或 docs/pr/[模块分类]/yyyymmdd-[描述].md
2. 填写背景、变更内容、测试验证、回滚计划
3. 关联 Issue 文件名
→ 在 "关联 Issue" 中填写完整路径
4. 代码审查和合并
→ 记录审查日志
→ 更新最终状态
workhub read 读取# 1. 初始化文档结构（首次）
~/.pi/agent/skills/workhub/lib.ts init
# 2. 创建 Issue 文件
~/.pi/agent/skills/workhub/lib.ts create issue "添加深色模式" 前端
# 3. 编辑文件，填写 Goal、Phases、Acceptance Criteria
# 1. 读取 Issue（刷新目标）
~/.pi/agent/skills/workhub/lib.ts read issues/前端/20250106-添加深色模式.md
# 2. 完成子任务后更新 Issue
# 编辑文件，标记复选框 [x]
# 3. 遇到错误时记录
# 在 "Errors Encountered" 表格中添加记录
# 1. 创建 PR 文件
~/.pi/agent/skills/workhub/lib.ts create pr "添加深色模式" 前端
# 2. 编辑文件，填写变更内容、测试验证、回滚计划
# 3. 关联 Issue 文件名
# 在 "关联 Issue" 中填写完整路径
# 1. 读取 Issue
~/.pi/agent/skills/workhub/lib.ts read issues/20250106-添加深色模式.md
# 2. 在 "Errors Encountered" 中记录
| 日期 | 错误 | 解决方案 |
| 2025-01-06 | FileNotFoundError | 创建默认配置 |
# 3. 执行解决方案
# 创建默认配置文件
# 4. 更新 Issue 的 Notes
| 命令 | 功能 | 示例 |
|---|---|---|
init | 初始化文档结构 | ~/.pi/agent/skills/workhub/lib.ts init |
tree | 查看文档结构 | ~/.pi/agent/skills/workhub/lib.ts tree |
audit | 审计文档规范 | ~/.pi/agent/skills/workhub/lib.ts audit |
read | 读取文档 | ~/.pi/agent/skills/workhub/lib.ts read issues/xxx.md |
create issue | 创建 Issue | ~/.pi/agent/skills/workhub/lib.ts create issue "描述" [分类] |
create pr | 创建 PR | ~/.pi/agent/skills/workhub/lib.ts create pr "描述" [分类] |
list issues | 列出所有 Issues | ~/.pi/agent/skills/workhub/lib.ts list issues |
list prs | 列出所有 PRs | ~/.pi/agent/skills/workhub/lib.ts list prs |
status | 查看整体状态 | ~/.pi/agent/skills/workhub/lib.ts status |
search | 搜索内容 | ~/.pi/agent/skills/workhub/lib.ts search "关键词" |
未来可能添加的功能：