---
order: 23
---

# 使用技能

技能用来沉淀稳定做法。

当团队每次都要向智能体重复解释同一套流程、检查项或输出格式时，就应该考虑把这套做法整理成技能。

> 技能适合沉淀“下次还要照着做”的方法，不适合塞一次性的背景和临时要求。

## 技能解决什么问题

技能解决的是“同一类事情怎么做才稳定”。

它适合放操作步骤、检查清单、输出结构、判断规则和异常处理方式。它不适合放项目背景、客户偏好或角色职责。背景属于记忆，职责属于角色。

| 适合放进技能 | 不适合放进技能 |
| --- | --- |
| 发布前检查步骤 | 当前项目的临时状态 |
| 需求评审清单 | 某个客户的长期偏好 |
| 固定输出格式 | 智能体负责什么 |
| 异常处理规则 | 没整理过的大段聊天 |
| 升级和阻塞判断 | 一次性任务要求 |

一个有用的技能，应该能让智能体在类似任务里少问重复问题，按更稳定的步骤推进，并产出更一致的结果。

## 哪些内容值得变成技能

高频重复流程最适合变成技能。

例如发布前检查、需求评审、用户反馈分类、测试计划生成、线上问题分析。这些事情如果每次都靠人现场解释，结果很容易漂。

固定输出格式也适合放进技能。比如评审类任务可以要求输出结论、主要风险、需要澄清的问题和建议下一步。格式固定后，团队更容易扫读，也更容易比较不同任务的结果。

有些任务的难点不是步骤，而是判断标准。例如什么情况需要升级给负责人，什么情况应该阻塞发布，什么信息不足以得出结论，什么反馈应该进入需求池。这类规则也适合写进技能。

## 什么时候不要创建技能

不是所有说明都值得变成技能。

只会出现一次的临时要求，直接在当前对话里说就可以。

只对当前项目阶段有效的短期背景，更适合留在对话或记忆里，不要写进技能。

还没跑通、仍在反复变化的流程，也不要太早固化。技能应该承载已经相对稳定的做法。

## 添加技能前先整理内容

一个技能不需要很长，但要可执行。

整理时可以按这个结构写：

| 模块 | 写法 |
| --- | --- |
| 使用场景 | 这类任务什么时候会用到它 |
| 输入检查 | 开始前必须确认哪些信息 |
| 主要步骤 | 按什么顺序推进 |
| 输出要求 | 最后应该交付什么格式 |
| 异常处理 | 信息不足、风险过高或条件不满足时怎么办 |

不要把一整篇背景材料直接放进去。先把真正稳定的步骤和规则提炼出来。

## 如何添加技能

如果你已经有一份整理好的技能说明，可以直接导入。导入前先检查两件事：内容是否已经足够稳定，里面是否包含不应该共享的信息。

如果流程还散落在文档、聊天或人工习惯里，先整理成一份短而清楚的技能说明。不要照搬原文，要改写成智能体能执行的步骤。

如果团队已经有类似技能，优先复用或在原技能上调整。同一类工作不要维护多份近似技能，否则团队和智能体都会难以判断该用哪一个。

## 给智能体配置技能

配置技能时，不要只看“这个技能有没有用”，还要看它是否适合这个智能体。

三个问题足够判断：

- 这个技能是否服务于它的角色？
- 它是否经常遇到这类任务？
- 这个技能是否和已有技能冲突？

一个智能体可以配置多个技能，但不建议一开始就配满。先给最高频、最稳定的能力，再根据实际使用补充。

## Agent Team 里怎么用技能

Agent Team 里，技能应该跟成员分工走。

评审成员配置评审技能，测试成员配置测试计划技能，协调成员配置任务拆解和风险跟踪技能。

不要把所有技能都给每个成员。技能分配过宽，会让团队成员看不出每个智能体的专业分工。

## 更新技能

当团队流程变化时，技能也要更新。更新前先确认哪些智能体正在使用它，以及这次改动会不会改变它们的输出。

如果只是临时例外，不要急着改技能。直接在当前任务里说明例外即可。

## 怎么判断技能有效

技能生效后，变化应该很具体：

- 智能体不再反复问同一类步骤。
- 输出结构更稳定。
- 检查项更完整。
- 缺少输入时会主动指出。
- 团队不用每次重新解释流程。

如果看不到这些变化，通常是技能太抽象，或者它和智能体角色不匹配。

| 看不到效果时 | 先检查 |
| --- | --- |
| 输出还是很散 | 技能里是否写了明确输出结构 |
| 一直追问基础步骤 | 技能是否只写了目标，没写步骤 |
| 用了不该用的技能 | 技能是否和智能体角色不匹配 |
| 结果和团队习惯不一致 | 判断规则是否写得太含糊 |

## 常见问题

技能不是记忆。项目背景、客户偏好和长期状态更适合放进记忆。

技能不是角色介绍。职责定位、沟通风格和边界应该放进角色。

技能也不是越多越好。技能太多，智能体反而难以判断当前任务该用哪一个。

## 继续阅读

- [使用角色](./use-agent-roles.md)
- [使用记忆](./use-agent-memory.md)
- [配置智能体的角色、技能和记忆](./configure-agent-resources.md)