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/ 中。
最小结构
my-skill/
└── SKILL.md
SKILL.md 建议带上名称和用途：
---
name: my-skill
description: 这个 Skill 做什么，以及什么时候应该使用它。
---
# My Skill
## 使用方式
当用户需要……时，按以下步骤处理。
脚本、参考文档和模板可按需放在同一目录的 scripts/、references/、assets/ 下。
发现与优先级
相同名称的 Skill 按以下优先级覆盖：
当前空间 / 当前授权目录 > 当前主工作目录 > Finch 主目录 > 全局目录
如果最高优先级的同名 Skill 被停用，Finch 不会回退到较低优先级的版本。
Finch 不会持续监听文件变化。以下操作会重新扫描上述目录：
- Finch 调用
Skills工具时 - 在 Composer 中打开 Skill 检索时
- 打开工具箱的技能列表时
- 在设置或工具箱中启用、停用 Skill 时
将 Skill 放入目录后，重新打开 Composer 的 Skill 检索或工具箱即可确认它是否被发现。