| name | lint |
| description | 知识库全局健康度检查。扫描 wiki/ 目录，检测死链（页面引用不存在的双链）、孤儿页面（无任何页面引用它）、未同步索引（文件存在但未在 index.md 注册）和知识冲突。当用户输入 /lint、/scan、/health 或要求“检查知识库状态”、“检查健康”时调用。 |
| user-invocable | true |
lint 技能：知识图谱健康巡检
核心目标
将软件工程中的“静态代码分析”引入知识管理。定期运行此 skill，找出知识库长期演进中产生的：死链、孤岛、未同步索引、认知冲突。
触发条件
- 用户输入
/lint
- 用户询问“我的知识库健康状况如何”
- 用户要求“检查知识库状态”或“检查健康”
知识库路径
- 使用 Glob 工具动态定位当前工作区下的 wiki/ 目录
巡检流水线
第 1 步：索引一致性检查
- 读取
wiki/index.md 全部内容
- 扫描
wiki/ 下所有 .md 文件（排除 index.md 和 log.md）
- 提取 index.md 中注册的所有双链链接
[[页面名称]]
- 比对：找出已注册但文件不存在的条目 OR 文件存在但未注册的页面
第 2 步：双向链接健康检查
- 扫描所有
.md 文件，提取所有 [[双链]] 格式的链接
- 如果链接指向的页面不存在 → 标记为死链
- 统计被引用的页面（排除 self-reference）
- 找出从未被任何其他页面引用的页面 → 孤儿页面
第 3 步：认知冲突审查
- 全局搜索所有
.md 文件中包含 ## 知识冲突 的页面
- 提取每个冲突的简要描述（冲突双方是什么）
- 统计带未解决冲突的页面（认知技术债）
第 4 步：收件箱积压检查（可选跳过）
- 本 skill 仅扫描 wiki/，跳过 raw/ 收件箱检查
报告输出规范
扫描完成后，输出结构化报告，严格遵循以下格式：
## 🩺 知识库健康体检报告 — YYYY-MM-DD
### ✅ 绿灯项
- [运行良好的项目]
### ⚠️ 黄灯项
- **发现 N 个孤儿页面**：[列表] - 建议添加关联或分类
- **发现 N 个未同步索引**：[列表] - 文件存在但未在 index.md 注册
### ❌ 红灯项
- **发现 N 个死链**：[来源页面] → [[不存在的目标页面]]
- **存在 N 个未解决的知识冲突**：[页面名称]
### 🛠️ 下一步行动
1. 是否需要自动修复未同步索引？
2. 是否需要针对知识冲突进行重新推演？
硬约束
- 仅读扫描：生成报告前，禁止修改、删除、重命名任何文件
- 手动确认：报告后等待用户确认再执行修复
- 静默日志：修复完成后，在 wiki/log.md 追加
## [YYYY-MM-DD] lint | 修复了 N 个问题
