SuperAPI AI 工具集

wiki-lint

办公与效率

查看项目

更新于 10-16 07:48

技能介绍

用途

wiki-lint 用于对 Obsidian 知识库执行健康检查,目标是发现并修复那些会随时间推移降低知识库价值的结构性问题。它适用于知识库维护或健康检查场景。

主要能力

该技能按顺序执行以下检查,并边执行边报告发现:

  1. 孤立页面:查找没有任何入链 wikilink 的页面(index.md 和 log.md 除外)。
  2. 失效 wikilink:查找指向不存在页面的 [[wikilink]]。检查时会剥离别名(| 之后)、标题/块锚点(# 之后)以及表格单元格内转义 | 留下的尾部反斜杠;跳过附件类型扩展名(.png、.jpg、.gif、.svg、.webp、.pdf、.canvas、.base、音视频);不把每个点都当作扩展名(如 [[Node.js]]、[[Next.js]]、[[v1.2 release notes]] 是页面链接);剥离显式 .md 后缀后检查对应文件是否存在。
  3. 缺失 frontmatter:每个页面应有 title、category、tags、sources、created、updated。
  4. 缺失摘要(软警告):每个页面应有 summary: frontmatter 字段,1–2 句、≤200 字符;超过 200 字符也会标记。
  5. 陈旧内容:页面 updated 时间戳相对于其来源文件修改时间过旧。
  6. 矛盾:跨页面的声明冲突,需阅读相关页面并比较,重点关注共享标签或大量交叉引用的页面。
  7. 索引一致性:验证 index.md 与实际页面清单是否匹配。
  8. 来源漂移:检查页面是否如实反映其内容中推断与提取的比例。阈值包括:AMBIGUOUS > 15% 标记为“推测过多”;INFERRED > 40% 且无 sources: 标记为“无来源综合”;入链数前 10 的枢纽页面 INFERRED > 20% 标记为“高流量页面来源可疑”;若页面有 provenance: frontmatter 块,任一字段与重算值偏差超过 0.20 则标记漂移。
  9. 碎片化标签簇:对出现于 ≥5 个页面的标签,计算内聚度 cohesion = actual_links / (n × (n−1) / 2),cohesion < 0.15 且 n ≥ 5 时标记。
  10. 可见性标签一致性:检查未标记的 PII 模式、visibility/pii 页面缺少 sources:、以及 visibility/ 标签出现在 _meta/taxonomy.md 中的配置错误。
  11. misc 提升候选:查找 misc/ 中 affinity frontmatter 字段任一项目得分 ≥ 3 的页面。
  12. 置信度与生命周期 schema:校验 lifecycle 枚举、base_confidence 范围、陈旧页面报告、非法生命周期转换、supersession 完整性、置信度审查完整性。

使用方式

开始前需遵循 llm-wiki/SKILL.md 中的检索原语表,优先使用 frontmatter 范围 grep 和按节读取。需先解析配置(遵循 Config Resolution Protocol),获取 OBSIDIAN_VAULT_PATH 及相关 schema 值;若存在 $OBSIDIAN_VAULT_PATH/AGENTS.md 则先读取,所有者规则优先于框架默认值。形成有效 schema 后,读取 index.md 获取页面清单、读取 log.md 获取近期活动上下文,并将有效 schema 显式传递给确定性检查。

当 obsidian-wiki 位于 PATH 时,优先使用 obsidian-wiki lint "$OBSIDIAN_VAULT_PATH" --json(带相同 schema 覆盖标志)并将 JSON 发现合并到健康报告中;若 CLI 不可用,则保留基于 grep 的检查,不要求该二进制文件。

置信度审查使用 obsidian-wiki trust-check "$OBSIDIAN_VAULT_PATH" --strict --json --pretty;已批准账本位于 _meta/trust-ledger.json。全库审查记录使用 obsidian-wiki trust-record 命令。

适用场景

适用于 Obsidian 知识库的定期维护、健康检查、结构问题修复,以及置信度与生命周期 schema 的合规校验。

限制

  • 所有检查跳过 _archives/、_raw/、_readouts/ 和 .obsidian/。
  • 置信度是语义判断,确定性工具无法仅从来源字符串推断独立证据谱系或整页声明覆盖,因此置信度自动化只验证明确批准的人工信任账本,绝不用 URL 计数替代审查。
  • 生命周期状态只应由人工设置,工具不自动修复。
  • 陈旧性从不存储,而是在读取时计算:is_stale = (today − updated) > 90 天。
  • 部分规则(如非法生命周期转换、supersession 完整性)仅标记供人工解决,不自动修复。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。