lint

name	lint
description	知识库健康度检查。扫描 wiki/ 目录，自动修复索引同步和 frontmatter 缺失问题。对于死链、孤岛页面、知识冲突、标签爆炸，生成报告供人工决策。当用户输入 /lint、/scan、/health 或要求"检查知识库状态"时调用。
user-invocable	true

Lint 技能

核心目标

定期"体检"知识库，自动修复安全问题，对需要人工决策的问题生成报告。

核心原则：保守修复，不确定的操作生成报告供人工决策。

触发条件

• 用户输入 /lint
• 用户询问"我的知识库健康状况如何"
• 用户要求"检查知识库状态"或"检查健康"

知识库路径

使用 Glob 工具动态定位当前工作区下的 wiki/ 目录

---

工作流程

步骤 1：索引同步检查（自动修复）

读取总索引：

Read wiki/index.md

检查项：

1. 提取索引中注册的所有页面
2. 扫描 wiki/ 下所有 .md 文件（排除 index.md、log.md、README.md 和 _conflicts/ 目录）
3. 比对差异

自动修复：

• 文件存在但未注册 → 读取文件的 frontmatter，自动添加到 index.md 对应的 domain + type 分组
• 已注册但文件不存在 → 从 index.md 删除该条目，记录到 log.md

修复日志：

## [YYYY-MM-DD] lint | 索引同步修复
- 新增到索引：[[页面1]], [[页面2]]
- 从索引删除：[[不存在的页面]]

---

步骤 2：死链检测（生成报告）

扫描所有 .md 文件，提取所有 [[双链]] 格式的链接

检查项：

• 如果链接指向的页面不存在 → 标记为死链

生成建议报告（不自动修复）：

1. 相似页面替换建议：

   • 计算编辑距离（Levenshtein distance < 3）
   • 如果找到相似页面 → 建议替换
   • 示例：[[Transformr]] → 建议替换为 [[Transformer]]

2. 无法修复的死链：

   • 如果找不到相似页面 → 标记为需要人工处理

报告格式：

### 死链检测 (N 处)
- `[[错误链接]]` 在 [[页面A]] → 建议替换为 `[[正确链接]]`
- `[[不存在的页面]]` 在 [[页面B]] → 无相似页面，建议删除或创建

---

步骤 3：孤岛页面检测（生成报告）

统计被引用次数：

• 扫描所有页面，统计每个页面被其他页面引用的次数（排除 self-reference）
• 找出 0 入链的页面 → 孤岛页面

生成建议报告（不自动修复）：

1. 读取孤岛页面的内容和 frontmatter（type, tags）
2. 根据 tags，找到 3-5 个最相关的页面
3. 建议在这些页面的 ## 关联连接 区域添加链接

报告格式：

### 孤岛页面检测 (N 个)
- [[孤岛页面A]] (tags: #AI #NLP) → 建议在 [[页面1]], [[页面2]], [[页面3]] 中添加链接
- [[孤岛页面B]] (tags: #财务) → 建议在 [[页面4]], [[页面5]] 中添加链接

---

步骤 4：Frontmatter 规范检查（自动修复）

对每个页面检查：

必需字段：

• type (concept | entity | source | synthesis)
• tags (数组，3-5 个)
• created (YYYY-MM-DD)
• updated (YYYY-MM-DD)

自动修复策略：

1. 缺失 type → 根据文件路径推断（concepts/ → concept）
2. 缺失 created/updated → 使用文件时间戳
3. tags 数量不足 → 不自动补全，生成报告

修复日志：

## [YYYY-MM-DD] lint | Frontmatter 修复
- 补全 type：3 个页面
- 补全 created/updated：5 个页面

---

步骤 5：知识冲突检测（生成报告）

全局搜索：

• 使用 Grep 工具搜索所有包含 ## 知识冲突 的页面

生成冲突报告： 对每个冲突页面，在 wiki/_conflicts/ 创建冲突文件：

---
title: "知识冲突：<主题>"
created: YYYY-MM-DD
pages: [[页面A]], [[页面B]]
---

## 冲突描述
- **页面 A** ([[页面A]]) 说：[摘录冲突内容]
- **页面 B** ([[页面B]]) 说：[摘录冲突内容]

## 来源
- 页面 A 来源：[sources 字段]
- 页面 B 来源：[sources 字段]

## 建议
[LLM 分析后的建议]

## 决策
[ ] 采纳建议
[ ] 保留页面 A
[ ] 保留页面 B
[ ] 自定义合并方案：___________

不自动修复，等待用户决策。

---

步骤 6：标签爆炸检测（生成报告）

统计标签使用情况：

• 扫描所有页面的 frontmatter，统计每个标签的使用次数

检查项：

1. 单次使用标签 — 只被使用 1 次的标签
2. 相似标签 — 语义相似但拼写不同（如 深度学习 vs DeepLearning）
3. 标签数量异常 — 页面标签数量 < 3 或 > 5

生成报告（不自动修复）：

## 标签健康报告

### 单次使用标签（建议删除或合并）
- `标签1` — 仅在 [[页面A]] 使用
- `标签2` — 仅在 [[页面B]] 使用

### 相似标签（建议统一）
- `深度学习` (5 次) vs `DeepLearning` (2 次) → 建议统一为 `深度学习`
- `机器学习` (8 次) vs `ML` (3 次) → 建议统一为 `机器学习`

### 标签数量异常
- [[页面C]] — 只有 1 个标签（建议补充）
- [[页面D]] — 有 8 个标签（建议精简）

是否需要批量替换标签？

---

最终报告输出

扫描和修复完成后，生成报告到 wiki/_lint/report_YYYY-MM-DD.md：

# 知识库健康体检报告 — YYYY-MM-DD

## 总体统计
- 页面总数：N
- 标签总数：N
- 平均每个页面被引用次数：N

## 自动修复完成
- 索引同步：新增 X 个，删除 Y 个
- Frontmatter：补全 X 个页面的缺失字段

## 建议修复（需用户确认）

### 死链检测 (N 处)
- `[[错误链接]]` 在 [[页面A]] → 建议替换为 `[[正确链接]]`

### 孤岛页面检测 (N 个)
- [[孤岛页面A]] → 建议在 [[页面1]], [[页面2]] 中添加链接

### 标签建议
- 单次使用标签：`标签1` (仅在 [[页面A]])
- 相似标签：`深度学习` (5次) vs `DeepLearning` (2次) → 建议统一

## 人工决策（仅报告）

### 知识冲突 (N 个)
- [[页面A]] 与 [[页面B]] 存在观点冲突，详见 `wiki/_conflicts/`

### 页面重复 (N 个)
- [[页面C]] 与 [[页面D]] 标题相似度 85%，建议合并

## 下一步行动
1. 查看 `wiki/_conflicts/` 目录，决策知识冲突
2. 确认是否批量替换相似标签
3. 为孤岛页面添加链接

同时在对话中输出简化版本，提示用户查看完整报告。

---

操作日志

修复完成后，在 wiki/log.md 末尾追加：

## [YYYY-MM-DD] lint | 周度健康检查
- 自动修复: 索引同步 3 处，Frontmatter 补全 5 处
- 建议修复: 死链 2 处，孤岛页面 1 处
- 人工决策: 知识冲突 1 个

不自动执行 Git 提交，而是提示用户：

✅ Lint 完成
- 自动修复：X 处
- 建议修复：Y 处（详见报告）
- 完整报告：wiki/_lint/report_YYYY-MM-DD.md

使用 `/sync` 提交到 Git

---

强制约束

• 先检测后修复 — 完成所有检测后，再执行自动修复
• 保守修复 — 不确定的操作不要自动执行，生成报告供人工决策
• 记录所有操作 — 修复的每一步都要记录到 log.md
• 不修改源文件 — 只修复 wiki/ 目录下的文件，不触碰 raw/

关联连接

• [[wiki/index.md]] — 总索引
• [[wiki/log.md]] — 操作日志
• [[wiki/_conflicts/]] — 冲突报告目录
• [[CLAUDE.md]] — Wiki 架构总规范