diff --git a/specs/BIZ-14_知识库体系建设规范_v1.0.md b/specs/BIZ-14_知识库体系建设规范_v1.0.md new file mode 100644 index 0000000..ec4194b --- /dev/null +++ b/specs/BIZ-14_知识库体系建设规范_v1.0.md @@ -0,0 +1,261 @@ +# 智能体知识库体系建设规范 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 协调。 \ No newline at end of file