empiricalwiki: Skill for Claude Code

/discover

从三种 seed 模式之一产出一份排好序的候选论文 shortlist，附带每条候选的 rationale，呈现给用户或调用方 skill。/discover 绝不自动 ingest —— 它只负责提出候选，实际动作由 /ingest 负责。

按需打开下列本地参考文件：

• references/seed-modes.md —— 如何把用户的措辞映射到 anchor / topic / wiki 模式，以及三者的选择规则
• references/ranking-signals.md —— tools/discover.py 的打分依据，以及为什么 discovery 不共享 /init 的 survey 偏好
• references/wiki-dedup.md —— 候选如何被过滤掉已 ingest 的论文，以及 dedup 边界

Inputs

• --anchor <id>（可重复）：一或多个 anchor 论文 ID（优先 arXiv ID，也接受 S2 paperId）。驱动 anchor 模式 —— 主要使用场景，包括 /ingest 后的 "接下来该读什么"。
• --negative <id>（可重复，可选）：希望推开的论文 ID。只在配合 --anchor 时有意义。
• --topic "<str>"：topic / query 字符串。驱动 topic 模式 —— 相对 /init planner 更轻量的替代。
• --from-wiki：自动从 wiki 最近修改过的论文页派生 seed。驱动 wiki 模式。
• --limit N（可选，默认 10）：shortlist 最大长度。

--anchor、--topic、--from-wiki 三者必须恰好选一。

Outputs

• .checkpoints/discover-{seed-slug}-{YYYY-MM-DD}.json —— 完整 shortlist payload，机器可读；seed slug 基于首个 anchor 或 topic 派生
• 给用户的 markdown 摘要，包含每条候选的 rationale
• wiki/log.md —— 通过 tools/research_wiki.py log 追加一行

/discover 除了 log.md 外不向 wiki/ 写入任何内容，也不触碰 raw/。是否把候选拉进 wiki 是调用方的决定（之后的 /ingest）。

Wiki Interaction

Reads

• wiki/papers/*.md —— frontmatter 中的 arxiv（或旧版 arxiv_id），用于与已 ingest 的论文做 dedup
• wiki/papers/*.md 修改时间 —— 用于 --from-wiki 模式下 anchor 选取

Writes

• wiki/log.md —— 通过 tools/research_wiki.py log APPEND

Graph edges created

• 无。图变更属于 /ingest，不属于 /discover。

Workflow

前置条件：工作目录包含 wiki/、raw/、tools/。一次解析 Python 解释器路径并复用：

if [ -x .venv/bin/python ]; then
  PYTHON_BIN=.venv/bin/python
elif [ -x .venv/Scripts/python.exe ]; then
  PYTHON_BIN=.venv/Scripts/python.exe
else
  PYTHON_BIN=python3
fi
export PYTHON_BIN

Step 1: 选定 seed 模式

把用户请求映射到 from-anchors、from-topic 或 from-wiki 之一。决策规则见 references/seed-modes.md，简版：

• 用户指明了一或多篇具体论文，或者这是 /ingest --discover 的后续 → anchors
• 用户给的是 topic / 方向 / 关键词 → topic
• 用户问开放式 "接下来读什么"，没有 anchor 也没有 topic → wiki