交接包bridge-materials/templates/02_to_03_kb_agent_handoff.md
第 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 敏感 | 剔除,不进入任何知识库或技能 | 否 |
合规备注:
哪些资料被剔除:
哪些资料需要后续脱敏:
谁负责最终审核:
4. 资料、frontmatter 与 metadata
| 资料类型 | 份数 | 主要来源 | 清洗状态 | frontmatter 完整率 | 必填 metadata |
|---|---|---|---|---|---|
| 项目档案 | 未清洗 / 草稿 / 已审核 | ||||
| 资助指南 | 未清洗 / 草稿 / 已审核 | ||||
| 案例/服务故事 | 未清洗 / 草稿 / 已审核 | ||||
| 沟通模板 | 未清洗 / 草稿 / 已审核 | ||||
| 其他 | 未清洗 / 草稿 / 已审核 |
当前 frontmatter / metadata 字段:
doc_title:
doc_type:
project_name:
year:
topic_tags:
privacy_level:
audience_scope(内部同事可问 / 公开用户可问 / 仅维护人可看):
retrieval_hint(事实查找 / 案例匹配 / 条款引用 / 综合判断):
canonical_questions:
summary:
last_reviewed_at:
清洗工具与提示词:
本轮使用的清洗工具:
使用过的 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 | 无依据时输出策略 |
|---|---|---|---|---|---|
| 事实查找 / 案例匹配 / 条款引用 / 综合判断 | 缺失提示 / 追问 / 转人工 | ||||
| 事实查找 / 案例匹配 / 条款引用 / 综合判断 | 缺失提示 / 追问 / 转人工 |
如果回答不好,先按这个顺序排查:
资料不存在 → 补资料
资料存在但没找到 → 改清洗质量 / 切片 / frontmatter / metadata / 检索参数
找到了但写不好 → 回到 Skill 改输出契约 / Gotchas
7. 第 3 课挂载准备
进入第 3 课前,确认以下内容:
- 有 1 个组织层知识库可挂载。
- L1/L2 资料已完成审核。
- L3 资料不会上传组织层知识库。
- L4 资料已剔除。
- 关键资料已完成清洗,至少有基础 frontmatter。
- 有 10 个真实测试问题。
- 已记录当前命中率。
- 已知道哪几个 Skill 需要调用这个知识库。
第 3 课开场要交给项目助理的三句话:
这个知识库主要回答:
这个知识库不能回答:
当知识库没有依据时,项目助理应该: