# 助手库

[上一篇：安装与启动](./installation.md) · [文档首页](./README.md) · [下一篇：创建团队](./creating-teams.md)

助手是可以在多个团队之间复用的角色模板。解散团队不会删除助手；删除助手也不会直接删除已生成的 Harness Session。

## 打开助手库

进入 **设置 → Agent 团队**。

![助手库](../demo/2.png)

每张助手卡片会展示模型、Preset、默认权限、思考模式、Skills、MCP Servers 和角色说明。可用操作包括：

- **编辑**：修改模板配置。
- **复制**：以当前配置创建新的助手。
- **删除**：删除未被团队成员引用的助手。

## 创建方式一：团队 Agent 小助手

点击内置卡片中的 **开始对话**，用自然语言描述需要的角色，例如：

```text
帮我创建一个负责 React 前端开发和代码审查的助手，使用 GLM 模型，默认工作区可写。
```

小助手会逐项补充缺失配置，并生成完整方案。只有在你明确确认后，才会真正创建助手。

![通过对话创建助手](../demo/1.png)

小助手支持多段独立历史记录。未发送首条消息的新对话不会创建真实 Session，也不会出现在历史中。

## 创建方式二：手动新建

点击助手库右上角 **手动新建**，直接配置所有字段。

| 字段 | 作用 |
| --- | --- |
| 名称 | 助手在助手库、团队成员和对话标题中的名称 |
| 说明 | 简短描述助手用途，便于组建团队时选择 |
| Provider / 模型 | 该助手默认使用的模型来源和模型 |
| Agent Preset | 决定基础提示、可用工具和运行方式 |
| 默认权限 | 成员首次启动时使用的权限，可在工作台修改 |
| 思考模式 | 模型支持时，从 Harness 能力目录中选择强度 |
| Skills | 允许模型按需加载或由用户通过 `/` 调用的技能 |
| MCP Servers | 允许使用的已配置 MCP Server |
| 助手规则 | 长期角色、职责、约束和汇报方式 |

## 如何写助手规则

规则应明确职责、边界和交付方式。例如 Leader：

```text
你负责理解用户目标、拆解任务、分派给合适成员并验收结果。
编码任务优先交给成员执行；任务失败时先收集原因，再决定重试或重新分派。
完成后向用户汇总产出、验证结果和遗留风险。
```

普通编码成员可以写：

```text
你负责执行 Leader 分派的编码任务。
修改前先阅读相关文件并遵循现有代码风格。
完成后运行必要测试，通过团队任务工具回报结果和文件清单。
```

## 权限与思考模式

- 模板权限只作为成员首次启动的默认值，进入工作台后可以为每个 Session 单独切换。
- 思考模式选项由 Harness 的模型能力决定。不同模型可能支持不同档位，也可能只支持模型默认。
- 工作台中更改思考模式后，从下一轮消息开始生效。

## Skills 与 MCP

- Skills 来自所选 Agent Preset 的可用目录，助手只保存允许使用的名称；仅支持用户调用的 Skill 会标记为“仅斜杠调用”。
- MCP 连接和凭据由 Harness Profile 管理，助手只保存允许使用的 Server 名称。
- 如果列表为空，先检查 Harness Profile 和 Agent Preset 的配置。

## 编辑为何不会立即影响团队成员

助手加入团队时会生成不可变配置快照，保证运行中的成员不会因为模板编辑突然改变模型或规则。因此：

- 编辑只影响以后新加入团队的成员。
- 已运行成员要应用新配置，需要先移出，再重新添加该助手。

## 删除助手

如果助手仍被任何团队成员引用，系统会拒绝删除。先从相关团队移出对应成员，或解散相关团队，再返回助手库删除。