AGENT SKILL
wiki-lint
Run semantic wiki lint beyond structural link checks. Use when the user asks to audit, lint, health-check, find stale claims, find unsupported claims, check provenance, or identify contradictions in the wiki.
使用场景代码审查
- License 许可
- MIT
- 最近更新
- 2026-10-16
- Stars
- ★ 12
- Forks
- 9
01 前言 Front Matter
- name
- wiki-lint
- description
- Run semantic wiki lint beyond structural link checks. Use when the user asks to audit, lint, health-check, find stale claims, find unsupported claims, check provenance, or identify contradictions in the wiki.
03 SKILL.md 正文
Run a semantic lint pass over the business-idea wiki. This complements the Notion helper checks in docs/agent/workflows.md; it does not replace them.
Start with deterministic checks.
- Run the deterministic Notion helper checks from
docs/agent/workflows.md. - Read the relevant Notion idea page before reading deep-dive pages.
Semantic checks. For each idea, inspect the overview and its related deep-dive notes for:
- Unsupported material claims. Any statistic, price, legal statement, named competitor claim, market-size claim, or dated event must have a raw-source line citation.
- Unmarked synthesis. Claims that are inferred from multiple sources, not directly stated by one source, should carry
^[inferred]. - Ambiguity drift. Contested or weak claims should carry
^[ambiguous]and should not be written as settled. - User-only premises. Founder assertions, anecdotes, and "everyone says yes" style evidence should carry
^[user-claim]unless independently validated. - Risk/verdict mismatch. If a risk could kill the idea, the verdict and Next moves must reflect it.
- Answered validations. If a
Still to validateitem is already answered in a deep-dive or raw note, update or remove it. - Stale claims. Pages older than 90 days should be checked for date-sensitive claims before being treated as current.
- Mapping mismatch. Notion pages that should be script-addressable should either be added to
notion.config.jsonor explicitly left as manually navigated child pages. - Prose bloat. Flag any sentence over ~20 words, any bullet carrying two claims, and any run of more than ~3 sentences of prose. Rewrite to the
## Outputrules inAGENTS.md.
Report format. Lead with the highest-severity findings:
## Semantic Lint
### P1
- [Page](path) — claim/risk. Why it matters. Suggested fix.
### P2
- ...
### Maintenance
- Mapping/index/log/hot-cache updates needed.
Use priorities this way:
- P1: Could change the verdict or invalidate a next move.
- P2: Material but not immediately verdict-changing.
- P3: Hygiene, clarity, or future retrieval quality.
If the user asked you to fix issues, edit the Notion wiki directly, then run the ritual (AGENTS.md § Mechanics).