---
order: 22
---

# 使用角色

角色决定一个智能体在团队里站在什么位置。它不是名字的美化，也不是一段更长的说明，而是团队判断“这件事该不该交给它”的依据。

一个角色写得好，团队成员会自然知道什么时候该叫它；智能体自己也更容易判断哪些事情该接，哪些事情应该让人确认或转给别的智能体。

> 角色不是写“它很强”，而是写清楚：它负责哪类结果，遇到什么情况要停下来。

## 角色应该回答什么

写角色时，先别急着写很多细节。先回答三个问题：

1. 这个智能体负责推进什么结果？
2. 它应该用什么方式和团队协作？
3. 遇到边界问题时，它应该停在哪里？

这三个问题比一长串能力描述更重要。能力可以通过技能补，背景可以通过记忆补，但职责边界必须先在角色里说清楚。

| 要写清楚的部分 | 写什么 | 少写什么 |
| --- | --- | --- |
| 负责的结果 | 它应该交付什么、推动什么 | 空泛的“提升效率” |
| 协作方式 | 什么时候主动提醒，什么时候等待确认 | 复杂的人格设定 |
| 边界 | 哪些事情不直接决定、不直接执行 | 大段项目背景 |

## 角色和智能体的关系

日常协作里，被团队成员 `@` 到的是智能体。角色是智能体背后的定位。

同一个角色可以被复用到不同智能体上；同一个智能体也可以随着团队变化调整角色。但对使用者来说，真正重要的是：这个智能体在当前工作区里到底负责什么。

所以创建智能体时，不要只问它跑在哪台机器上，也要问它在团队协作里承担什么位置。

## 什么时候值得创建新角色

不要因为想到一个新名字就创建角色。新角色应该对应一类稳定、会反复出现的工作。

比较值得创建新角色的情况包括：

- 团队经常需要同一类帮助。
- 这类任务有稳定判断标准。
- 现有智能体已经承担太多不相关职责。
- 团队成员经常不知道应该叫谁。
- 这个角色以后还会在其他场景复用。

如果只是一次性任务，直接在当前对话里说明即可。不是每件事都需要变成角色。

## 创建智能体时怎么选角色

从空白开始，适合正在建立一个新职责。先写名称和职责，不要一开始就写很多背景。

从模板开始，适合常见协作模式，例如评审、排障、文档整理、项目推进。模板只是起点，创建后仍然需要按团队实际工作调整。

从已有角色开始，适合团队已经沉淀出稳定职责，只是需要在当前工作区里再创建一个智能体。这样更容易保持命名和分工一致。

## 角色怎么写得更可用

名称最好像岗位，而不是代号。

例如 `代码评审助手`、`发布协调员`、`客户问题分析师`、`测试计划生成器`。这些名字不花哨，但团队能立刻判断什么时候使用。

职责要写结果，不要写愿景。

| 不够好 | 更好 |
| --- | --- |
| 帮助团队提高研发效率 | 把需求拆成可执行任务，识别依赖和风险，并提醒团队需要澄清的问题 |
| 负责测试相关工作 | 根据需求和改动范围生成测试计划，标出高风险路径和缺失信息 |
| 做一个专业的文档助手 | 把散乱信息整理成可读文档，并保留决策、待确认项和下一步 |

```text
把需求拆成可执行任务，识别依赖和风险，并提醒团队需要澄清的问题。
```

这比“帮助团队提高效率”更有用，因为它说明了智能体应该产出什么。

沟通风格只写最影响协作的几条。例如先给结论、信息不足时列假设、发现风险时主动提醒、面向非技术成员时减少术语。不要把风格写成一整套人格设定。

边界一定要写出来。例如不替代人工审批、不直接做最终发布决定、不处理账号和权限问题、信息不足时不编造结论。边界不是限制智能体能力，而是让团队知道它的输出应该如何被使用。

## 什么时候调整角色

角色应该随着团队使用逐步修正。

如果智能体经常答偏，通常不是需要写更长，而是职责太宽。

如果两个智能体总在处理同一类任务，需要重新划分边界。

如果一个角色长期承担两类完全不同的工作，最好拆开。一个清楚的小角色，通常比一个什么都能做的大角色更可靠。

## 角色不应该承担什么

角色不应该保存所有历史。之后还要继续用的背景，应该放进记忆。

角色不应该定义完整流程。固定步骤、检查清单和输出格式，应该放进技能。

角色也不等于运行环境。智能体是否在线、能否执行工具、响应是否稳定，还取决于机器和运行配置。

## 怎么判断角色写好了

一个角色是否可用，不看写得多长，看团队能不能用起来。

可以用这三个问题检查：

- 团队成员知道什么时候该叫它吗？
- 它的输出是否稳定落在职责范围内？
- 它和其他智能体是否有清楚分工？

```text
叫得准
  团队知道什么时候该找它

接得稳
  它不会频繁越界或抢别人的工作

交得清
  输出能被团队继续使用
```

如果答案是否定的，先改角色，再考虑补技能或调整模型。

## 继续阅读

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