| name | kb-lint |
| description | 对知识库进行健康检查。当用户说"检查知识库"、"知识库健康度"、"lint"、"kb lint"时触发。
检查断链、孤岛、溯源、一致性、覆盖度,发现潜在的新文章候选。
|
| user-invocable | true |
知识库健康检查
对 wiki 进行全面检查,发现问题并提供修复建议。
执行步骤
Step 1: 定位知识库
- 查找
index/MASTER-INDEX.md 确定根目录
Step 2: 执行六项检查
检查 1: 断链检查
- 用 Grep 工具搜索所有 wiki/ 下 .md 文件中的
[[...]] 双链
- 检查每个链接目标是否存在对应文件
- 列出所有断链:文件 → 不存在的链接目标
检查 2: 孤岛检查
- 统计每篇 wiki 文章被其他文章链接的次数
- 列出没有被任何文章链接的"孤岛"文章(不含索引文件)
检查 3: 溯源检查
- 读取所有 wiki 文章的 frontmatter
compiled_from 字段
- 检查指向的 raw/ 文件是否存在
- 列出溯源断裂的文章
检查 4: 一致性检查
- 通读 wiki 文章,寻找同一概念在不同文章中的矛盾描述
- 如参数值不一致、定义冲突等
- 列出矛盾点及涉及的文章
检查 5: 覆盖度检查
- 读
index/RAW-REGISTRY.md,统计 status=pending 的条目数量
- 报告未编译的文件比例
检查 6: 空白发现
- 分析 wiki 文章间的关系网络
- 发现缺失的关联(如某概念提到但没有独立文章)
- 建议可以写的新文章
Step 3: 输出 Lint 报告
Step 4: 提供修复选项
- 对可自动修复的问题(断链可以删除或创建空文章),询问用户是否修复
- 对需要人工判断的(一致性矛盾),标注需要确认
- 将 lint 结果摘要保存到
index/LINT-REPORT.md(供 /kb-status 读取)