# Agent Skills

> 本指南介绍如何在 Qwen Code 中创建、使用和管理 Agent Skills。Skills 是模块化的功能，通过包含指令（以及可选的脚本/资源）的有序文件夹来扩展模型的能力。

- 网址：https://funcoding.ai/agents/qwen-code/users/features/skills/
- 来源：Qwen Code 官方文档原文（中文），Apache-2.0 许可，同步于 2026-10-11
- 官方原文：https://qwenlm.github.io/qwen-code-docs/zh/users/features/skills

---
> 创建、管理和共享 Skills 以扩展 Qwen Code 的功能。

本指南介绍如何在 **Qwen Code** 中创建、使用和管理 Agent Skills。Skills 是模块化的功能，通过包含指令（以及可选的脚本/资源）的有序文件夹来扩展模型的能力。

## 前提条件

- Qwen Code（最新版本）
- 熟悉 Qwen Code 的基本使用（[快速入门](https://funcoding.ai/agents/qwen-code/users/quickstart/)）

## 什么是 Agent Skills？

Agent Skills 将专业知识打包为可发现的功能。每个 Skill 由一个包含指令的 `SKILL.md` 文件组成，模型可以在相关时加载这些指令，此外还可以包含脚本和模板等可选的支持文件。

### Skills 的调用方式

Skills 是**由模型调用**的 —— 模型会根据你的请求和 Skill 的描述自主决定何时使用它们。这与斜杠命令不同，斜杠命令是**由用户调用**的（你需要显式输入 `/command`）。

如果你想显式调用某个 Skill，可以使用 Skill 的名称将其作为斜杠命令输入：

```bash
/<skill-name>
```

开始输入 `/` 即可自动补全并浏览可用的 Skills 及其描述。`/skills` 命令会打开 Skills 面板，你可以在其中交互式地浏览、搜索、切换和启动 Skills。

> **注意：** 如果你之前使用 `/skills <skill-name>` 运行过 Skill，该语法现在只会打开 Skills 面板并忽略尾部参数。请使用 `/<skill-name>` 直接运行 Skill。

`<skill-name>` 始终是 Skill 的注册名称。对于来自已安装扩展的 Skill，该名称包含其所有者 —— `rust:pdf` 而非 `pdf` —— 因此你需要输入 `/rust:pdf`。请参见[扩展 Skills 的命名方式](#how-extension-skills-are-named)。

### 优势

- 针对你的工作流扩展 Qwen Code
- 通过 git 在团队中共享专业知识
- 减少重复的提示词编写
- 组合多个 Skills 以处理复杂任务

## 创建 Skill

Skills 以包含 `SKILL.md` 文件的目录形式存储。

### 使用 `/learn` 生成项目 Skill

使用 `/learn` 将现有知识源提炼为可复用的项目 Skill：

```text
/learn https://docs.example.com/api
/learn ~/projects/acme-sdk
/learn Our deploy process: run migrate, deploy the service, then check health
```

该命令作为普通 agent 轮次运行，并在 `.qwen/skills/learned-skill-<name>/SKILL.md` 下创建结果，frontmatter 中包含 `source: learned`。在使用或分享生成的指令之前，请先审查它们。

`/learn` 还接受本地或直链的 `.mp4`、`.webm`、`.mov` 和 `.m4v` 视频。在路径或 URL 后添加文本，可将生成的 Skill 聚焦于教程的某一部分：

```text
/learn ./tutorial.mp4 focus on the deployment workflow
```

视频学习需要兼容 OpenAI 的提供商提供的支持视频的模型。YouTube 页面 URL 不是直接视频输入；请将视频下载到工作区并传递其本地路径。

### 个人 Skills

个人 Skills 在所有项目中均可用。将它们存储在 `~/.qwen/skills/` 中：

```bash
mkdir -p ~/.qwen/skills/my-skill-name
```

个人 Skills 适用于：

- 你个人的工作流和偏好
- 你正在开发的 Skills
- 个人效率辅助工具

### 项目 Skills

项目 Skills 与你的团队共享。将它们存储在项目中的 `.qwen/skills/` 目录下：

```bash
mkdir -p .qwen/skills/my-skill-name
```

项目 Skills 适用于：

- 团队工作流和规范
- 项目特定的专业知识
- 共享的实用工具和脚本

项目 Skills 可以提交到 git，并自动对团队成员可用。

### 维护自动生成的项目 Skills

Qwen Code 在本地跟踪生成的项目 Skills 的成功使用情况，包括在 Auto Skill 生成被禁用期间也是如此，因此重新启用维护不会将最近使用的 skill 误判为不活跃的。当 **Auto Skill** 启用时，它会周期性地将不活跃的生成 Skills 移出活跃库。仅管理名为 `.qwen/skills/auto-skill-*` 且 `SKILL.md` frontmatter 包含 `source: auto-skill` 的目录；个人、扩展、内置和手工编写的 Skills 永远不会被选中。

- 在 30 天内没有成功使用或 `SKILL.md` 编辑的 auto-skill 会被标记为 stale。
- 在 90 天后，其完整目录会被移动到 `.qwen/archived-skills/`。不会永久删除任何内容。
- 自动维护在可信工作区中最多每 7 天运行一次。每个新观察到的 auto-skill 在维护开始前会获得完整的宽限期。
- 被 pin 的 auto-skill 会被排除在自动 stale 和归档转换之外，直到它被 unpin。
- 归档的目录名称保持保留，已存在的归档目标仅跳过该冲突，而不会停止其他 skills 的维护。

使用 `/curator` 查看 active、stale、archived 和 pinned 的 auto-skills。运行 `/curator run --dry-run` 预览维护过程，`/curator run` 立即应用，`/curator pin <directory>` 或 `/curator unpin <directory>` 控制每个 skill 的维护，或 `/curator restore <directory>` 将归档的 auto-skill 移回活跃库。

状态和 dry-run 预览在安全模式和不可信工作区中可用。应用维护、更改 pin 和恢复归档的 auto-skills 需要可信工作区且不在安全模式下。

## 编写 SKILL.md

创建一个包含 YAML frontmatter 和 Markdown 内容的 `SKILL.md` 文件：

```yaml
---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
priority: 10
---

# Your Skill Name

## Instructions
Provide clear, step-by-step guidance for Qwen Code.

## Examples
Show concrete examples of using this Skill.
```

### 字段要求

Qwen Code 目前会验证以下内容：

- `name` 必须是非空字符串，且匹配 `/^[\p{L}\p{N}_:.-]+$/u` —— 支持 Unicode 字母和数字（中日韩/西里尔/带音标的拉丁字母均可），以及 `_`、`:`、`.`、`-`。空格、斜杠、括号和其他结构上不安全的字符会在解析时被拒绝。允许的 `:` 使得扩展注册的 Skill（`rust:pdf`）和作者自己选择冒号的 Skill（在 `rust` 扩展内编写的 `rust:chat`）可以共享同一模式，因此注册名称中的冒号并不能证明所有者 —— 请参见[扩展 Skills 的命名方式](#how-extension-skills-are-named)。
- `description` 必须是非空字符串
- `priority` 是可选的。如果存在，它必须是一个有限数字。较高的值仅在 `/skills` 列表中排序靠前 —— 斜杠命令补全（输入 `/`）和 `/help` 自定义命令视图保持字母顺序，因此高优先级的 Skill 永远不会重新排序内置命令。省略或无效的值将被视为未设置，其行为类似于 `0`。

推荐的命名规范：

- 对于可共享的名称，优先使用带连字符的小写 ASCII 字符（例如 `tsx-helper`）
- 使 `description` 具体化：同时包含 Skill 的**功能**和**使用时机**（用户自然会提到的关键词）
- 谨慎使用 `priority`，仅用于那些需要可靠地出现在 `/skills` 默认字母顺序之前的 Skills。允许使用负优先级，它们会排在未设置优先级的 Skill 之后。

### 可选：通过文件路径限制 Skill (`paths:`)

对于仅与代码库特定部分相关的 Skills，添加一个 `paths:` glob 模式列表。在工具调用触及匹配的文件之前，该 Skill 不会出现在模型的可用 Skills 列表中：

```yaml
---
name: tsx-helper
description: React TSX component helper
paths:
  - 'src/**/*.tsx'
  - 'packages/*/src/**/*.tsx'
---
```

注意事项：

- Glob 模式使用 [picomatch](https://github.com/micromatch/picomatch) 相对于项目根目录进行匹配；项目根目录之外的文件永远不会触发激活。
- 路径限制的 Skill 一旦触及匹配文件，就会在**当前会话的剩余时间内保持激活状态**。新会话，或通过编辑任何 Skill 文件触发的 `refreshCache`，会重置激活状态。
- `paths:` 仅限制**模型**的发现，且仅在 SkillTool 列表级别生效。除非设置了 `user-invocable: false`，否则你始终可以通过 `/<skill-name>` 或 `/skills` 选择器自己调用路径限制的 Skill —— 该用户路径会无视激活状态直接运行 Skill 主体。然而，模型端会保持限制，直到触及匹配文件：斜杠调用**不会**解锁模型端的激活，因此如果你希望模型在你的调用之后进行链式调用（自己调用 `Skill { skill: ... }`），请先访问一个匹配该 Skill `paths:` 的文件。
- 将 `paths:` 与 `disable-model-invocation: true` 结合使用是允许的，但限制不生效 —— 无论如何该 Skill 都对模型隐藏，因此路径激活永远不会宣传它。

### 可选：控制用户和模型调用

Skills 默认允许用户调用。要将 Skill 从直接的斜杠命令使用中隐藏，同时保持其对模型调用可用，请设置 `user-invocable: false`：

```yaml
---
name: model-only-helper
description: Helper the model can call when appropriate
user-invocable: false
---
```

这会从 `/<skill-name>` 调用和 `/skills` 选择器结果中移除该 Skill。它不会向模型隐藏该 Skill。

要向模型隐藏 Skill 同时保持直接的用户调用可用，请设置 `disable-model-invocation: true`：

```yaml
---
name: manual-helper
description: Helper you invoke manually
disable-model-invocation: true
---
```

你可以结合这两个字段，但这样该 Skill 就无法通过正常的用户或模型调用路径访问了。

### 可选：确定性强制执行规则（`hooks:`）

`SKILL.md` 主体中的所有内容都是对模型的指令：它们是提示文本，因此是否遵循取决于模型。当某条规则必须无条件成立时 —— 例如除非注入了必需值否则拒绝运行，或者永远不要触及受保护路径 —— 请在 frontmatter 中声明一个 [hook](https://funcoding.ai/agents/qwen-code/users/features/hooks/)。Hooks 以代码方式运行，因此不依赖模型的配合：

```yaml
---
name: gated-skill
description: Calls the downstream CLI using a runtime-injected session ID
hooks:
  PreToolUse:
    - matcher: run_shell_command
      hooks:
        - type: command
          command: '"$QWEN_SKILL_ROOT/scripts/gate-session-id.sh"'
---
```

`$QWEN_SKILL_ROOT` 被设置为 Skill 自身的目录，因此 hook 命令可以引用与 `SKILL.md` 一起提供的文件。命令字符串会被传递给 shell，因此**保留内部引号**：如果不加引号，包含空格的项目路径会被拆分为两个单词，导致 gate 永远不会运行。**还要使脚本可执行**（`chmod +x`）。这两种错误都会以相同的方式 fail-open：工具调用会继续执行，而 transcript 或日志中不会有任何信息表明 gate 没有运行。`PreToolUse` hook 在退出码为 `2` 时会阻止工具调用（stderr 会作为原因反馈给模型），或者当它打印 `hookSpecificOutput.permissionDecision: "deny"` 时也会阻止：

```bash
#!/usr/bin/env bash
if [ -z "${DOWNSTREAM_SESSION_ID:-}" ]; then
  echo "Required input DOWNSTREAM_SESSION_ID is not available. Cannot proceed." >&2
  exit 2
fi
exit 0
```

注意事项：

- Hooks 在 Skill 被调用时注册，并在会话的剩余时间内持续有效。这在两条调用路径上都成立 —— 无论是模型调用 Skill 还是你输入 `/<skill-name>`。
- 使用 `--continue` / `--resume` 恢复会话时，会重新应用**模型**通过 Skill 工具加载的每个 Skill 的两部分 —— `allowedTools` 允许规则和 `hooks:` —— 因为这些调用在对话中被记录为工具调用。这些授权仅在恢复的会话中有效，与实时调用相同。你自己通过 `/<skill-name>` 启动的 Skill 会作为普通提示提交，不会留下工具调用记录，因此不会被恢复 —— 恢复后请重新运行 `/<skill-name>` 以重新启用其 gate。
- 对于当前新工具调用会拒绝的 Skill（已禁用、通过 `disable-model-invocation` 对模型隐藏、或尚未激活的 `paths:` Skill）、文件夹不再受信任的**项目** Skill、或记录的主体与 `SKILL.md` 中的主体不匹配的 Skill（因为被编辑过，或因太长而为模型截断），Resume 不会重新应用它们。在这些情况下，声明了 `hooks:` 或 `allowedTools` 的 Skill 会留下一行调试日志说明原因。Resume 还会跳过（不留日志）从 `exec` 脚本内部加载的 Skill 以及不再被发现的 Skill（例如已被移除或重命名的）。匹配仅覆盖主体，因此仅编辑 frontmatter 会使用新的 `allowedTools` 和 `hooks:` 重新应用。
- 注册是幂等的：重新调用 Skill 不会堆叠重复的 hooks。
- Skill hook 的 `matcher:` 遵循与设置 hook 相同的规则（请参见 [Hooks](https://funcoding.ai/agents/qwen-code/users/features/hooks/)）。省略或空的 `matcher:` 会匹配所有工具，且 matcher 不是锚定的，因此 `edit` 也会匹配 `notebook_edit`。Skill hooks 过去将其 matcher 包装在 `^…` 中以精确匹配一个工具，并在省略时不匹配任何内容：写 `^edit` 精确匹配一个工具，写排除项 `^(?!write_file).*` 在省略时不匹配任何内容。
- `command:` 通过平台 shell 运行：macOS 和 Linux 上使用 `bash`，Windows 上如果检测到 Git Bash（通过 `MSYSTEM`/`TERM`）也使用它，否则使用 `cmd.exe` 或 PowerShell。上面的示例是 POSIX shell —— 在 `cmd.exe` 下 `$QWEN_SKILL_ROOT` 不会被展开，`.sh` 脚本也不可执行，因此 gate 会在那里 fail-open。Hook 可以设置 `shell: bash` 来强制使用 bash，但这会解析为 `PATH` 上的任何 `bash`，因此在 Windows 上（Git Bash 之外）请为你实际使用的 shell 编写 gate。
- 禁用 hooks 的会话不会注册任何 hooks —— 包括 `disableAllHooks`、安全模式以及 ACP 客户端的 `skipHooks`。Skill 的主体及其 `allowedTools` 在这些会话中仍然有效，但其 gate 不会生效，因此你依赖 hook 强制执行的规则在那里不会被强制执行。Bare 模式更进一步：根本不会发现任何 Skills，因此既没有主体也没有 `allowedTools`。
- **项目** Skill 的 hooks 运行仓库提供的命令，因此它们仅在 trusted folder 中注册，并且信任状态会在每次 hook 触发和每次权限决策时重新读取。当有 IDE companion 连接时，该值是实时的：撤销信任会在下一次工具调用时静默已注册的 gate —— 并暂停 Skill 的 `allowedTools` —— 无需重启。没有 IDE 连接时，该值在 CLI 启动时固定，因此通过 CLI 自身的信任对话框进行的更改会在重启时生效。授予信任永远不会追溯注册：请再次调用 Skill。
- `hooks:` 适用于项目、用户和内置 Skills。扩展提供的 Skills 不支持它；请改用扩展自身的 manifest 级别 hooks。
- 完整的事件列表、matcher 语法和输出格式，请参见 [Hooks](https://funcoding.ai/agents/qwen-code/users/features/hooks/)。

## 添加支持文件

在 `SKILL.md` 旁边创建其他文件：

```text
my-skill/
├── SKILL.md (required)
├── reference.md (optional documentation)
├── examples.md (optional examples)
├── scripts/
│   └── helper.py (optional utility)
└── templates/
    └── template.txt (optional template)
```

从 `SKILL.md` 中引用这些文件：

````markdown
For advanced usage, see [reference.md](reference.md).

Run the helper script:

```bash
python scripts/helper.py input.txt
```
````

## 查看可用的 Skills

Qwen Code 从以下位置发现 Skills：

- 个人 Skills：`~/.qwen/skills/`
- 项目 Skills：`.qwen/skills/`
- 扩展 Skills：由已安装扩展提供的 Skills
- 内置 Skills：随 Qwen Code 一起提供的 Skills

### 扩展 Skills

扩展可以提供自定义 Skills，在启用扩展时变得可用。这些 Skills 存储在扩展的 `skills/` 目录中，并遵循与个人和项目 Skills 相同的格式。

在安装并启用扩展时，会自动发现和加载扩展 Skills。

要查看哪些扩展提供了 Skills，请检查扩展的 `qwen-extension.json` 文件中的 `skills` 字段。

#### 扩展 Skills 的命名方式

Qwen Code 将来自已安装扩展的 Skill 注册为 `<extensionName>:<name>`，其中 `<extensionName>` 是该扩展的 `qwen-extension.json` 中的 `name` 字段，`<name>` 是 Skill 自身的 frontmatter `name`。名为 `pdf` 的 Skill 在 `rust` 扩展中会被注册为 `rust:pdf`。

该前缀是在 Skill 加载时添加的，不会写入文件：你的 `SKILL.md` 保留你编写的名称，Qwen Code 也不会通过拆分注册名称来恢复原始名称（作者可能合法地在 `rust` 内编写 `rust:chat`）。只有扩展 Skills 会被添加前缀 —— 个人、项目和内置 Skills 保留你编写的单一拼写。

在引用 Skill 的所有地方使用注册名称：

- 使用 `/rust:pdf` 调用它。单独的 `/pdf` 不是别名 —— 扩展的 Skill 只能通过其注册名称访问。
- 模型将其作为 `Skill { skill: "rust:pdf" }` 调用，与在 `<available_skills>` 中读取的名称相同。
- 两个各自包含名为 `pdf` 的 Skill 的扩展会生成两个 Skills（`rust:pdf` 和 `docs-suite:pdf`），而不是一个胜出另一个消失。

你读取和选择 Skills 的界面也会显示所有者：Skills 面板（包括被设置锁定的行）、裸 `/skills` 在交互式 UI 之外打印的只读列表（ACP 和其他非交互模式 —— 交互模式下该命令会打开面板），以及 `/` 命令面板中的徽章，显示为 `[Extension: Rust]` 而非单独的 `[Extension]`。这些标签优先使用扩展的 `displayName`，如果没有则回退到 `name`。

#### 扩展 Skills 与 `skills.*` 设置

`skills.disabled`、`skills.defaultDisabled` 和 `slashCommands.disabled` 在**两种**拼写下都会匹配扩展 Skill，因此在前缀存在之前你编写的 `skills.disabled: ["pdf"]` 仍然会隐藏 `rust:pdf`。限制只能移除功能，因此重命名 Skill 不能解除限制。

`skills.enabled` 是例外，也是现有设置文件的唯一可见变化：它授予功能，因此只匹配注册名称。`skills.enabled: ["pdf"]` 不再单独选择扩展的 `pdf` —— 请写 `skills.enabled: ["rust:pdf"]`。唯一继续生效的裸名称对是位于 `skills.defaultDisabled` 中的前缀前的选择，具有相同拼写：取消比较条目本身，因此 `defaultDisabled: ["pdf"]` + `enabled: ["pdf"]` 取消该条目 —— 然后该 skill 根据此工作区存储的启用状态启用，否则使用扩展自身的默认值；对于默认关闭的 skill，请在 `skills.enabled` 中写 `rust:pdf`。

在 Skills 面板中切换 Skill 会写入注册名称并仅移除该条目，因此启用 `rust:pdf` 会保留遗留的 `disabled: ["pdf"]` 不变。当该遗留条目位于更高范围时 —— 系统默认值、用户或系统设置 —— 面板会说明这一点并锁定该行，命名要编辑的范围而不是提供无法移动它的切换。此工作区自身设置中的遗留条目也会以相同方式锁定该行，命名该条目及其范围（`skills.disabled 'pdf' (Workspace)` 或 `skills.defaultDisabled 'pdf' (Workspace)`），以便你知道要编辑哪个文件中的哪个列表。

两个值得了解的限制：

- 跨级优先级不变，仍然精确比较注册名称（`project` > `user` > `extension` > `bundled`），因此你编写为 `rust:pdf` 的个人或项目 Skill 优先级高于扩展的 `pdf`。个人或项目 Skill 与内置 Skill 之间的裸名称冲突也仍然由该优先级决定，而不是由前缀决定。与自定义命令冲突的 Skill 不是这样 —— 在斜杠表面上，最后一个加载器胜出，自定义命令在 Skills 之后加载，因此 `/pdf` 运行自定义命令而 Skill 仍对模型可用。
- Skill 名称也用作文件名：Skill 读取调用参数的文件会将 `[A-Za-z0-9._-]` 之外的每个字符替换为 `_`，因此注册为 `rust:pdf` 的扩展 Skill 和编写为 `rust_pdf` 的个人或项目 Skill 都会解析为 `qwen-skill-args-rust_pdf.txt` 并共享一个参数文件。（前缀很少与自身冲突 —— `rust:rust_pdf` 变为 `rust_rust_pdf` —— 但扩展名称可能包含 `_`，因此 `rust_pdf:x` 和 `rust:pdf_x` 折叠为相同的文件名。）非 ASCII 字母也以相同方式折叠，因此编写的 `café` 和编写的 `caf_` 都会落到 `caf_` —— 这是一个早于前缀的限制，前缀只是使其更容易遇到。避免使用将 `:` 转换为 `_` 后与另一个名称相同的 Skill 名称。

要查看可用的 Skills，请直接询问 Qwen Code：

```text
What Skills are available?
```

> **注意 —— 模型视图与用户视图的区别。** 询问模型只会显示模型当前能看到的 Skills。如果 Skill 使用了 `paths:`（参见上文“可选：通过文件路径限制 Skill”），在触及匹配文件之前，它不会出现在该列表中。`/skills` 斜杠命令显示你可以直接调用的 Skills；设置了 `user-invocable: false` 的 Skills 在磁盘上仍然可见，并且可能对模型仍然可见。

或者使用斜杠命令浏览用户可调用的列表（包括尚未激活的路径限制 Skills）：

```text
/skills
```

或者检查文件系统：

```bash
# List personal Skills
ls ~/.qwen/skills/

# List project Skills (if in a project directory)
ls .qwen/skills/

# View a specific Skill's content
cat ~/.qwen/skills/my-skill/SKILL.md
```

## 测试 Skill

创建 Skill 后，通过提出与你的描述相匹配的问题来测试它。

示例：如果你的描述提到了“PDF 文件”：

```text
Can you help me extract text from this PDF?
```

如果匹配请求，模型会自主决定使用你的 Skill —— 你不需要显式调用它。

## 调试 Skill

如果 Qwen Code 没有使用你的 Skill，请检查以下常见问题：

### 使描述更具体

过于模糊：

```yaml
description: Helps with documents
```

具体：

```yaml
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDFs, forms, or document extraction.
```

### 验证文件路径

- 个人 Skills：`~/.qwen/skills/<skill-name>/SKILL.md`
- 项目 Skills：`.qwen/skills/<skill-name>/SKILL.md`

```bash
# Personal
ls ~/.qwen/skills/my-skill/SKILL.md

# Project
ls .qwen/skills/my-skill/SKILL.md
```

### 检查 YAML 语法

无效的 YAML 会阻止 Skill 元数据正确加载。

```bash
cat SKILL.md | head -n 15
```

确保：

- 第 1 行以 `---` 开头
- 在 Markdown 内容之前以 `---` 闭合
- 有效的 YAML 语法（无制表符，缩进正确）

### 查看错误

使用调试模式运行 Qwen Code 以查看 Skill 加载错误：

```bash
qwen --debug
```

## 与团队共享 Skills

你可以通过项目仓库共享 Skills：

1. 将 Skill 添加到 `.qwen/skills/` 下
2. 提交并推送
3. 团队成员拉取更改

```bash
git add .qwen/skills/
git commit -m "Add team Skill for PDF processing"
git push
```

## 更新 Skill

直接编辑 `SKILL.md`：

```bash
# Personal Skill
code ~/.qwen/skills/my-skill/SKILL.md

# Project Skill
code .qwen/skills/my-skill/SKILL.md
```

在正常会话期间，Qwen Code 会监视个人和项目 Skill 目录。添加、编辑或删除 Skill 会在短暂延迟后自动刷新 Skill 列表和调用状态。Bare 模式不会启动这些监视器，因此在该模式下需要重启 Qwen Code 以加载 Skill 更改。

## 移除 Skill

删除 Skill 目录：

```bash
# Personal
rm -rf ~/.qwen/skills/my-skill

# Project
rm -rf .qwen/skills/my-skill
git commit -m "Remove unused Skill"
```

## 最佳实践

### 保持 Skill 专注

一个 Skill 应该只解决一种能力：

- 专注：“PDF 表单填充”、“Excel 分析”、“Git 提交信息”
- 过于宽泛：“文档处理”（拆分为更小的 Skills）

### 编写清晰的描述

通过包含特定的触发条件，帮助模型发现何时使用 Skills：

```yaml
description: Analyze Excel spreadsheets, create pivot tables, and generate charts. Use when working with Excel files, spreadsheets, or .xlsx data.
```

### 与团队一起测试

- Skill 是否在预期时激活？
- 指令是否清晰？
- 是否缺少示例或边缘情况？