name: knowledge-base
description: 自动分类文档、提取标签、检测重复冲突、更新导航索引。当用户说「整理知识库」「文档分类」「知识管理」时激活。
allowed-tools: Read, Write, Bash, Glob

知识库维护 Agent

配置

kb_path: "docs/" # 知识库根目录
kb_type: "obsidian" # obsidian | notion | feishu | wiki
top_categories: # 顶级分类
  - "技术"
  - "产品"
  - "运营"
  - "管理"
  - "个人成长"
tags_style: "flat" # flat | hierarchical
auto_nav: true # 是否自动更新导航页

工作流程（5 步）

Step 1：新文档扫描

Agent 扫描知识库中在上次维护后新增/修改的文档：

• 提取：文档标题、创建/修改日期、文件大小、关键词密度
• 标记：空文档（< 100 字）、未完成文档（含 TODO/Draft 标记）、碎片文档（< 300 字且无链接）

Step 2：内容分析与分类推荐

对每个新文档：

1. 摘要提取：1-2 句话概括核心内容
2. 分类推荐：基于内容分析推荐最匹配的 1-3 个分类（含置信度）
3. 标签建议：提取 3-8 个关键词作为标签
4. 关联推荐：识别与哪些已有文档有内容关联（建议添加双向链接）

Step 3：重复与冲突检测

Agent 检查新增文档是否与已有文档存在：

• 高度重复（内容相似度 > 80%）→ 建议合并或建立「主文档+补充」关系
• 直接冲突（同一个观点/结论，两篇文档说法矛盾）→ 标记需要人工裁决
• 版本覆盖（同一主题的更新版本）→ 建议将旧版本标记为「已过期/已归档」

Step 4：过期内容标记

Agent 自动检测以下过期信号：

• 提到的时间窗口已过（如「2025年Q1计划」——当前 2026年Q3）
• 引用的外部链接已失效（404）
• 提到的工具/平台版本号远落后于当前版本
• 标注了「有效期至 YYYY-MM-DD」且已过期
• 最近 6 个月未被任何文档引用（孤立文档——可能已无人使用）

Step 5：更新导航索引

Agent 自动维护知识库的 MOC（Map of Content）导航页：

# 知识库导航
> 自动生成于 YYYY/MM/DD | 共 N 篇文档 | 上一次维护后新增 X 篇

## 技术（N 篇）
### 新文档
- [[新文档标题]] — [摘要一句话]

### 核心文档
- [[核心文档A]] — 被引用最多
- [[核心文档B]]

## 产品（N 篇）
...

## 待处理
- 📝 未完成草稿：X 篇
- ⚠️ 冲突待裁决：X 篇
- 🗑️ 过期待清理：X 篇
- 🔗 孤立文档（无链接）：X 篇

## 维护统计
| 指标 | 数值 |
|------|------|
| 文档总数 | N |
| 健康率 | XX%（非过期/非冲突/非孤立的比例） |
| 平均链接数 | N 个/篇 |

质量自检

• 分类推荐是否与知识库现有的分类体系一致（不是另起炉灶）？
• 重复检测是否给出了明确的合并建议（「文档A + 文档B → 合并为文档C」）？
• 过期标记是否保守（宁漏标不过标——错误地标记为过期比漏标更糟糕）？
• 导航页是否能在 5 秒内让新成员看懂知识库的结构？