| name | check-health |
| description | 定期审查 Obsidian 知识库健康状况,包括:矛盾观点检测、失效双向链接检查、孤立卡片识别。当用户说「检查知识库健康」、「检查链接」、「查孤立卡片」、「审查观点矛盾」或类似表达时触发此技能。 |
Check Health — 知识库健康检查
技能目的
定期审查用户的 Obsidian Vault(第二大脑)健康状况,发现并报告潜在问题,确保知识网络的健康生长。
检查维度
1. 矛盾观点检测(By Theme Grouping)
目标:按主题分组列出可能互相冲突的观点,由用户判断是否存在真正矛盾。
执行流程:
-
扫描知识卡片
- 优先检查
04_Knowledge/00_Cards/ 下的所有卡片
- 识别卡片类型(insight, mentalmodel, counterintuitive, paradox 等)
-
主题聚类
- 基于文件名、标签、related 字段识别主题
- 常见主题示例:学习方法、时间管理、决策模型、创作哲学
-
按主题分组列出观点
- 对于每个主题,列出相关的卡片及其核心观点
- 当发现可能矛盾的表达时,在输出中标注
-
输出格式:
## 📊 主题:[主题名称]
### 相关卡片
- [[card_1]] — 核心观点摘要
- [[card_2]] — 核心观点摘要
- [[card_3]] — 核心观点摘要
### ⚠️ 潜在矛盾
[如果发现明显矛盾,在此描述]
- 卡片 A 认为:...
- 卡片 B 认为:...
- 冲突点:...
### 💭 建议
[如需要整合或澄清,给出建议]
2. 失效双向链接检查
目标:发现指向不存在文件的 wikilink,提供修复建议。
执行流程:
-
扫描所有 md 文件
- 使用 Glob 获取所有 markdown 文件
- 使用 Grep 查找所有 wikilink 格式:
[[文件名]]
-
验证链接有效性
- 对每个 wikilink,检查目标文件是否存在
- 注意:
[[alias|显示名]] 格式需要提取真实文件名
-
分类失效链接:
- 拼写错误:
[[结构洞]] 应为 [[mentalmodel_结构洞]]
- 文件移动:目标文件可能被移动或重命名
- 删除文件:目标文件已被删除
-
输出格式:
## 🔗 失效链接报告
共发现 N 个失效链接:
| 源文件 | 失效链接 | 可能原因 | 修复建议 |
|--------|----------|----------|----------|
| [[card_a]] | [[broken_target]] | 拼写错误 | 改为 [[correct_target]] |
| [[card_b]] | [[missing]] | 文件不存在 | 检查是否被删除或移动 |
3. 孤立卡片识别
目标:发现没有被其他笔记链接的"孤岛"卡片,评估是否需要建立连接。
孤立程度分级:
| 级别 | 入链数 | 描述 |
|---|
| 🔴 完全孤立 | 0 | 没有任何卡片链接它 |
| 🟡 弱连接 | 1-2 | 只有很少的卡片链接它 |
| 🟢 良好连接 | 3+ | 有较好的网络连接 |
执行流程:
-
构建链接图
- 扫描所有卡片的
related 字段
- 扫描正文中的 wikilink
- 统计每张卡片的"入链数"(被其他卡片链接的次数)
-
识别孤立卡片
- 入链数为 0 的卡片标记为"完全孤立"
- 入链数为 1-2 的卡片标记为"弱连接"
-
分析孤立原因:
- 新卡片:最近创建,还未被连接
- 过时卡片:可能已被遗忘,但仍有价值
- 主题边缘:主题冷门,自然连接少
-
输出格式:
## 🏝️ 孤立卡片报告
### 🔴 完全孤立(N 张)
以下卡片没有任何入链:
| 卡片 | 类型 | 创建时间 | 建议操作 |
|------|------|----------|----------|
| [[card_x]] | insight | 2026-04-01 | 考虑删除或归档 |
| [[card_y]] | mentalmodel | 2026-04-15 | 寻找关联卡片建立链接 |
### 🟡 弱连接(N 张)
以下卡片只有 1-2 个入链:
| 卡片 | 入链数 | 建议操作 |
|------|--------|----------|
| [[card_z]] | 1 | 可以寻找更多关联 |
输出报告模板
完整报告应按以下结构输出:
# 📋 知识库健康检查报告
检查时间:[YYYY-MM-DD]
扫描范围:[数字] 张卡片
---
## 1️⃣ 矛盾观点检测
[按主题分组的观点列表]
---
## 2️⃣ 失效链接检查
[失效链接列表及修复建议]
---
## 3️⃣ 孤立卡片识别
[孤立卡片列表及建议]
---
## 📊 总结
- 矛盾观点:[数字] 组需要关注
- 失效链接:[数字] 个需要修复
- 孤立卡片:[数字] 张完全孤立,[数字] 张弱连接
## 🎯 建议优先处理
1. [最重要的问题]
2. [次要问题]
3. [可以延后处理的问题]
使用场景与触发词
当用户说以下内容时,触发此技能:
- "检查知识库健康"
- "检查失效链接"
- "查孤立卡片"
- "审查观点矛盾"
- "知识库体检"
- "检查双向链接"
- "有哪些卡片没有被链接"
- "定期审查"
执行注意事项
- 扫描范围:优先检查
04_Knowledge/00_Cards/,如果用户要求可扩展到全库
- 性能考虑:卡片数量较多时,分批处理避免超时
- 保守判断:对于"矛盾",只列出疑似情况,不做绝对判断
- 可操作建议:每个问题都应该给出具体的处理建议
相关技能
random-thinking — 随机探索知识库内容
trace — 追踪主题在知识库中的演化
connect — 寻找两个主题之间的关联