second-brain-lint

Second Brain — Lint

检查知识库的健康状况，并报告问题及可执行的修复方案。

审计步骤

运行以下所有检查，然后汇总报告。

1. 损坏的维基链接

扫描所有知识库页面中的 [[wikilink]] 引用。逐一验证目标页面是否存在，并报告所有损坏的链接。

# Find all wikilinks across wiki pages
grep -roh '\[\[[^]]*\]\]' wiki/ | sort -u

与 wiki/ 中的实际文件交叉核对。

2. 孤立页面

查找没有任何入站链接的页面——也就是没有其他页面通过 [[wikilink]] 引用它们。

对于 wiki/sources/、wiki/entities/、wiki/concepts/、wiki/synthesis/ 中的每个 .md 文件：

• 提取页面名称（不含扩展名的文件名）
• 在所有其他知识库页面中搜索 [[Page Name]]
• 如果没有其他页面链接到该页面，则该页面是孤立页面

3. 矛盾

阅读共享实体或概念的页面，查找相互冲突的说法。出现以下情况时进行标记：

• 两篇来源摘要对同一主题提出相反的说法
• 实体页面中的信息与来源摘要冲突
• 不同页面上的日期、数字或事实性说法不一致

4. 过时说法

将来源日期与知识库内容交叉核对。出现以下情况时进行标记：

• 概念页面仅引用旧来源，且存在关于同一主题的较新来源
• 有更新的来源提及某实体，但该实体的信息尚未更新

5. 缺失页面

扫描指向尚不存在页面的 [[wikilinks]]。这些是知识库提及但尚未为其创建专属页面的主题。评估这些主题是否值得创建页面。

6. 缺失的交叉引用

查找讨论相同主题但彼此没有链接的页面。检查以下情况：

• 提及概念但未链接到这些概念的实体页面
• 提及实体但未链接到这些实体的概念页面
• 涵盖相同主题但未相互引用的来源摘要

7. 索引一致性

检查 wiki/index.md 是否完整且准确：

• wiki/sources/、wiki/entities/、wiki/concepts/、wiki/synthesis/ 中的每个页面都有索引条目
• 没有索引条目指向已删除的页面
• 条目归属正确的分类标题

8. 数据缺口

根据知识库当前的覆盖范围，提出以下建议：

• 经常提及但缺乏深入内容的主题
• 知识库难以回答的问题
• 可通过网页搜索补充缺失信息的领域

报告格式

按严重程度分组列出发现：

错误（必须修复）

• 损坏的维基链接
• 页面之间的矛盾
• 指向缺失页面的索引条目

警告（应当修复）

• 没有入站链接的孤立页面
• 来自过时来源的过时说法
• 经常被引用但缺少对应页面的主题

信息（建议修复）

• 可添加的潜在交叉引用
• 可以补充数据的缺口
• 可以写得更清楚的索引条目

对于每项发现，请包含：

• 内容： 问题描述
• 位置： 具体文件和行号
• 修复： 应如何处理

报告之后

询问用户：

"发现 N 个错误、N 个警告和 N 条信息。要我修复其中任何问题吗？"

如果用户同意，请修复问题并报告所做的更改。

记录检查结果

将以下内容追加到 wiki/log.md：

## [YYYY-MM-DD] lint | Health check
Found N errors, N warnings, N info items. Fixed: [list of fixes applied].

何时运行检查

• 每处理 10 条来源后——趁交叉引用缺口还容易发现时及时补上
• 至少每月一次——及时发现过时说法和孤立页面
• 进行重要查询之前——在依赖知识库进行分析前，确保其状态良好

相关技能

• /second-brain-ingest — 将新来源整理到知识库页面中
• /second-brain-query — 针对知识库提问