> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能

## 什么是 Skill？

在日常工作中，我们经常反复处理相似任务：写周报、整理文档、生成信息图等。若每次都要重新向 AI 说明需求、偏好和流程，不仅耗时，也容易遗漏关键细节。

Skills（技能）正是为解决这个问题而设计的。Skill 是一份提前写好的工作指南，告诉 QoderWork 在面对某一类任务时：遵循什么步骤、输出什么格式、注意哪些细节。只需定义一次，QoderWork 便能在后续每次对话中自动识别并应用，像训练有素的助手一样稳定、一致地完成工作。

从技术角度看，每个 Skill 本质上是一个包含 `SKILL.md` 文件的文件夹，存放于 `~/.qoderwork/skills/` 目录下。`SKILL.md` 用自然语言描述技能的名称、触发条件和执行步骤——无需写代码，只需将工作经验和流程用文字表达清楚即可。

## Skill 能带来什么？

**告别重复解释**

每次开启新对话，都需要花时间描述需求和偏好。有了 Skill，这些信息被一次性固化下来——后续使用时只需一句话触发，甚至可以自动识别应用，省去大量重复沟通的时间。

**保证输出一致性**

当团队对某类产出有明确的格式、风格要求时（比如周报必须包含哪些板块），Skill 能确保每一次输出都符合既定标准，不会因为沟通偏差或执行者不同而出现质量波动。

**个人经验变成可复用资产**

工作中积累的最佳实践、处理技巧和判断标准，都可以通过 Skill 沉淀下来。它不仅服务于创建者本身，还可以分享给团队成员，让经验在组织内流转复用，而不是停留在个人脑海中。

**让 AI 从「通才」变成「专才」**

QoderWork 本身具备广泛的通用能力，而 Skill 就像给它加装了一个个专业模块——文档处理专家、设计助手、数据分析师等。通过不同的 Skill 组合，QoderWork 可以适配工作中几乎所有的场景。

## 获取 Skill

QoderWork 提供多种获取渠道，从发现到安装一步到位。

### 在对话中搜索安装

直接用自然语言描述需求，QoderWork 通过内置的 find-skill 功能从技能库中检索并推荐最匹配的 Skill，例如：

> 帮我找一个能把网页内容自动转成 Markdown 笔记的 skill\_

QoderWork 会列出匹配结果及简介，确认后可以让 QoderWork 帮你一键安装到 `~/.qoderwork/skills/` 目录，全程无需离开对话窗口。

### 在 Skill 广场浏览安装

在左侧导航的「**扩展**」中点击「**技能**」，进入 Skill 广场——QoderWork 内置的技能市场，汇集官方和社区贡献的各类 Skill。按分类浏览或搜索关键词，找到后点击安装即可使用。

<Frame>
  <img src="https://mintcdn.com/qoder/bCPPFO7nJPA3CbNo/images/5skill.jpg?fit=max&auto=format&n=bCPPFO7nJPA3CbNo&q=85&s=71f2729484cc6010873756c75cc77a7b" alt="5skill" width="1716" height="1274" data-path="images/5skill.jpg" />
</Frame>

### 从开源社区获取

GitHub 等平台上有大量社区共享的 Skill。将仓库链接发给 QoderWork 并告知安装即可，例如：

> 请帮我把 \<技能来源地址> 下载并放到 \~/.qoderwork/skills/ 目录

QoderWork 会自动完成克隆、文件放置和加载，无需手动操作任何命令。

### 手动上传本地文件

已有写好的 Skill 文件时（比如从同事处获取），在左侧导航的「**扩展**」中点击「**技能**」，点击**安装技能**，直接上传 `SKILL.md` 及辅助文件。上传后自动识别并加载，后续在相关场景下即可使用。

## 使用 Skill

Skill 安装完成后，有以下方式在对话中调用。

### 自动触发

直接描述需求，QoderWork 自动判断是否有匹配的 Skill 并启用。例如安装了「简历优化」Skill 后：

> 帮我根据岗位 JD 优化下我的简历

QoderWork 识别并调用相应 Skill。

### / 快捷调用

在对话输入框中输入 `/`，QoderWork 会弹出已安装的 Skill 列表，选择即可调用。

### @ 添加上下文

在对话输入框中输入 `@`，可以添加上下文信息（如文件、文件夹等），帮助 QoderWork 更好地理解你的需求。`@` 用于补充上下文，而非调用 Skill。

### 对话中指定调用

直接在对话中指名使用某个 Skill，例如：

> 使用 kancolle-infographic skill 生成组图

QoderWork 加载指定 Skill 后执行，并将生成结果直接呈现在对话中。

<Note>
  想创建自己的 Skill？请参阅[创建 Skill](/zh/qoderwork/skill-creation) 了解从任务沉淀、对话共创到 SKILL.md 文件格式的完整指南。
</Note>

## 管理 Skill

<Frame>
  <img src="https://mintcdn.com/qoder/s6dTwci-_mbx57qw/images/qoderwork-skills-zh.png?fit=max&auto=format&n=s6dTwci-_mbx57qw&q=85&s=e1ae76f96aea35609bbcd475b3df1b73" alt="QoderWork 技能页：顶部为「技能广场 / 我的技能」标签，下方有「我的安装」「我的创建」筛选项，右侧是搜索框、「我要许愿」与「创建技能」按钮；当前为「我的安装 → 系统内置」，卡片列出 plugin-creator、查找技能、Excel 表格工具、PPT 演示文稿工具、PDF 文件工具、Word 文档工具、vm-error-recovery、技能诊断修复、技能创建助手等内置技能，每张卡片右侧都有开关" width="2000" height="1507" data-path="images/qoderwork-skills-zh.png" />
</Frame>

### 通过文件系统操作

所有 Skill 保存在 `~/.qoderwork/skills/` 目录下，每个 Skill 是一个独立文件夹（包含 `SKILL.md` 及可选辅助文件），可直接在文件系统中增删和编辑。

## 分享 Skill

独家沉淀的工作流不应只留在自己的电脑里。你可以将亲手创建或深度定制的专属技能直接分享给团队成员，对方只需点击链接即可一键安装。

<Steps>
  <Step title="生成分享链接">
    在 **技能** 页面找到你个人创建的技能，点击分享图标，系统会自动生成一个专属的分享链接。
  </Step>

  <Step title="发送给他人">
    点击 **复制链接**，将其发送给同事或朋友。请注意，分享链接具有有效期（通常为 24 小时），过期后需重新生成。
  </Step>

  <Step title="一键安装">
    对方点击该链接，即可直接跳转到 QoderWork 一键完成安装。
  </Step>
</Steps>

## 内置技能

QoderWork 预装了一批内置技能，开箱即用：

| 技能名                        | 功能                     | 触发方式                      |
| :------------------------- | :--------------------- | :------------------------ |
| `docx`                     | 创建、阅读和编辑 Word 文档       | 提到 Word / .docx 时自动触发     |
| `pdf`                      | 阅读、合并、拆分 PDF，加水印       | 提到 PDF 时自动触发              |
| `pptx`                     | 创建和编辑 PowerPoint 演示文稿  | 提到 PPT / 演示文稿时自动触发        |
| `xlsx`                     | 处理 Excel 表格            | 提到 Excel / 表格时自动触发        |
| `find-skills`              | 在技能广场搜索并安装新技能          | 「找一个 skill」「有什么 skill」时触发 |
| `create-skill`             | 互动式引导你创建新技能            | 「创建一个 skill」「写个 skill」时触发 |
| `plugin-creator`           | 创建、定制或修改专家套件           | 涉及创建 / 修改专家套件时触发          |
| `install-skill-dependency` | 诊断并修复技能缺失的依赖、二进制或运行环境  | 技能因缺少依赖而报错时自动触发           |
| `vm-error-recovery`        | 诊断并修复安全工作环境的启动、连接或下载问题 | 安全工作环境异常时自动触发             |

<Tip>
  以上是 QoderWork 当前的内置技能。Skill 广场上还有大量社区贡献的技能等待发现；你也可以直接在对话里说「帮我找一个能做 XX 的 skill」让 QoderWork 替你搜索。
</Tip>

## Skill UI — 交互式界面

部分进阶 Skill 支持渲染交互式 HTML 组件——表单、图表、配置面板等。这些组件会直接嵌入到对话流中，让你无需离开对话即可完成操作。

例如使用 `frontend-design` 技能时，生成的网页预览会直接展示在对话中，你可以即时查看效果并给出反馈进行修改。

## 下一步

<CardGroup cols={3}>
  <Card title="专家套件" icon="briefcase" href="/zh/qoderwork/expert-kits">
    为特定领域工作启用专家套件
  </Card>

  <Card title="连接器" icon="plug" href="/zh/qoderwork/connectors">
    连接浏览器、日历、Microsoft 365、钉钉等外部系统
  </Card>

  <Card title="Hooks" icon="bolt" href="/zh/qoderwork/hooks">
    用 Hooks 在任务关键节点触发自定义动作
  </Card>
</CardGroup>