empiricalwiki: Skill for Claude Code

/prefill

将领域基础知识（奠基性方法、common practice、标准架构）作为终端页面沉淀到 wiki/foundations/。 Foundations 设计上单向：其他页面可以链接到 foundation，foundation 不写反向链接。

Trigger

手动：/prefill [domain] 或 /prefill --add "概念名"。

Inputs

• domain（位置参数，可选）：研究领域 — general / NLP / CV / ML Systems / Robotics 之一。未指定时从 wiki/topics/ 标签推断；若 topics 为空则提示用户。
• --add "<概念>"：跳过 catalog，直接为单个概念建立 foundation。

Outputs

• wiki/foundations/{slug}.md — 每个种子一页
• 更新的 wiki/index.md（由 rebuild-index 重生成 foundations 段落）
• wiki/log.md 一条记录

Wiki Interaction

读取

• wiki/topics/*.md — 用于推断 domain（未指定时）
• wiki/foundations/*.md — 跳过已存在的 foundation（幂等）
• .claude/skills/prefill/foundations-catalog.yaml — 种子列表

写入

• wiki/foundations/{slug}.md（仅新建，从不覆盖）
• wiki/index.md（通过 tools/research_wiki.py rebuild-index）
• wiki/log.md（通过 tools/research_wiki.py log）

Workflow

前置条件：当前目录包含 wiki/、tools/、.claude/。WIKI_ROOT=wiki/。

Step 1: 确定 domain

1. 用户传入 domain → 直接使用。
2. 否则若处于 --add 模式 → 默认 general，除非用户额外指定。
3. 否则：读取 wiki/topics/*.md 的 frontmatter tags；若能识别出主导 domain 则用之，否则提示用户。

Step 2: 加载种子

• Catalog 模式：读取 .claude/skills/prefill/foundations-catalog.yaml，取 domains.{domain} 下所有条目，并叠加 domains.general 的全部条目（general foundations 适用所有领域）。
• --add 模式：构造单一种子 {slug: <slugified concept>, title: <concept>, summary: ""}。Slug 用 python3 tools/research_wiki.py slug "<concept>" 生成。

对每个种子，若 wiki/foundations/{slug}.md 已存在则跳过（不覆盖、不警告）。

Step 3: 从 Wikipedia 拉取背景

对每个剩余种子调用 tools/fetch_wikipedia.py：

python3 tools/fetch_wikipedia.py summary "<title>"
python3 tools/fetch_wikipedia.py sections "<title>"
python3 tools/fetch_wikipedia.py section "<title>" --index <N>   # 拉取相关章节

• summary 调用返回 {title, extract, url}。
• sections 调用返回 [{index, line, level}, ...] — 选取 line 包含 Variants / Types / Architecture / History / Limitations / Applications 的章节（大小写不敏感子串匹配）。
• 任意调用退出码为 2 表示页面不存在 — 该种子回退到 LLM 知识，生成的 frontmatter 中 source_url: ""。