# 第 3 → 第 4 课交接包：项目助理交给多智能体协作

文件路径：`/Users/apple/Documents/4.0 Sanyuan/2.4 环境公益"新"力量/course/bridge-materials/templates/03_to_04_agent_scenario_handoff.md`

用途：第 3 课下课前填写，第 4 课用于选择主场景、判断协作缺口、拆出多智能体角色与交接协议。

## 1. 项目助理边界卡

| 项目 | 填写 |
|------|------|
| 项目助理名称 | |
| 主要服务对象 | 本机构同事 / 志愿者 / 合作伙伴 / 公众 / 其他： |
| 能处理的 3 类问题 | 1.  2.  3. |
| 明确不处理的 3 类问题 | 1.  2.  3. |
| 需要人工审核的情形 | |
| 需要拒答或转人工的情形 | |

## 2. 已挂载资产

### 2.1 Skill 接口清单

| Skill 名称 | 触发条件 | 输入要求 | 输出契约 | 成功标准 | 知识库依赖 | 不适用场景 | 稳定性状态 |
|------------|----------|----------|----------|----------|------------|------------|------------|
| | | | | | | | 草稿 / 可用 / 稳定 |
| | | | | | | | 草稿 / 可用 / 稳定 |

必填 Gotchas：

```text
Skill 1 最容易翻车的 3 点：

Skill 2 最容易翻车的 3 点：
```

评测用例：

| Skill | 必测问题 | 期望输出 | 是否通过 |
|-------|----------|----------|----------|
| | | | 是 / 否 |
| | | | 是 / 否 |

### 2.2 知识库接口清单

| 知识库名称 | 资料范围 | 允许回答范围 | Top-K/检索设置 | 不能回答什么 |
|------------|----------|--------------|----------------|--------------|
| | | | | |
| | | | | |

## 3. 路由表

| 用户问题类型 | 判定条件 | 调用 Skill | 相邻易混 Skill | 优先归属规则 | 是否检索知识库 | 输出形式 | 需要追问的条件 | 超边界处理 |
|--------------|----------|------------|----------------|--------------|----------------|----------|----------------|------------|
| | | | | | 是 / 否 | | | |
| | | | | | 是 / 否 | | | |
| | | | | | 是 / 否 | | | |
| | | | | | 是 / 否 | | | |

兜底规则：

```text
当用户意图不清时：

当 Skill 和知识库都可能适用时：

当知识库没有依据时：
```

## 4. 主工作流最小闭环

先只写一条主工作流，不要同时扩三个模块。

```text
用户输入：
  ↓
路由判定：
  ↓
检索 / 不检索：
  ↓
调用 Skill / 直接回答：
  ↓
输出结果：
  ↓
记录问题并人工复核：
```

## 5. 10 问诊断表

| # | 测试问题 | 覆盖类型 | 期望行为 | 实际表现 | 问题归因 |
|---|----------|----------|----------|----------|----------|
| 1 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 2 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 3 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 4 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 5 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 6 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 7 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 8 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 9 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |
| 10 | | 边界 / Skill / 知识库 / 工作流 / 输出 | | | |

诊断规则：

| 问题归因 | 第 4 课优先修什么 |
|----------|------------------|
| 边界错 | 改项目助理边界卡 |
| 路由错 | 改路由表和触发条件 |
| 知识库错 | 回补资料、metadata、检索参数 |
| Skill 错 | 改输出契约、Gotchas、输入要求 |
| 工作流错 | 简化步骤，补人工审核点 |

## 6. 交给第 4 课的主场景

第 4 课只选一个主场景先闭环：

| 项目 | 填写 |
|------|------|
| 主场景名称 | |
| 为什么优先做它 | |
| 当前最常失败的问题 | |
| 闭环缺口 | Skill / 知识库 / 路由 / 人工审核 / 其他： |
| 是否需要补第二个 Skill | 是 / 否 / 待确认 |

第 4 课开场要回答：

```text
我最想让项目助理稳定完成的真实任务是：

现在卡住它的最大缺口是：

如果第 4 课只能修一个问题，我会先修：
```


## 7. 多智能体拆分草图

第 4 课开场前，先粗略判断这条主场景是否需要拆成多智能体协作。

| 候选角色 | 负责什么 | 输入 | 输出 | 需要人审吗 |
|----------|----------|------|------|------------|
| 主控智能体 | 判断任务类型、分派下一步 | 用户任务、边界卡 | 分派结果、交接包 | 是 / 否 |
| 资料员智能体 | | | | 是 / 否 |
| 写作/执行智能体 | | | | 是 / 否 |
| 审核员智能体 | | | | 是 / 否 |

初步停止条件：

```text
什么情况下不能继续自动处理：

什么情况下必须交给人：

什么情况下可以自动进入下一步：
```