EnterpriseArchitect/specs/BIZ-14_知识库体系建设规范_v1.0.md

智能体知识库体系建设规范 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

知识条目模板

# {知识标题}

> 领域: {所属领域} | 版本: 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 定期质量检查

# 每周运行一次
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 指标定义	中	陆怀瑾
规范	文档存储规范	已完成	陆怀瑾

---

九、交付物清单

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

---

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