Lambenthan/empiricalwiki / .claude/skills/check
check
Verified扫描全 wiki 发现健康问题,生成修复建议报告(覆盖全 9 种 entity + graph 一致性)
/check
扫描全 wiki,发现结构、链接、字段、graph 的健康问题,生成分级修复建议。 覆盖所有 9 种 entity 类型,包括 claims confidence 合理性、idea 失败原因完整性、 experiment-claim 链接有效性、graph edges 一致性。
Inputs
- 全 wiki 目录(默认
wiki/) - 可选:
--json标志(通过 tools/lint.py 输出 JSON 格式) - 可选:
--fix标志(自动修复确定性问题) - 可选:
--fix --dry-run(预览修复但不执行) - 可选:
--suggest标志(显示非自动修复问题的建议)
Outputs
- Lint report(直接报告给用户)
- 可选写入文件:
wiki/outputs/lint-report-{date}.md
Wiki Interaction
Reads
wiki/papers/*.md— 论文页面字段和链接wiki/concepts/*.md— 概念页面字段和链接wiki/topics/*.md— 方向页面字段和链接wiki/people/*.md— 人物页面字段和链接wiki/ideas/*.md— idea 状态、failure_reason、origin_gapswiki/experiments/*.md— experiment 状态、target_claim、outcomewiki/claims/*.md— claim confidence、status、evidence、source_paperswiki/Summary/*.md— 综述页面字段wiki/graph/edges.jsonl— semantic graph edge 一致性检查wiki/graph/citations.jsonl— bibliographic citation 一致性检查wiki/index.md— 对照页面完整性
Writes
- 不直接修改 wiki 内容(只报告不修复)
wiki/log.md— 通过tools/research_wiki.py log记录 lint 结果摘要
Workflow
前置:确认工作目录为 wiki 项目根(包含 wiki/、raw/、tools/ 的目录)。
设 WIKI_ROOT=wiki/。
Step 1: 运行自动化 lint 工具
默认模式(只报告):
python3 tools/lint.py --wiki-dir wiki/ --json
自动修复模式(用户指定 --fix 时):
python3 tools/lint.py --wiki-dir wiki/ --fix --json
自动修复确定性问题(xref 反向链接补全、缺失字段填默认值),输出修复报告。
预览模式(用户指定 --fix --dry-run 时):
python3 tools/lint.py --wiki-dir wiki/ --fix --dry-run --json
预览会修复什么,不实际执行。
解析 JSON 输出,获取所有自动检测到的 issues(及修复结果)。
Step 2: 结构完整性(自动化覆盖)
自动化工具检查以下项目:
- Broken wikilinks:
[[slug]]目标文件不存在 - Orphan pages:无任何入链的页面
- 必填字段缺失(全 9 种 entity):
- papers: title, slug, tags, importance
- concepts: title, tags, maturity, key_papers
- topics: title, tags
- people: name, tags
- Summary: title, scope, key_topics
- ideas: title, slug, status, origin, tags, priority
- experiments: title, slug, status, target_claim, hypothesis, tags
- claims: title, slug, status, confidence, tags, source_papers, evidence
Step 3: 字段值验证(自动化覆盖)
- Enum 值检查:
- papers.importance ∈ {1,2,3,4,5}
- concepts.maturity ∈ {stable, active, emerging, deprecated}
- ideas.status ∈ {proposed, in_progress, tested, validated, failed}
- ideas.priority ∈ {1,2,3,4,5}
- experiments.status ∈ {planned, running, completed, abandoned}
- experiments.outcome ∈ {succeeded, failed, inconclusive}
- claims.status ∈ {proposed, weakly_supported, supported, challenged, deprecated}
- Claim confidence ∈ [0.0, 1.0]
- Idea failure_reason:status=failed 时必须非空(anti-repetition memory)
- Experiment target_claim:引用的 claim 必须存在
Step 4: Cross Reference 对称性(自动化覆盖)
检查所有 CLAUDE.md 中定义的双向链接规则:
| 正向链接 | 检查的反向链接 |
|---|---|
| concepts.key_papers → papers | papers.Related 含 concept 链接 |
| papers → people (wikilink) | people.Key papers 含 paper |
| claims.source_papers → papers | papers.Related 含 claim 链接 |
| ideas.origin_gaps → claims | claims.Linked ideas 含 idea |
| experiments.target_claim → claims | claims.evidence 含 experiment |
Step 5: Graph Edge 一致性(自动化覆盖)
- JSON 格式有效性:每行都是合法 JSON
- 必填字段:每条 edge 有 from, to, type
- Edge type 合法性:semantic edges 使用当前 endpoint-aware type set;旧 paper-paper / paper-concept 类型给出迁移 warning
- Edge confidence:
/ingest写出的 paper-paper 与 paper-concept semantic edges 使用confidence: high|medium|low - Citation layer:
graph/citations.jsonl使用type: cites、合法 source/date、paper endpoints,且不写 confidence 字段 - Dangling nodes:from/to 引用的 wiki 页面必须存在
Step 6: 内容质量(LLM 辅助)
自动化工具可检测的:
- importance=5 的论文无 concept 页引用
- maturity=stable 的 concept 只有 1 篇 key_paper
- topics 的 Open problems 为空
LLM 额外判断(需要阅读内容):
- Concept 近似重复检测:扫描所有 concept 页面的 title + aliases,判断是否有语义相同/高度相似的概念对(如 "attention mechanism" 和 "self-attention")。对疑似重复对输出合并建议。
- 矛盾表述检测(不同页面对同一事实的描述不一致)
- SOTA 记录超过 6 个月未更新
- people 的 Recent work 超过 6 个月未更新
- claim confidence 与 evidence 数量/强度不匹配
- 高 priority idea 长期停留在 proposed 状态
Step 7: 生成报告
按优先级排序输出:
## Lint Report — YYYY-MM-DD
**Summary**: N 🔴, M 🟡, K 🔵
### 🔴 需立即修复
1. [file] — {issue description}
### 🟡 建议修复
1. [file] — {issue description}
### 🔵 可选优化
1. [file] — {issue description}
分类标准:
- 🔴 需立即修复:broken links、missing required fields、invalid enum values、failed idea without failure_reason、invalid JSON in edges、confidence out of range
- 🟡 建议修复:xref asymmetry、dangling graph edges、broken claim references、unknown edge types
- 🔵 可选优化:orphan pages、quality suggestions、empty sections
记录日志:
python3 tools/research_wiki.py log wiki/ "check | report: N 🔴, M 🟡, K 🔵"
Constraints
- 默认只报告:不带
--fix时只报告不修复 --fix仅修复确定性问题:xref 反向链接补全、缺失字段填安全默认值。不确定的问题输出建议(--suggest),由用户手动批准- raw/ 只读:不修改
raw/下的文件 - graph/ 只读:lint 不修改 graph 文件,仅检查一致性
- LLM 判断标注来源:自动化检查和 LLM 判断在报告中明确区分
- 幂等:多次运行产生相同结果(除非 wiki 内容变化)
Error Handling
- wiki/ 不存在:报错并建议运行
/init - graph 文件不存在:跳过缺失 graph 文件的检查,在报告中注明
- 部分目录缺失:跳过缺失目录的检查,在报告中列出缺失目录
Dependencies
Tools(via Bash)
python3 tools/lint.py --wiki-dir wiki/ [--json] [--fix] [--dry-run] [--suggest]— 自动化结构检查 + 修复(核心依赖)python3 tools/research_wiki.py log wiki/ "<message>"— 追加日志python3 tools/research_wiki.py stats wiki/— 获取统计信息(可选,用于报告)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |