| name | lint |
| description | 知识库全局健康度检查。扫描 笔记/Wiki/ 目录，检测死链、孤儿页面、未同步索引、知识冲突。支持 Hook 自动触发、增量扫描、自动修复建议。运行 /lint、/scan、/health 或要求"检查知识库状态"时调用。 |
| user-invocable | true |
lint 技能 v2.0
核心定位
Lint 是知识工厂的质量门禁。就像软件工程中的静态代码分析，定期运行此 skill，找出知识库长期演进中产生的技术债：死链、孤岛、未同步索引、认知冲突。
架构升级 v2.0：
- ✅ 支持 Hooks 自动触发（ingest 完成后自动 lint）
- ✅ 增量扫描：只检查变更的文件，速度提升 80%
- ✅ 自动修复建议 + 一键修复
- ✅ 健康度评分（0-100 分）
- ✅ 趋势追踪：与上次 lint 结果对比，看进步还是退步
触发条件
| 触发方式 | 说明 |
|---|
/lint | 手动触发完整扫描 |
/health | 同上 |
/scan | 同上 |
| Hook 自动触发 | ingest 完成后、每天凌晨 2 点自动运行 |
| 隐式触发 | 用户问"我的知识库怎么样了"、"检查一下健康状态" |
巡检流水线（v2.0 增强版）
前置检查：增量扫描判定
- 读取 Memory 中上次 lint 的时间和文件 hash 列表
- 计算本次变更的文件数
- 如果变更 < 30% → 启用增量扫描（只查变更文件 + 其引用的文件）
- 如果变更 ≥ 30% → 全量扫描
第 1 步：索引一致性检查
目标：确保 wiki 里有的，index.md 里都有；index.md 里有的，wiki 里都有。
执行：
- 读取
笔记/Wiki/index.md 全部内容
- 扫描
笔记/Wiki/ 下所有 .md 文件（排除 index.md 和 log.md）
- 提取 index.md 中注册的所有双链
[[页面名称]]
- 双向比对：
- ❌ 已注册但文件不存在 → 未同步索引（假条目）
- ❌ 文件存在但未注册 → 未同步索引（漏条目）
第 2 步：双向链接健康检查
目标：知识网络没有断链，没有孤岛。
执行：
- 扫描所有
.md 文件，提取所有 [[双链]]
- 如果链接指向的页面不存在 → 死链（红色告警）
- 统计被引用的页面（排除自引用）
- 从未被任何其他页面引用的页面 → 孤儿页面（黄色告警）
第 3 步：认知冲突审查
目标：找出知识库中自相矛盾的地方。
执行：
- 全局搜索所有
.md 文件中包含 ## 知识冲突 或 ⚠️ 的页面
- 提取每个冲突的：冲突双方、来源、状态（已解决/未解决）
- 统计未解决冲突的数量和严重程度
- 交叉验证：不同页面对同一话题的说法是否一致
第 4 步：Frontmatter 规范检查（新增）
目标：所有页面的元数据符合规范。
检查项：
- 是否有
type: source/entity/concept/synthesis
- 是否有
last_updated 日期
- 是否有
sources 字段（来源追溯）
tags 是否符合命名规范
第 5 步：健康度评分
根据检查结果计算健康度（0-100 分）：
| 指标 | 扣分规则 |
|---|
| 死链 | 每条扣 5 分 |
| 未解决的知识冲突 | 每个扣 10 分 |
| 孤儿页面 | 每个扣 2 分 |
| 未同步索引 | 每个扣 1 分 |
| Frontmatter 不规范 | 每个扣 0.5 分 |
等级划分：
- 90-100：🟢 健康
- 70-89：🟡 良好
- 50-69：🟠 警告
- < 50：🔴 危险
报告输出规范 v2.0
扫描完成后，输出结构化报告，严格遵循以下格式：
## 🩺 知识库健康体检报告 — YYYY-MM-DD
### 📊 健康度评分：X/100 🟢|🟡|🟠|🔴
上次得分：Y/100（提升了 Z 分 / 下降了 Z 分）
### ✅ 绿灯项
- 所有来源页面均有双向链接引用
- 所有 Frontmatter 规范检查通过
- 知识网络连通性良好（平均每个页面 X 个引用）
### ⚠️ 黄灯项
- **发现 N 个孤儿页面**：[[A]], [[B]], [[C]]
建议：添加关联或在 index.md 分类
- **发现 N 个未同步索引**：
- 有文件没注册：[[D]], [[E]]
- 有注册没文件：[[F]], [[G]]
- **发现 N 个 Frontmatter 不规范**
### ❌ 红灯项
- **发现 N 个死链**：
- [[来源页面]] → [[不存在的目标]]
- [[来源页面]] → [[不存在的目标]]
- **存在 N 个未解决的知识冲突**：
- [[页面 A]] vs [[页面 B]] 关于 X 的说法不一致
- [[页面 C]] 中标注的冲突待处理
### 🤖 一键修复建议
选择你要执行的修复：
1. [A] 自动修复未同步索引（补充缺失的注册）
2. [B] 自动标记孤儿页面（添加待分类标签）
3. [C] 自动修复 Frontmatter 规范问题
4. [D] 全部自动修复（不包含死链和知识冲突）
5. [E] 先不修复，我人工处理
### 📈 趋势分析
- 相比上次，死链减少了 X 个
- 知识冲突增加了 X 个（需要关注）
- 孤儿页面减少了 X 个
修复流程
自动修复（可一键执行）
| 问题类型 | 自动修复方式 |
|---|
| 未同步索引（有文件没注册） | 自动追加到 index.md 对应分类 |
| Frontmatter 不规范 | 自动补充缺失的字段 |
| 孤儿页面 | 添加 待分类 标签，不自动加链接 |
人工修复（必须人确认）
| 问题类型 | 处理方式 |
|---|
| 死链 | 询问用户：创建新页面 OR 删除引用 |
| 知识冲突 | 列出冲突详情，让用户选择保留哪方 |
| 未同步索引（有注册没文件） | 询问用户：创建页面 OR 删除注册 |
Hook 集成（自动化关键）
在 .claude/settings.json 中配置：
{
"hooks": {
"post-tool-call": [
"if last command was /ingest, run /lint"
],
"cron": [
"0 2 * * *: /lint"
]
}
}
设计哲学：知识库的健康是日常习惯，不是大扫除。每次加新东西都检查一下，技术债就不会积累。
硬约束
- ✅ 仅读扫描：生成报告前，禁止修改、删除、重命名任何文件
- ✅ 手动确认：报告后必须等待用户确认再执行任何修复
- ✅ 静默日志：修复完成后，在
笔记/Wiki/log.md 追加记录
- ✅ 不越界：死链和知识冲突永远不自动修复，必须人做决策
统计指标（写入 Memory）
每次 lint 完成后，在 Memory 系统记录：
- 健康度总分
- 各分项的数量（死链、孤儿、冲突等）
- 与上次的差值
这样可以追踪知识库的健康趋势："这个月死链减少了 15 个，进步很大！"
关联连接
- [[Skill_Ingest]] — ingest 完成后自动触发 lint
- [[Skill_Query]] — query 的结果质量依赖 lint 通过的知识库
- [[Hook_Mechanism]] — 事件驱动自动化的实现方式
- [[Quality_Gates]] — 知识库质量门禁的设计哲学
