Menú
Health-check the wiki for contradictions, broken links, orphan pages, and missing concepts
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Use when a wiki concept/entity/source page or a mm chapter needs a visual TL;DR card. Produces a `.mdx` file that renders through `<OneShotCard>` in the Astro site. Design-first workflow — different cards should LOOK different.
End-to-end pipeline for writing mental-model chapters: brainstorming → research & wiki building → editorial drafting → bilingual writing → review/optimize/enrich → wrap-up. Use this skill whenever the user wants to write a new mental-model chapter, continue work on an in-progress chapter, or asks about the mental-model writing workflow. Triggers on: “写 ch-XX”, “start chapter”, “mental model”, “心智模型”, “new chapter”, “下一篇”, “进入正式撰写”.
Use when a source document needs to be digested into the wiki. Without this, raw sources sit unconnected — no summary, no concept extraction, no cross-references, no discoverability. Takes a local file path or URL.
Use when you have a URL and want to preserve it locally before it disappears or changes. Web content is ephemeral; local markdown is permanent.
Use when asking questions about ingested knowledge, comparing concepts across sources, or checking what the wiki knows about a topic. Prevents relying on stale memory when curated knowledge exists.
Use for any wiki-related task — clipping sources, ingesting knowledge, checking health, or querying. Routes automatically so you don't need to remember sub-skill names.
| name | llm-wiki-lint |
| description | Health-check the wiki for contradictions, broken links, orphan pages, and missing concepts |
| argument-hint | [{"scope":"all | directory | file"}] |
| user-invocable | true |
对 wiki 做体检。Use after ingest, before committing wikis/, or when wiki quality feels off.
Lint 是纯只读操作（除了追加 wikis/log.md）。绝不自动修复任何东西——修复是人的决策。
$ARGUMENTS 是 lint 范围：
all（默认）：扫描整个 wikis/wikis/concepts/）：只扫描该目录wikis/concepts/tool-use.md）：扫描该文件 + 所有被它链接的页面 + 所有链接到它的页面all：Glob 列出 wikis/ 下所有 .md（排除 index.md、log.md）。.md。逐一读取内容。
对每个页面中的 [text](path) 链接，解析相对路径为绝对路径，检查目标文件是否存在。
断链意味着知识在无声地断裂——有人顺着链接走过去，什么都找不到。
构建页面间的引用关系图。找出零 inbound link 的页面。index.md 中的链接不算 inbound（index 是导航页，不代表知识关联）。
Orphan 页面意味着它和 wiki 的知识网络完全脱节——存在但不可达。
Glob 列出 wikis/sources/、wikis/concepts/、wikis/entities/ 的所有 .md，与 wikis/index.md 的 entry 对比。找出：
Index 不一致意味着导航是骗人的——用户看到的 wiki 地图和实际 wiki 对不上。
读取页面内容，用 LLM 判断找出对同一概念的不一致描述。重点：
这步依赖 LLM 判断。标记为"可疑矛盾"即可，不要求 100% 确定。
矛盾意味着 wiki 在对同一个问题给出两个答案——查询者不知道该信谁。
扫描所有页面，找出被提到 ≥3 次但没有独立页面的概念或实体。
频繁提及但没有页面，意味着有一个重要概念散落在各处却没有汇聚点。
每个 concept 页面应有对应的 infograph card PNG 存放在 wikis/concepts/assets/{slug}.png。检查两类问题：
缺失 card：concept 页面存在但 assets/{slug}.png 不存在。这意味着文档站上该 concept 没有图文切换功能。
card 内容过时：当 card PNG 存在时，比较 PNG 的修改时间和 concept .md 文件的修改时间。如果 .md 比 .png 更新，说明 concept 内容已更新但 card 未重新生成。标记为"card 可能过时"。
在 report 中加一节：
### Concept Cards (N missing, M stale)
- Missing: `harness-engineering.md` (no PNG)
- Stale: `context-management.md` (md: 2026-04-07, png: 2026-04-01)
在 log 条目中加：Card: N missing, M stale
与 7a 相同的检查逻辑，但针对 entity 页面。每个 entity 页面应有对应的 infograph card PNG 存放在 wikis/entities/assets/{slug}.png。
检查两类问题：
缺失 card：entity 页面存在但 assets/{slug}.png 不存在。
card 内容过时：entity .md 比 .png 更新。
在 report 中加一节：
### Entity Cards (N missing, M stale)
- Missing: `anthropic.md` (no PNG)
- Stale: `openai.md` (md: 2026-04-07, png: 2026-04-01)
在 log 条目中加：Entity Card: N missing, M stale
全局 lint 时，从 wikis/concepts/ 和 wikis/sources/ 各随机抽 1-2 篇信息密度最高的页面，调用 /ljg-plain 做可读性压力测试。
ljg-plain 用 9 条红线检验：嘴巴测试（会这样跟朋友说话吗？）、零术语、短词优先、一句一意、具体名词、开头要有吸引力、无废话、信任读者、诚实。
产物处理：ljg-plain 输出 org 文件到 ~/Documents/notes/。
### Readability Spot-Check，列出抽查结果。~/Documents/notes/ 中的 org 文件。这是诊断，不是修改。标记问题，让人决定是否改。
当 wikis/concepts/ 页面数 ≥20 时，调用 /ljg-rank 对 wiki 覆盖的领域做降秩分析——找出不可约的生成器。
对比降秩结果和现有 concept pages：
产物处理：ljg-rank 输出 org 文件到 ~/Documents/notes/。
### Structural Analysis (ljg-rank)。在终端输出结构化报告：
## Wiki Lint Report — [scope] — YYYY-MM-DD
### Broken Links (N)
- `wikis/concepts/foo.md` → `wikis/entities/bar.md` (not found)
### Orphan Pages (N)
- `wikis/entities/baz.md` (no inbound links)
### Index Inconsistencies (N)
- Missing from index: `wikis/concepts/new-concept.md`
- Ghost entry in index: `wikis/sources/deleted-source.md`
### Possible Contradictions (N)
- `wikis/concepts/tool-use.md` says "X", but `wikis/sources/anthropic.md` says "Y"
### Candidate New Pages (N)
- "prompt engineering" — mentioned in 4 pages, no dedicated page
### Concept Cards (N missing, M stale)
- Missing: `foo.md` (no PNG)
- Stale: `bar.md` (md: 2026-04-07, png: 2026-04-01)
### Readability Spot-Check (if scope=all)
- `wikis/concepts/xxx.md`: 可读性良好 / 第3-4段术语密度过高，建议简化
### Structural Analysis (if scope=all, concepts ≥20)
- Generators found: [list]
- Missing generator pages: [list]
- Merge candidates: [list]
### Summary
Total issues: N | Health: [HEALTHY / NEEDS ATTENTION / UNHEALTHY]
健康的 wiki：断链为零、orphan 极少、index 完全一致、矛盾为零或极少。 生病的 wiki：断链一堆、orphan 成群、index 和实际文件对不上、矛盾频繁。
在 wikis/log.md 末尾追加：
## [YYYY-MM-DD] lint | [scope]
- Broken links: N
- Orphan pages: N
- Index inconsistencies: N
- Contradictions: N
- Candidate pages: N
- Cards: N missing, M stale
- Readability: [N pages checked, M flagged] (if run)
- Structural: [N generators, M gaps] (if run)
wikis/log.md。