前言¶
给 AI 助手配连接器、接 Teams、开记忆系统，出问题时只知道「报错了」，但不知道错误码对应什么、该先查哪一项——这类问题在实际使用中很常见。新手入门与使用指南这个 Skill 就是为这类场景准备的：它把 AI 助手客户端的全功能使用说明和故障排查手册放进一个可调用的技能里，适配客户端 5.3.8，让 Agent 在用户提问时直接给出步骤化的答案，而不是让用户自己翻文档。
下面介绍它的定位、覆盖范围、安装启用方式和使用注意事项。
这是什么¶
一句话定位：一个面向 AI 助手客户端的「使用指南 + 故障排查手册」型 Skill，覆盖从首次上手到进阶配置的全场景。
- 名称：新手入门与使用指南
- 坐标：@user_1cfa4650/workbuddy-guide
- 版本：1.0.0
- 来源：community
- 分类：ai-agent
- 发布者：user_1cfa4650
- 官方地址：https://api.skillhub.cn/user_1cfa4650/workbuddy-guide
- SkillHub 页面：https://www.skillhub.cn/skills/user_1cfa4650/workbuddy-guide
- 标签：requires_api_key=false
它解决的不是某个具体接口的调用问题，而是「用户会问什么、该怎么回答」这一类的路由问题：用户问怎么用、怎么配、连不上、报错，或者问自己作为某个角色该怎么用，Skill 给出对应的路线和排障步骤。
核心功能¶
按已核实的资料，Skill 的能力分为四类。
一、场景覆盖¶
覆盖 AI 助手客户端的全场景，包括：
- 连接器
- 专家
- 自动化
- 新手引导
- 环境诊断
- Teams 协作
- 知识库
- 场景模式
- 记忆系统
- 模型选择
- 安全
这十一类基本覆盖了客户端的主要配置面，从首次引导到安全策略都有对应内容。
二、按角色推荐¶
用户表明身份时，Skill 按角色给出使用路线。资料中明确提到六类角色路线图，面向 HR、开发、运营等不同职能，各自有对应的推荐路径，而不是给所有人同一份说明。
三、触发条件¶
在以下三类提问时触发：
- 用户问 AI 助手怎么用、怎么配、连不上、报错
- 用户问「我是 HR/开发/运营怎么用」，按角色推荐
- 用户问人机双写、协同编辑、划词改文档等具体功能
边界不清时，Skill 会先反问确认，而不是直接给一个可能错的答案。这一点对故障排查类场景比较重要：连不上的原因有很多种，先确认现象再给步骤，能避免答非所问。
四、内置排障资产¶
资料中列出的内置内容包括：
- 错误速查表
- 官方错误码
- 53 条 FAQ
- 6 类角色路线图
- 一键诊断脚本
目标是让新手在 45 分钟内完成上手。这个「45 分钟」是官方简介中的表述，实际时长取决于用户的具体环境。
安装与启用¶
来源与访问¶
Skill 托管在 SkillHub 上，来源为 community，由 user_1cfa4650 发布，坐标 @user_1cfa4650/workbuddy-guide。安装入口：
SkillHub 页面：https://www.skillhub.cn/skills/user_1cfa4650/workbuddy-guide
API 地址：https://api.skillhub.cn/user_1cfa4650/workbuddy-guide
页面上提供了安装入口，按平台提示操作即可。预抓取资料中没有给出具体的 CLI 安装命令，本文不臆造；以页面上的实际安装按钮或命令为准。
API Key¶
标签 requires_api_key=false，意味着使用这个 Skill 不需要单独配置 API key。这一点对排障场景比较实用：诊断脚本和错误码查询不依赖额外的密钥配置，装上就能用。
适配版本¶
资料明确标注适配客户端 5.3.8。如果你使用的是其他版本的客户端，功能入口和界面可能与指南中的描述不一致，建议先确认自己的客户端版本。
典型用法¶
这个 Skill 的用法不是命令行交互，而是作为 Agent 的技能被调用。以下是基于官方简介的可复现用法类型：
用法一：排障提问¶
用户说「AI 助手连不上」，Skill 触发后走错误速查表 + 官方错误码 + 一键诊断脚本，给出从环境诊断开始的排查步骤。一键诊断脚本的作用是自动收集环境信息，减少用户手工逐项排查的工作量。
用法二：角色路线提问¶
用户说「我是 HR，该怎么用」，Skill 触发后按角色路线图给出推荐路径，而不是罗列全部功能。六类角色路线图对应不同职能的使用侧重点。
用法三：具体功能提问¶
用户问人机双写、协同编辑、划词改文档，Skill 直接给出这几个功能的操作说明。这类问题通常不需要反问，可以直接回答。
用法四：边界不清时反问¶
用户的问题描述不够具体，比如只说「出问题了」但没有说明现象或报错信息，Skill 会先反问确认，再进入排查流程。
适用场景与注意¶
适合谁¶
- 首次使用 AI 助手客户端、需要快速上手的人
- 客户端出问题、希望按步骤排查的使用者
- 需要按角色找到合适使用路径的 HR、开发、运营等职能人员
- 负责客户端配置和运维、需要错误码对照的人
注意事项¶
第一，Skill 的内容以官方简介为准，其中「45 分钟上手」是官方表述，实际时长因人而异。第二，评分和下载量在 SkillHub 页面上是动态变化的：预抓取时显示评分 100000、下载 42101，历史数据可能与当前页面不一致，以页面实时数据为准。第三，简介末尾提到「如需 Agent 增强完整工作流套件（13 模块 61 技能），淘宝搜索「AI灵匣」店铺获取完整版」——这是一个付费的附加套件，与本 Skill 本体不是同一个东西，本 Skill 本体是免费的使用指南与排障手册。第四，资料中没有说明该 Skill 在不同客户端平台（如 Teams、桌面端、移动端）上的行为差异，本文不展开。
结尾¶
这个 Skill 的价值在于把「使用指南 + 故障排查手册」做成了可被 Agent 调用的技能：错误速查表、官方错误码、53 条 FAQ、6 类角色路线图和一键诊断脚本都内置其中，覆盖连接器、Teams 协作、记忆系统、模型选择、安全等主要场景，边界不清时会先反问确认。对需要快速上手或排查 AI 助手客户端问题的使用者来说，它比手动翻文档更快。
官方地址：https://api.skillhub.cn/user_1cfa4650/workbuddy-guide
