前言¶

在 SkillHub 或 WorkBuddy 里装了不少 Skill 之后，常见问题是：不知道哪个 Skill 适合当前任务、安装路径不对导致 Agent 读不到、版本散落难以升级，组合多个 Skill 时也容易踩坑。自己翻文档、逐个试装，成本高且难沉淀经验。

下面介绍 SkillHub 上架的 WorkBuddySkill使用管理指南（坐标 @org-gv4zgi7j/workbuddy-assistant）。它面向「围绕真实任务」的 Skill 使用与管理，把选择、安装、调用、组合和维护放在同一条工作流里，适合作为 WorkBuddy 生态里的 skill-assistant 使用助理来启用。

这是什么¶

一句话定位：WorkBuddy Skill 使用管理指南，帮助你在真实任务场景下完成 Skill 的选择、安装、调用、组合与维护。

• 维护方：积木Skill（SkillHub 页面标注为作者）
• 坐标：@org-gv4zgi7j/workbuddy-assistant
• 当前版本：6.8.1（以 SkillHub 页面为准）
• 分类：ai-agent
• 来源：enterprise
• 依赖：标签 requires_api_key=false，无需额外 API Key

SkillHub 统计（抓取资料）：评分 100000，下载 48370 次。页面与坐标以 SkillHub 技能页 为准；官方条目地址为 https://api.skillhub.cn/org-gv4zgi7j/workbuddy-assistant。

核心功能¶

以下能力均来自官方简介，不展开未在资料中出现的细则：

1. 选择：按当前任务判断该用哪些 Skill，减少盲目搜索与试装。
2. 安装：配合 SkillHub 安装流程，把 Skill 装到当前 Agent 能识别的目录。
3. 调用：在对话或工作流里正确触发已安装的 Skill。
4. 组合：多个 Skill 协同完成复杂任务时的搭配思路。
5. 维护：跟进 Skill 的安装位置、版本与升级，避免「装了但 Agent 不加载」。

该 Skill 采用通用 SKILL.md 格式，由 Agent 读取后按指南执行，而不是单独跑一个本地服务。

安装与启用¶

1、安装 SkillHub CLI（如尚未安装）¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需要 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明：限网环境需使用允许访问外网的终端执行上述命令。更完整的优先源与首次配置说明见 SkillHub 安装与优先源配置。

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录；默认装到 ./skills/ 时，多数客户端不会自动加载。

skillhub install @org-gv4zgi7j/workbuddy-assistant --dir <你的 skills 目录>

常见路径（来自 SkillHub 安装文档，按你当前客户端选用其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• workbuddy：~/.workbuddy/skills/

示例（Cursor 用户）：

skillhub install @org-gv4zgi7j/workbuddy-assistant --dir ~/.cursor/skills/

3、通过对话让 AI 代为安装（官方页面方式）¶

SkillHub 技能页提供的提示词为：让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @org-gv4zgi7j/workbuddy-assistant。适合已习惯「把安装说明交给 Agent 执行」的场景；无论 CLI 还是提示词安装，最终仍须保证 Skill 落在上述正确的 skills 目录。

安装或更新后，按你所用客户端的要求重启或刷新 Agent，使其重新加载 Skill 列表。

典型用法¶

经过上面的步骤启用本 Skill 后，可以把具体任务交给 Agent，由指南约束其回答范围。可复现的入口如下。

方式 A：用自然语言描述任务 + 已安装的助理 Skill

在已加载 @org-gv4zgi7j/workbuddy-assistant 的会话中，直接说明真实任务，例如：

• 「我要在 Cursor 里做某某开发任务，请根据 WorkBuddy Skill 使用管理指南，推荐应安装哪些 Skill，并给出 skillhub install 的 --dir 路径。」
• 「我已在 ~/.cursor/skills/ 安装了若干 Skill，请帮我梳理调用顺序，并说明如何检查是否被 Agent 识别。」

方式 B：从官方安装提示词起步

将 SkillHub 页面给出的安装说明发给 AI，完成安装后再提出与选择、组合、维护相关的问题。这与页面「将提示词发送给你的 AI 安装该 skills」的流程一致。

上述示例只使用资料中出现的坐标、文档 URL 与目录约定，不假设额外的配置文件或子命令。

适用场景与注意¶

适合谁

• 使用 WorkBuddy 或 SkillHub，希望在同一套对话里完成 Skill 选型与维护的开发者。
• 已安装多个 Skill，需要按任务整理「装在哪、怎么调、如何升级」的用户。
• 分类为 ai-agent，希望 Agent 侧统一管理 Skill 生态的场景。

限制与注意

1. 目录：未指定正确 --dir 是最常见的「装了却无效」原因，安装前务必对照当前客户端的 skills 路径。
2. 版本：文中版本 6.8.1 来自 SkillHub 页面；升级后以 SkillHub 展示为准，可用 skillhub 的更新能力（参见安装文档第三节）处理。
3. 资料范围：本介绍未包含 SKILL 正文中的逐步检查清单或推荐组合表；启用后行为以安装包内 SKILL.md 为准。
4. 统计数字：下载量、评分会随 SkillHub 更新变化，引用时以技能页实时数据为准。

结尾¶

skill-assistant 使用助理在 SkillHub 上的正式名称是 WorkBuddySkill使用管理指南：用 @org-gv4zgi7j/workbuddy-assistant 把 Skill 的选择、安装、调用、组合和维护串成可执行流程，并依托 SkillHub 的安装规范减少路径错误。

• SkillHub 技能页：https://www.skillhub.cn/skills/org-gv4zgi7j/workbuddy-assistant
• 官方条目：https://api.skillhub.cn/org-gv4zgi7j/workbuddy-assistant
• 安装说明：https://skillhub.cn/install/skillhub.md