vincent/EnterpriseArchitect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

初始提交：多智能体协作体系总体方案及各子项目详细方案

Browse Source 
- BIZ-11: 组织架构与岗位职责体系建设方案
- BIZ-12: 文档存储、命名与索引规范方案
- BIZ-13: 运行稳定性保障方案（任务停滞与429速率限制）
- BIZ-14: 知识库体系建设方案
- BIZ-15: 配置文件持续优化机制方案

所有方案均为初稿，待刘总审阅。
This commit is contained in:
陆怀瑾 (COO)
2026-06-22 02:45:51 +08:00
commit 38b21d7adb
6 changed files with 1966 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
plans/BIZ-14_知识库体系建设方案.md
+387
View File
@@ -0,0 +1,387 @@
# BIZ-14 智能体知识库体系建设方案
> 版本：v1.0
> 编制：陆怀瑾（COO）
> 日期：2026-06-22
> 状态：待审阅
---
## 一、目标
建立独立于 Agent 配置的知识库体系，实现：
1. **知识与配置解耦**：知识不进入 Token，避免配置膨胀
2. **可维护可扩展**：人类可通过 Web UI 审查、编辑、优化
3. **主动查询能力**：Agent 能在需要时主动查询知识库
4. **零 Token 增长**：知识库内容不计入 Agent 上下文
---
## 二、架构设计
### 2.1 整体架构
```
┌─────────────────────────────────────────────────────┐
│ Agent 层 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │secretary│ │ coo │ │ PM │ │ dev │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │ │
│ └──────────┴──────────┴──────────┘ │
│ │ │
│ memory_search / wiki_search │
└────────────────────────┼──────────────────────────┘
│
┌────────────────────────┼──────────────────────────┐
│ 知识库层 │
│ ┌───────────────────┴───────────────────┐ │
│ │ 编译型 Wiki 系统 │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │wiki_get │ │wiki_ │ │wiki_ │ │ │
│ │ │ │ │search │ │apply │ │ │
│ │ └─────────┘ └─────────┘ └─────────┘ │ │
│ └───────────────────────────────────────┘ │
│ │ │
│ Markdown 文件系统 │
│ ┌───────────────────┴───────────────────┐ │
│ │ knowledge/ │ │
│ │ ├── 电商/淘宝运营 SOP.md │ │
│ │ ├── 电商/抖店运营 SOP.md │ │
│ │ ├── 内容/小红书运营指南.md │ │
│ │ ├── 产品/PRD 模板.md │ │
│ │ └── 技术/开发规范.md │ │
│ └───────────────────────────────────────┘ │
└───────────────────────────────────────────────────┘
│
┌────────────────────────┼──────────────────────────┐
│ 人类交互层 │
│ ┌───────────────────┴───────────────────┐ │
│ │ Obsidian Web UI │ │
│ │ 或 飞书文档同步 │ │
│ └───────────────────────────────────────┘ │
└───────────────────────────────────────────────────┘
```
### 2.2 核心原则
| 原则 | 说明 |
|------|------|
| 解耦 | 知识库与 Agent 配置完全独立 |
| 按需查询 | Agent 只在需要时查询，不预加载 |
| 人类可审 | Web UI 支持人类审查、编辑 |
| 版本可控 | 知识变更保留历史版本 |
---
## 三、技术选型
### 3.1 现有工具利用
OpenClaw 已提供完整的 Wiki 工具链：
| 工具 | 用途 | 说明 |
|------|------|------|
| `wiki_search` | 知识检索 | 按标题/路径/内容搜索 |
| `wiki_get` | 精确读取 | 读取特定页面 |
| `wiki_apply` | 知识写入 | 创建/更新知识条目 |
| `wiki_lint` | 质量检查 | 检查知识库完整性 |
| `wiki_status` | 状态检查 | 查看 Wiki 系统健康度 |
### 3.2 与记忆系统的关系
```
┌─────────────────────────────────────┐
│ 记忆系统 (Memory) │
│ - MEMORY.md：长期记忆 │
│ - memory/*.md：短期记忆归档 │
│ - 用途：Agent 个性化记忆、决策历史 │
└─────────────────────────────────────┘
│
语义检索
↓
┌─────────────────────────────────────┐
│ 知识库系统 (Wiki) │
│ - knowledge/*.md：领域知识 │
│ - 用途：SOP、模板、规范、最佳实践 │
└─────────────────────────────────────┘
```
**区别**：
- **Memory**：Agent 个性化、决策历史、经验教训
- **Wiki**：通用知识、SOP、模板、规范
---
## 四、知识库目录设计
### 4.1 目录结构
```
knowledge/
├── README.md # 知识库索引
│
├── 电商/ # 电商运营知识
│ ├── 淘宝运营 SOP.md
│ ├── 抖店运营 SOP.md
│ ├── 微信小店 SOP.md
│ └── 客服话术模板.md
│
├── 内容/ # 内容运营知识
│ ├── 小红书运营指南.md
│ ├── 标题写作技巧.md
│ ├── 内容排期模板.md
│ └── 爆款内容分析.md
│
├── 产品/ # 产品管理知识
│ ├── PRD 模板.md
│ ├── 需求分析方法.md
│ ├── 用户故事模板.md
│ └── 版本规划指南.md
│
├── 技术/ # 技术开发知识
│ ├── 开发规范.md
│ ├── 代码审查清单.md
│ ├── 部署流程.md
│ └── 故障排查手册.md
│
├── 设计/ # 设计资源知识
│ ├── UI 设计规范.md
│ ├── 品牌元素使用指南.md
│ └── 设计评审清单.md
│
├── 运营/ # 通用运营知识
│ ├── 活动策划模板.md
│ ├── 数据分析方法.md
│ └── KPI 指标定义.md
│
└── 行政/ # 行政支持知识
├── 合同模板.md
├── 报销流程.md
└── 供应商管理指南.md
```
### 4.2 知识条目格式
```markdown
# {知识标题}
> 领域：{所属领域}
> 最后更新：{日期}
> 维护者：{责任人}
---
## 概述
{简短说明知识的用途和价值}
## 适用范围
{说明在什么场景下使用此知识}
## 核心内容
{知识的主体内容，可以是 SOP、模板、规范等}
## 操作步骤
1. {步骤 1}
2. {步骤 2}
3. {步骤 3}
## 质量检查
- [ ] {检查项 1}
- [ ] {检查项 2}
## 常见问题
**Q**: {问题}
**A**: {答案}
## 相关资源
- [相关链接 1](url)
- [相关链接 2](url)
## 版本历史
| 版本 | 日期 | 变更内容 | 作者 |
|------|------|----------|------|
| v1.0 | 2026-06-22 | 初稿 | 陆怀瑾 |
```
---
## 五、Agent 查询流程
### 5.1 查询触发条件
Agent 在以下场景应主动查询知识库：
| 场景 | 查询内容 | 工具 |
|------|----------|------|
| 执行新类型任务 | SOP、模板 | `wiki_search` |
| 遇到未知问题 | 故障排查手册 | `wiki_search` |
| 撰写文档 | 文档模板 | `wiki_get` |
| 制定计划 | 最佳实践 | `wiki_search` |
| 质量检查 | 检查清单 | `wiki_get` |
### 5.2 查询流程
```
Agent 需要知识
↓
构造查询语句
↓
调用 wiki_search(query)
↓
┌─────┴─────┐
│ │
找到结果 未找到
│ │
读取内容 记录需求
│ (通知 COO)
用于决策
↓
不进入配置文件
```
### 5.3 查询示例
```python
# 示例：淘宝运营 Agent 需要查询"淘宝活动报名 SOP"
query = "淘宝 活动报名 SOP"
results = wiki_search(query)
if results:
# 获取最相关的条目
best_match = results[0]
content = wiki_get(best_match.path)
# 使用内容指导操作
follow_sop(content)
else:
# 记录知识缺口
log_knowledge_gap(query)
notify_coo("缺少知识库：淘宝活动报名 SOP")
```
---
## 六、人类审查机制
### 6.1 Web UI 访问
**Obsidian Web UI**：
- 浏览知识库目录结构
- 搜索知识条目
- 编辑知识内容
- 查看版本历史
**飞书文档同步**（可选）：
- 知识库自动同步到飞书文档
- 支持多人协作编辑
- 支持评论和批注
### 6.2 知识审核流程
```
Agent 发现知识缺口
↓
创建知识草稿
↓
通知 COO 审核
↓
COO 审核（通过/修改/拒绝）
↓
发布到知识库
↓
通知相关 Agent
```
### 6.3 质量检查
定期运行 `wiki_lint` 检查：
- 断裂链接
- 缺失引用
- 矛盾信息
- 过时内容
---
## 七、知识创建流程
### 7.1 创建触发
| 触发源 | 场景 | 处理流程 |
|--------|------|----------|
| Agent 发现缺口 | 查询无结果 | 记录缺口 → 通知 COO |
| 人类审查发现 | 知识结构不完整 | 直接创建/编辑 |
| 项目总结 | 项目完成后 | 沉淀经验到知识库 |
| 流程优化 | SOP 更新 | 版本化更新 |
### 7.2 创建规范
```python
def create_knowledge_entry(title, domain, content):
# 1. 检查是否已存在
existing = wiki_search(title)
if existing:
# 已存在，走更新流程
return update_knowledge_entry(existing[0].id, content)
# 2. 创建新条目
path = f"knowledge/{domain}/{title}.md"
wiki_apply(
op="create_synthesis",
title=title,
body=content,
sourceIds=[]
)
# 3. 更新索引
update_knowledge_index(domain, title, path)
# 4. 通知相关方
notify_coo(f"新知识库条目：{path}")
```
---
## 八、实施步骤
### 阶段 1：初始化（本周）
- [ ] 创建 knowledge/ 目录结构
- [ ] 编写各领域 README.md
- [ ] 建立初始知识条目（SOP、模板）
### 阶段 2：填充（下周）
- [ ] 迁移现有 SOP 到知识库
- [ ] 补充各领域核心知识
- [ ] 测试 Agent 查询流程
### 阶段 3：优化（持续）
- [ ] 建立知识审核机制
- [ ] 定期 wiki_lint 检查
- [ ] 收集 Agent 反馈，补充缺口
---
## 九、风险与对策
| 风险 | 影响 | 对策 |
|------|------|------|
| 知识库内容过期 | Agent 决策错误 | 定期审核 + 版本管理 |
| 查询结果不相关 | Agent 找不到知识 | 优化检索 + 关键词标签 |
| 人类审查不及时 | 知识积压 | 设置 SLA（48h 内审核） |
| 知识与 Memory 混淆 | 概念混乱 | 明确分工 + Agent 培训 |
---
## 十、交付物清单
- [ ] knowledge/ 目录结构
- [ ] 初始知识条目（至少 10 个）
- [ ] Agent 查询指南
- [ ] 人类审查 Web UI URL
- [ ] 知识审核 SOP
- [ ] 质量检查脚本
---
> ⚠️ 本方案需 Vincent 审阅后方可实施。审阅前不修改任何 Agent 配置文件。