# 第 2 → 第 3 课交接包：知识库交给项目助理

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

用途：第 2 课下课前填写，第 3 课开课时作为项目助理挂载知识库的输入。

## 1. 基本信息

| 项目 | 填写 |
|------|------|
| 机构名称 | |
| 主场景 | M1 文书链 / M2 案例库 / M3 传播运营 / 其他： |
| 知识库名称 | |
| 知识库位置 | 组织层知识库 / 个人知识库 / 工作台 / 高阶 RAG 工具 / 其他： |
| 维护人 | |
| 本次版本日期 | |

## 2. 知识库范围

| 知识库栏目 | 包含哪些资料 | 可以回答什么 | 不回答什么 |
|------------|--------------|--------------|------------|
| | | | |
| | | | |
| | | | |

## 3. 合规分级摘要

| 等级 | 数量 | 处理方式 | 是否进入组织层知识库 |
|------|------|----------|----------------------|
| L1 公开 | | 可直接使用 | 是 / 否 |
| L2 准公开 | | 已脱敏并审核 | 是 / 否 |
| L3 内部 | | 仅个人知识库 / 工作台使用 | 否 |
| L4 敏感 | | 剔除，不进入任何知识库或技能 | 否 |

合规备注：

```text
哪些资料被剔除：

哪些资料需要后续脱敏：

谁负责最终审核：
```

## 4. 资料、frontmatter 与 metadata

| 资料类型 | 份数 | 主要来源 | 清洗状态 | frontmatter 完整率 | 必填 metadata |
|----------|------|----------|----------|--------------------|---------------|
| 项目档案 | | | 未清洗 / 草稿 / 已审核 | | |
| 资助指南 | | | 未清洗 / 草稿 / 已审核 | | |
| 案例/服务故事 | | | 未清洗 / 草稿 / 已审核 | | |
| 沟通模板 | | | 未清洗 / 草稿 / 已审核 | | |
| 其他 | | | 未清洗 / 草稿 / 已审核 | | |

当前 frontmatter / metadata 字段：

```text
doc_title：
doc_type：
project_name：
year：
topic_tags：
privacy_level：
audience_scope（内部同事可问 / 公开用户可问 / 仅维护人可看）：
retrieval_hint（事实查找 / 案例匹配 / 条款引用 / 综合判断）：
canonical_questions：
summary：
last_reviewed_at：
```

清洗工具与提示词：

```text
本轮使用的清洗工具：
使用过的 LLM-wiki 提示词：
仍需人工复核的字段：
```

## 5. 检索参数与测试结果

| 项目 | 当前设置 | 是否需要第 3 课继续调 |
|------|----------|------------------------|
| Top-K | | 是 / 否 |
| 相似度阈值 | | 是 / 否 |
| 检索模式 | 向量 / 全文 / 混合 / 平台默认 | 是 / 否 |
| frontmatter / metadata 过滤 | | 是 / 否 |

10 问命中率：

| # | 测试问题 | 期望来源 | 结果 | 未命中原因 |
|---|----------|----------|------|------------|
| 1 | | | 命中 / 半命中 / 未命中 | |
| 2 | | | 命中 / 半命中 / 未命中 | |
| 3 | | | 命中 / 半命中 / 未命中 | |
| 4 | | | 命中 / 半命中 / 未命中 | |
| 5 | | | 命中 / 半命中 / 未命中 | |
| 6 | | | 命中 / 半命中 / 未命中 | |
| 7 | | | 命中 / 半命中 / 未命中 | |
| 8 | | | 命中 / 半命中 / 未命中 | |
| 9 | | | 命中 / 半命中 / 未命中 | |
| 10 | | | 命中 / 半命中 / 未命中 | |

命中率：`___ / 10`

## 6. 与 Skill 的连接

| 已有 Skill | 需要知识库支持的字段 | 知识库提供什么事实 | Skill 仍需控制什么格式 |
|------------|----------------------|--------------------|-------------------------|
| | | | |
| | | | |

### 6.1 输出契约与证据映射

| Skill 输出章节/字段 | 需要的证据类型 | 推荐 doc_type | 必填 frontmatter / metadata | retrieval_hint | 无依据时输出策略 |
|---------------------|----------------|--------------|----------------------------|----------------|------------------|
| | | | | 事实查找 / 案例匹配 / 条款引用 / 综合判断 | 缺失提示 / 追问 / 转人工 |
| | | | | 事实查找 / 案例匹配 / 条款引用 / 综合判断 | 缺失提示 / 追问 / 转人工 |

如果回答不好，先按这个顺序排查：

```text
资料不存在 → 补资料
资料存在但没找到 → 改清洗质量 / 切片 / frontmatter / metadata / 检索参数
找到了但写不好 → 回到 Skill 改输出契约 / Gotchas
```

## 7. 第 3 课挂载准备

进入第 3 课前，确认以下内容：

- [ ] 有 1 个组织层知识库可挂载。
- [ ] L1/L2 资料已完成审核。
- [ ] L3 资料不会上传组织层知识库。
- [ ] L4 资料已剔除。
- [ ] 关键资料已完成清洗，至少有基础 frontmatter。
- [ ] 有 10 个真实测试问题。
- [ ] 已记录当前命中率。
- [ ] 已知道哪几个 Skill 需要调用这个知识库。

第 3 课开场要交给项目助理的三句话：

```text
这个知识库主要回答：

这个知识库不能回答：

当知识库没有依据时，项目助理应该：
```
