wangjs-jacky Obsidian 知识库维护助手，负责检测并修复知识库中的标题、结构、链接、内容、元数据等各类健康问题。 保持知识库健康，确保标题清晰、结构规范、链接有效、概念无重复、元数据完整，让每篇文章对读者友好。
触发词：
- 检查知识库
- 健康检查
- 知识库 lint
- ob-tidy
- 整理知识库
- 修复断链
- 去重
- 标题检查
- 知识库体检
示例：
- "ob-tidy"
- "检查一下知识库健康状况"
- "帮我整理一下知识库"
- "知识库有没有断链"
- "检查标题规范"
Obsidian 知识库维护 (ob-tidy)
检测并修复知识库健康问题，生成健康报告。共 14 项检查，覆盖可读性、链接引用、内容质量、组织规范、元数据完整性、个性化偏好六个维度。
配置检查
【硬约束】仓库路径一律委托 ob-router skill 解析，本 skill 不自行读取路径文件。
调用 ob-router skill 获取 $OBSIDIAN_REPO：
- ob-router 内部处理优先级（ob-router.json → CLAUDE.md → 询问）
- 若 ob-router.json 不存在，ob-router 会主动提示
ob-router init持久化 - 若存在多个仓库，ob-router 会主动询问切换目标，不静默使用默认值
将 ob-router 返回的路径保存为 $OBSIDIAN_REPO，后续全程使用此变量。
4. 检查 $OBSIDIAN_REPO/wiki/ 目录是否存在
5. 如果不存在，提示用户先运行 ob-index 初始化
执行流程
第一步：扫描知识库
扫描 $OBSIDIAN_REPO/wiki/ 下所有 .md 文件（排除 index.md、log.md）：
- 读取每个文件的 frontmatter（tags、type、updated_at、created_at、article_id）
- 提取所有
[[wikilinks]]引用 - 统计文件字数
- 提取标题层级结构（H1-H4）
- 收集所有标签
- 读取
$OBSIDIAN_REPO/wiki/index.md获取索引条目 - 如果
$OBSIDIAN_REPO/wiki/.rating-preferences.md存在，读取偏好规则作为个性化检查依据
第二步：运行十四项检查
扫描时必须读取 references/check-catalog.md，逐项执行其中的十四项检查，不得只抽样检查。检查按五个维度组织：
- 可读性
- 链接与引用
- 内容质量
- 组织与规范
- 元数据完整性
每个问题都沿用参考文件规定的检测方式、严重级别和修复建议。
第三步：生成健康报告
健康评分：根据 14 项检查结果计算总分（满分 105）
评分权重：
- 标题清晰度（15 分）- 标题是第一印象
- 文章结构（10 分）
- 断裂链接（15 分）- 影响阅读体验
- 孤立文章（5 分）
- 低链接文章（5 分）
- 缺失概念（10 分）
- 重复概念（5 分）
- 长文章（5 分）
- 内容新鲜度（5 分）
- 缺失索引（10 分）
- Frontmatter 规范（10 分）
- 标签体系（5 分）
- 偏好规则遵循度（5 分）- 基于用户主观评分的个性化标准（偏好文件不存在时满分）
- 缺少 article_id（5 分）- 全局唯一 ID 是跨系统引用的基础
终端摘要：
📊 知识库健康报告
健康评分：82/105 ✅
总览：
- 文章总数：87
- 平均长度：420 字 ✅
- 索引覆盖率：92% ⚠️
- 平均链接数：2.8 ⚠️
- 标题合格率：75% ⚠️
- 结构合格率：85% ✅
- Frontmatter 合格率：90% ✅
问题清单（按优先级）：
🔴 严重（必须修复）：
1. 3 个断裂链接
2. 2 对重复概念
3. 5 篇文章标题严重含糊
🟡 警告（建议修复）：
4. 7 篇文章缺少索引条目（可自动修复）
5. 12 篇文章链接数 < 2
6. 8 篇文章标题不符合类型规范
7. 4 篇文章缺少 frontmatter
🟢 提示（可选优化）：
8. 4 篇孤立文章
9. 1 篇文章 > 500 字
10. 3 篇文章超过 6 个月未更新
11. 6 个孤立标签
12. {n} 篇文章缺少 article_id（可自动修复）
完整报告写入 $OBSIDIAN_REPO/outputs/lint-{YYYY-MM-DD}.md：
---
tags: [lint, health-report]
type: output
created_at: {日期}
---
# 知识库健康报告 {日期}
## 总览
| 指标 | 值 | 状态 |
|------|-----|------|
| 健康评分 | {n}/100 | ✅/⚠️/🔴 |
| 文章总数 | {n} | — |
| 平均长度 | {n} 字 | ✅/⚠️/🔴 |
| 索引覆盖率 | {n}% | ✅/⚠️/🔴 |
| 标题合格率 | {n}% | ✅/⚠️/🔴 |
| 结构合格率 | {n}% | ✅/⚠️/🔴 |
| 平均链接数 | {n} | ✅/⚠️/⚠️ |
| Frontmatter 合格率 | {n}% | ✅/⚠️/🔴 |
## 严重问题 🔴
### 断裂链接（{n} 个）
{每个断裂链接的详情：源文件 → 引用的不存在文件}
### 重复概念（{n} 对）
{每对重复的详情：文件 A vs 文件 B，相似度}
### 标题严重含糊（{n} 篇）
{标题含糊的文章列表，附建议标题}
## 警告问题 🟡
### 标题不符合类型规范（{n} 篇）
{不符合对应类型标题格式的文章列表}
### 文章结构问题（{n} 篇）
{缺少分段/目录/引言/总结的文章列表}
### 缺失索引（{n} 篇）
{缺少索引条目的文章列表}
### 低链接文章（{n} 篇）
{链接数 < 2 的文章列表}
### Frontmatter 问题（{n} 篇）
{缺少/不规范的文章列表，附具体缺失字段}
## 提示信息 🟢
### 孤立文章（{n} 篇）
{无入链的文章列表}
### 长文章（{n} 篇）
{超过 500 字的文章及其字数}
### 内容新鲜度（{n} 篇需关注）
{超过 3 个月未更新的文章列表，附最后更新时间}
### 标签体系（{n} 个问题）
{孤立标签、相似标签等}
### 缺少 article_id（{n} 篇）
{缺少 article_id 的文章列表，附将分配的 ID 预览}
## 修复建议
{按优先级排列的可执行修复步骤}
第四步：交互式修复
展示问题后，使用 AskUserQuestion 提供修复选项：
发现 {n} 个可自动修复的问题：
🔴 严重（建议立即修复）：
□ 修复 3 个断裂链接（需确认修复方式）
□ 合并 2 对重复概念（需确认合并内容）
🟡 警告（建议修复）：
□ 补充 7 条缺失索引（自动）
□ 修复 8 个标题问题（预览建议标题后确认）
□ 补充 4 篇文章的 frontmatter（自动生成）
□ 为 12 篇低链接文章推荐关联（需确认）
🟢 提示（可选）：
□ 清理 6 个孤立标签（需确认合并方案）
□ 为 {n} 篇文章自动分配 article_id（自动）
选择要执行的修复（可多选）
执行修复：
对用户选择的每项修复：
- 展示修复预览（将做什么改动）
- 确认后执行
- 每项修复一个 commit
追加日志
修复完成后追加 $OBSIDIAN_REPO/wiki/log.md：
## [{日期}] lint | 健康检查
- 健康评分：{n}/100
- 问题总数：{n}
- 已修复：{n}
- 报告：outputs/lint-{日期}.md