# 智能体知识库体系建设规范 v1.0

> 版本：v1.0（实施版）
> 编制：陆怀瑾（COO）
> 日期：2026-06-22
> 状态：已批准，执行中
> 适用范围：所有 Agent

---

## 一、核心目标

| 目标 | 实现方式 |
|------|----------|
| 知识与配置解耦 | 知识库独立于 Agent 配置文件，不计入 Token |
| Agent 可主动查询 | 通过多层检索体系按需获取知识 |
| 人类可审查优化 | Web UI / 飞书文档支持人工审阅 |
| 零 Token 增长 | 知识条目独立存储，仅在使用时加载 |

---

## 二、分层检索体系（刘总反馈已纳入）

### 2.1 检索优先级

```
Agent 需要知识
    ↓
第一层: memory_search (corpus=all)
  → 搜索 memory/*.md + MEMORY.md + wiki 条目
  → 零 Token 消耗，语义检索
    ↓ 未命中
第二层: wiki_search / wiki_get
  → 编译型结构化知识库
  → 支持精确检索和页面读取
    ↓ 未命中
第三层: qmd (QMD 全文检索，已安装 ← 刘总反馈)
  → 本地全文检索 markdown 知识库
  → 补充 memory_search 未覆盖的长文档
    ↓ 未命中
第四层: web_search / web_fetch
  → 外部互联网补充
  → 仅在内部均未命中时使用
```

### 2.2 工具速查

| 工具 | 适用场景 | Token 消耗 |
|------|----------|-----------|
| memory_search | 通用语义检索（跨 memory + wiki） | 0 |
| wiki_search / wiki_get | 结构化知识库精确查询 | 0 |
| qmd | 本地全文检索长文档 | 0 |
| web_search | 外部互联网信息 | 0 |
| web_fetch | 网页/文档详情获取 | 按内容量 |

---

## 三、知识库目录结构

```
knowledge/
├── 电商/                 # 电商运营知识
│   └── {主题}_v{M}.{N}.md
│
├── 内容/                 # 内容运营知识
│   └── {主题}_v{M}.{N}.md
│
├── 产品/                 # 产品管理知识
│   └── {主题}_v{M}.{N}.md
│
├── 技术/                 # 技术开发知识
│   └── {主题}_v{M}.{N}.md
│
├── 设计/                 # UI/UX 设计知识
│   └── {主题}_v{M}.{N}.md
│
├── 运营/                 # 通用运营知识
│   └── {主题}_v{M}.{N}.md
│
└── 规范/                 # 流程规范知识
    └── {主题}_v{M}.{N}.md
```

### 知识条目模板

```markdown
# {知识标题}

> 领域: {所属领域} | 版本: v{M}.{N}
> 维护者: {责任人} | 最后更新: {YYYY-MM-DD}

## 概述
{知识的用途和价值，1-2 句话}

## 适用范围
{在什么场景下使用}

## 核心内容
{知识主体}

## 操作步骤 / SOP
1. ...
2. ...

## 质量检查
- [ ] ...

## 常见问题
**Q**: ...  **A**: ...

## 相关条目
- knowledge/{领域}/{关联主题}.md

## 版本历史
| 版本 | 日期 | 变更 | 作者 |
|------|------|------|------|
| v1.0 | 2026-06-22 | 初稿 | 陆怀瑾 |
```

---

## 四、与 Memory 系统的分工

| 维度 | Memory 系统 | Knowledge 系统 |
|------|------------|---------------|
| 内容类型 | 决策记录、经验教训、个性化记忆 | SOP、模板、规范、最佳实践 |
| 所有者 | 单个 Agent 专属 | 跨 Agent 共享 |
| 更新频率 | 每日/每周 | 按需/按版本 |
| 查询方式 | memory_search（语义检索） | wiki_search/wiki_get/qmd |
| 存储位置 | MEMORY.md + memory/*.md | knowledge/ 目录 |

---

## 五、Agent 查询指南

### 5.1 何时查询知识库

| 场景 | 查询示例 |
|------|----------|
| 执行 SOP 任务 | "淘宝 活动报名 SOP" |
| 撰写文档 | "PRD 模板" |
| 遇到问题 | "部署 故障排查" |
| 制定规范 | "开发规范" |
| 不熟悉领域 | "小红书 运营指南" |

### 5.2 查询标准流程

```
1. 先用 memory_search(corpus=all, query="...") 搜索
2. 如有结果，用 memory_get 或 wiki_get 读取详情
3. 如无结果，用 qmd 全文检索 knowledge/ 目录
4. 仍无结果，记录知识缺口，通知 COO
5. 使用获取的知识指导工作
```

### 5.3 知识缺口上报

```
Agent 发现知识缺口
    ↓
在 memory/YYYY-MM-DD.md 中记录：
  - 查询内容
  - 使用场景
  - 建议优先级
    ↓
通知 COO 创建知识条目
```

---

## 六、人类审查机制

### 6.1 审查方式

| 方式 | 适用场景 | 工具 |
|------|----------|------|
| Obsidian Web UI | 日常浏览、编辑 | wiki_status 确认可用性 |
| 飞书文档同步 | 多人协作、审批 | 飞书 Wiki API |
| CLI 直接编辑 | 技术人员修改 | write/edit 工具 |

### 6.2 审核流程

```
Agent 发现缺口 → 记录 → 通知 COO
    ↓
COO 评估优先级
    ↓
高优先级 → 立即创建/指派
低优先级 → 记入 backlog
    ↓
创建草稿 → wiki_apply(op="create_synthesis")
    ↓
人类审查 → 通过/修改/拒绝
    ↓
发布 → 通知相关 Agent
```

### 6.3 定期质量检查

```bash
# 每周运行一次
wiki_lint  # 检查链接断裂、矛盾信息、过时内容
```

---

## 七、知识条目管理

### 7.1 创建

```
wiki_apply(op="create_synthesis", title="...", body="...", sourceIds=[])
```

### 7.2 更新

```
wiki_apply(op="synthesis", lookup="...", body="...")
```

### 7.3 版本管理

| 变更类型 | 版本变化 | 操作 |
|----------|----------|------|
| 内容微调 | v1.0 → v1.1 | 直接覆盖，更新版本历史 |
| 结构性变更 | v1.x → v2.0 | 保留旧版本，新建条目 |
| 废弃 | 添加 [deprecated] 标记 | 归档到 archive/ |

---

## 八、初始知识基础

以下条目作为知识库初始基础，需尽快创建：

| 领域 | 条目 | 优先级 | 负责 Agent |
|------|------|--------|-----------|
| 电商 | 淘宝运营 SOP | 高 | 陆云帆 |
| 电商 | 客服话术模板 | 中 | 陆云帆 |
| 内容 | 小红书运营指南 | 高 | 文墨言 |
| 内容 | 标题写作技巧 | 中 | 文墨言 |
| 产品 | PRD 模板 | 高 | 沈路明 |
| 技术 | 开发规范 | 高 | 梁思筑 |
| 技术 | 部署流程 | 中 | 严维序 |
| 设计 | UI 设计规范 | 中 | 苏锦绘 |
| 运营 | KPI 指标定义 | 中 | 陆怀瑾 |
| 规范 | 文档存储规范 | 已完成 | 陆怀瑾 |

---

## 九、交付物清单

- [x] 知识库体系建设规范（本文档）
- [ ] knowledge/ 目录结构创建
- [ ] 初始知识条目（至少 5 个优先）
- [ ] Agent 查询指南（已嵌入本文档）
- [ ] 知识审核流程（已嵌入本文档）
- [ ] wiki_lint 定期检查 cron 任务

---

> 本规范自批准之日起生效。知识条目创建请联系 COO 协调。