---
title: "技能 · Finch Agent"
description: "开发者的 Skill 目录与扫描规则"
source: https://finchwork.app/zh/docs/skills
---

# 技能

Skill 是一个以 `SKILL.md` 为入口的 Markdown 指南包，用于为 Finch 提供可复用的任务说明、参考资料、模板或脚本。它不需要编译；这里仅说明开发者放置和发现 Skill 的规则。

## 放在哪里

Finch 按以下目录扫描 Skills：

| 层级 | 路径 | 适用场景 |
| --- | --- | --- |
| 当前项目 / 空间 | `<cwd>/.finch/skills/<skill-name>/SKILL.md` | 当前项目或绑定目录的空间专用 Skill |
| Finch 主目录 | `<finchHomeDir>/.finch/skills/<skill-name>/SKILL.md` | 个人常用、跨项目复用的 Skill |
| 全局 | `~/.finch/skills/<skill-name>/SKILL.md` | 所有 Finch 工作区可用的基础 Skill |

开发版的全局目录是 `~/.finch-dev/skills/`。通常优先将项目相关的 Skill 放在当前目录的 `.finch/skills/` 中。

## 最小结构

```text
my-skill/
└── SKILL.md
```

`SKILL.md` 建议带上名称和用途：

```markdown
---
name: my-skill
description: 这个 Skill 做什么，以及什么时候应该使用它。
---

# My Skill

## 使用方式

当用户需要……时，按以下步骤处理。
```

脚本、参考文档和模板可按需放在同一目录的 `scripts/`、`references/`、`assets/` 下。

## 发现与优先级

相同名称的 Skill 按以下优先级覆盖：

```text
当前空间 / 当前授权目录 > 当前主工作目录 > Finch 主目录 > 全局目录
```

如果最高优先级的同名 Skill 被停用，Finch 不会回退到较低优先级的版本。

Finch 不会持续监听文件变化。以下操作会重新扫描上述目录：

-   Finch 调用 `Skills` 工具时
-   在 Composer 中打开 Skill 检索时
-   打开工具箱的技能列表时
-   在设置或工具箱中启用、停用 Skill 时

将 Skill 放入目录后，重新打开 Composer 的 Skill 检索或工具箱即可确认它是否被发现。