Skip to content

Lambenthan/empiricalwiki / .claude/skills/check

扫描全 wiki 发现健康问题,生成修复建议报告(覆盖全 9 种 entity + graph 一致性)

FileKindSize
SKILL.mdskill md7.4 KB
---
description: 扫描全 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 工具

**默认模式(只报告)**:
```bash
python3 tools/lint.py --wiki-dir wiki/ --json
```

**自动修复模式**(用户指定 `--fix` 时):
```bash
python3 tools/lint.py --wiki-dir wiki/ --fix --json
```
自动修复确定性问题(xref 反向链接补全、缺失字段填默认值),输出修复报告。

**预览模式**(用户指定 `--fix --dry-run` 时):
```bash
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 → 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 一致性(自动化覆盖)

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

记录日志:
```bash
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: 198kUpdated 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