---
description: frontmatter 校验 + lint 体检
argument-hint: [可选：路径，默认全库]
---

跑知识库健康体检。

1. 执行：`python3 tools/kb-lint-fm.py $ARGUMENTS`（无参数则扫全库）。
2. 解读退出码：
   - `0`：全绿，简报"检查 N 页，0 错误"。
   - `1`：有 frontmatter 错误（缺硬必填 / 未激活 type / enum 非法 / 派生必填缺失）。
   - `2`：环境问题（缺 PyYAML → 提示 `pip install pyyaml`；缺契约文件）。
3. 对每条错误：
   - **安全项**（补 title、补可推导字段、加 wikilink）→ 你直接自动修，修完重跑确认。
   - **有损项**（删页、合并、改 type、解决矛盾）→ 列出来交用户拍板，**不擅自改**。
4. 简报修了什么、还剩什么需人处理。

校验规则一律以 `meta/kb-contract.yaml` 为准。