lint

name	lint
description	知识库全局健康度检查。扫描 wiki/ 目录，检测死链（页面引用不存在的双链）、孤儿页面（无任何页面引用它）、未同步索引（文件存在但未在 index.md 注册）和知识冲突。当用户输入 /lint、/scan、/health 或要求“检查知识库状态”、“检查健康”时调用。
user-invocable	true

lint 技能：知识图谱健康巡检

核心目标

将软件工程中的“静态代码分析”引入知识管理。定期运行此 skill，找出知识库长期演进中产生的：死链、孤岛、未同步索引、认知冲突。

触发条件

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

知识库路径

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

巡检流水线

第 1 步：索引一致性检查

1. 读取 wiki/index.md 全部内容
2. 扫描 wiki/ 下所有 .md 文件（排除 index.md 和 log.md）
3. 提取 index.md 中注册的所有双链链接 [[页面名称]]
4. 比对：找出已注册但文件不存在的条目 OR 文件存在但未注册的页面

第 2 步：双向链接健康检查

1. 扫描所有 .md 文件，提取所有 [[双链]] 格式的链接
2. 如果链接指向的页面不存在 → 标记为死链
3. 统计被引用的页面（排除 self-reference）
4. 找出从未被任何其他页面引用的页面 → 孤儿页面

第 3 步：认知冲突审查

1. 全局搜索所有 .md 文件中包含 ## 知识冲突 的页面
2. 提取每个冲突的简要描述（冲突双方是什么）
3. 统计带未解决冲突的页面（认知技术债）

第 4 步：收件箱积压检查（可选跳过）

• 本 skill 仅扫描 wiki/，跳过 raw/ 收件箱检查

报告输出规范

扫描完成后，输出结构化报告，严格遵循以下格式：

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

### ✅ 绿灯项
- [运行良好的项目]

### ⚠️ 黄灯项
- **发现 N 个孤儿页面**：[列表] - 建议添加关联或分类
- **发现 N 个未同步索引**：[列表] - 文件存在但未在 index.md 注册

### ❌ 红灯项
- **发现 N 个死链**：[来源页面] → [[不存在的目标页面]]
- **存在 N 个未解决的知识冲突**：[页面名称]

### 🛠️ 下一步行动
1. 是否需要自动修复未同步索引？
2. 是否需要针对知识冲突进行重新推演？

硬约束

• 仅读扫描：生成报告前，禁止修改、删除、重命名任何文件
• 手动确认：报告后等待用户确认再执行修复
• 静默日志：修复完成后，在 wiki/log.md 追加 ## [YYYY-MM-DD] lint | 修复了 N 个问题