Skip to content

Lambenthan/empiricalwiki / .claude/skills/check

扫描全 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_gaps
  • wiki/experiments/*.md — experiment 状态、target_claim、outcome
  • wiki/claims/*.md — claim confidence、status、evidence、source_papers
  • wiki/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: 结构完整性(自动化覆盖)

自动化工具检查以下项目:

  1. Broken wikilinks:[[slug]] 目标文件不存在
  2. Orphan pages:无任何入链的页面
  3. 必填字段缺失(全 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: 字段值验证(自动化覆盖)

  1. 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}
  2. Claim confidence ∈ [0.0, 1.0]
  3. Idea failure_reason:status=failed 时必须非空(anti-repetition memory)
  4. Experiment target_claim:引用的 claim 必须存在

Step 4: Cross Reference 对称性(自动化覆盖)

检查所有 CLAUDE.md 中定义的双向链接规则:

正向链接检查的反向链接
concepts.key_papers → paperspapers.Related 含 concept 链接
papers → people (wikilink)people.Key papers 含 paper
claims.source_papers → paperspapers.Related 含 claim 链接
ideas.origin_gaps → claimsclaims.Linked ideas 含 idea
experiments.target_claim → claimsclaims.evidence 含 experiment

Step 5: Graph Edge 一致性(自动化覆盖)

  1. JSON 格式有效性:每行都是合法 JSON
  2. 必填字段:每条 edge 有 from, to, type
  3. Edge type 合法性:semantic edges 使用当前 endpoint-aware type set;旧 paper-paper / paper-concept 类型给出迁移 warning
  4. Edge confidence:/ingest 写出的 paper-paper 与 paper-concept semantic edges 使用 confidence: high|medium|low
  5. Citation layer:graph/citations.jsonl 使用 type: cites、合法 source/date、paper endpoints,且不写 confidence 字段
  6. Dangling nodes:from/to 引用的 wiki 页面必须存在

Step 6: 内容质量(LLM 辅助)

自动化工具可检测的:

  1. importance=5 的论文无 concept 页引用
  2. maturity=stable 的 concept 只有 1 篇 key_paper
  3. topics 的 Open problems 为空

LLM 额外判断(需要阅读内容):

  1. Concept 近似重复检测:扫描所有 concept 页面的 title + aliases,判断是否有语义相同/高度相似的概念对(如 "attention mechanism" 和 "self-attention")。对疑似重复对输出合并建议。
  2. 矛盾表述检测(不同页面对同一事实的描述不一致)
  3. SOTA 记录超过 6 个月未更新
  4. people 的 Recent work 超过 6 个月未更新
  5. claim confidence 与 evidence 数量/强度不匹配
  6. 高 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/ — 获取统计信息(可选,用于报告)
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall