wiki-lint

Wiki Health Check

1. Scan

Read these files to build a global view:

• CLAUDE.md — schema
• _index.md — index
• All files under _wiki/ — wiki pages
• _log.md — recent operations

2. Run 7 checks

2.1 Contradiction detection

Scan for conflicting facts across wiki pages. Focus on: same events described differently, conflicting technical conclusions.

2.2 Stale content

Flag pages with updated older than 90 days. Prioritize: entity pages, timelines (things that change over time). Stable concept pages are OK.

2.3 Orphan pages

Find wiki pages with zero inbound [[]] links. Every page should be referenced by _index.md or another wiki page.

2.4 Broken links

Find all [[]] links pointing to non-existent files. Distinguish: directory-level (whole dir missing) vs file-level (typo).

2.5 Missing concepts

Scan raw notes for topics mentioned in 3+ notes that lack their own wiki concept page.

2.6 Index integrity

Compare _index.md vs actual _wiki/ files:

• Listed in index but doesn't exist
• Exists in _wiki/ but not in index

2.7 Frontmatter integrity

Check all _wiki/ pages for:

• Required fields: tags, created, updated, sources
• sources count matches actual source notes section entries

3. Generate report

# Wiki Lint 报告 — TODAY

## 概览
- Wiki 页面总数：X
- 检查通过项：Y/7
- 需要关注项：Z/7

## 发现

### [严重程度] 检查项名称
- 具体问题
- 修复建议

Severity: 错误 (broken links, index mismatch) / 警告 (orphans, missing concepts) / 建议 (stale content)

4. Save report

Write to _wiki/lint-TODAY.md

5. Offer fixes

Ask user: "发现 N 个问题。要我自动修复 [list] 吗？"

• Auto-fixable: broken links, index gaps, frontmatter, missing cross-links
• Needs human decision: contradiction resolution, whether to create missing concept pages

6. Log

Append to _log.md:

## [TODAY] lint | 健康检查

Lint 报告 → `_wiki/lint-TODAY.md`。发现：X 个错误、Y 个警告、Z 个建议。

Constraints

• Never modify raw source files — only check and fix wiki layer
• Reports must have specific filenames and actionable suggestions, not vague statements
• If everything is healthy, explicitly say "全部通过，无需操作"