---
title: "技能"
description: "将重复流程封装为可复用的技能。"
lang: zh
---

如果同一套流程需要反复交代，可以把它封装成技能。

## 什么是技能

技能是一段可复用的说明，告诉智能体遇到特定任务时应当怎么做。它把「每次重新描述」变成「调用一次」。

## 使用技能

在会话中通过技能名称调用。智能体按技能定义的流程执行，免去重复说明。

适合的场景：

- 反复进行的同类任务，例如生成某类报告、按固定流程检查代码
- 团队内共享的一套标准做法
- 一段较长的说明中，你只需要用到其中一部分

## 子目录与技能包

技能可以放进子目录分类。技能名就是 `/` 分隔的相对路径，例如 `文案/品牌文案.md` 对应技能 `文案/品牌文案`。

目录里含 `SKILL.md` 时，整个目录算**一个技能包**：技能名取目录名，调用时只注入 `SKILL.md`，同目录其他文件作为伴随文件，由智能体按需用 `read` 读取。选择器把技能包显示为单独一条（带目录图标），伴随文件不会出现在列表里——但搜索伴随文件名仍能命中所属包，也可以用 `[skill:包/伴随]` 手工挂载单份。流程很长时适合这样做：入口保持精简，细节用到才加载。

## 常驻技能

用 `/` 调用的技能只对**当前这一轮**生效。要让技能跨多轮保持，把它固定住：

- **会话级**：输入框上方的常驻技能栏。技能文件声明 `pin: true` 后会出现在这里，点击即为本会话开启，每轮自动注入，直到你关掉或切换会话。
- **项目级**：项目设置弹窗的「技能」tab。在这里固定，该项目下**所有会话**都生效，同项目目录的使用者共享。

三层并存、互不冲突：一次性 `[skill:xxx]` 标记、会话级固定、项目级固定会在每轮取并集去重后注入。上下文面板的「技能内容」段会显示本轮注入了哪些技能及其 token 占用。

技能要出现在常驻栏，需在 frontmatter 里声明 `pin: true`（声明不等于自动启用，仍需手动开启）：

```yaml
---
name: 水保方案
description: ……
pin: true
---
```

技能目录下的加密技能（`.skl`）在读取时自动解密，因此加密交付下伴随文件同样可用。

## 相关

- [插件](/docs/using-bi/plugins)
- [并行子任务](/docs/using-bi/subagents)