ask

/ask

对 wiki 知识库提问。LLM 读取 context_brief.md 获取全局上下文，检索相关页面， 综合回答并附带引用。好的回答可以 crystallize 回 wiki——写入 outputs/ 或创建新的 concept/claim 页面，让探索成果像 ingest 一样持续积累。

Inputs

• question：自然语言问题（如 "LoRA 和 Adapter 的核心区别是什么？"）
• --crystallize（可选）：若指定，将回答 crystallize 回 wiki（默认仅回答不写入）
• --format（可选）：输出格式，默认 markdown，可选 table / timeline / bullets

Outputs

• 始终：终端输出综合回答（含 [[slug]] 引用）
• 若 crystallize：
  • wiki/outputs/{query-slug}.md — 查询结果页面（默认 crystallize 目标）
  • 或 wiki/concepts/{slug}.md — 若回答揭示了新的跨论文概念
  • 或 wiki/claims/{slug}.md — 若回答发现了可验证的新断言
  • 更新的 wiki/graph/edges.jsonl（crystallize 产生的关系）
  • 更新的 wiki/index.md 和 wiki/log.md

Wiki Interaction

Reads

• wiki/graph/context_brief.md — 全局压缩上下文（claims, gaps, failed ideas, papers, edges）
• wiki/index.md — 页面目录，用于定位相关页面
• wiki/graph/open_questions.md — 开放问题，辅助判断问题是否涉及已知知识缺口
• wiki/papers/*.md — 与问题相关的论文页面
• wiki/concepts/*.md — 与问题相关的概念页面
• wiki/claims/*.md — 与问题相关的 claim 页面
• wiki/topics/*.md — 与问题相关的 topic 页面
• wiki/people/*.md — 若问题涉及特定研究者
• wiki/ideas/*.md — 若问题涉及研究想法或 failed ideas
• wiki/experiments/*.md — 若问题涉及实验结果
• wiki/Summary/*.md — 若问题涉及领域全景

Writes（仅 crystallize 模式）

• wiki/outputs/{query-slug}.md — CREATE（查询结果页面）
• wiki/concepts/{slug}.md — CREATE（新发现概念）或 EDIT（补充已有概念）
• wiki/claims/{slug}.md — CREATE（新发现断言）或 EDIT（补充 evidence）
• wiki/graph/edges.jsonl — APPEND（crystallize 产生的关系）
• wiki/graph/context_brief.md — REBUILD（若 crystallize 创建了新页面）
• wiki/graph/open_questions.md — REBUILD（若 crystallize 创建了新页面）
• wiki/index.md — EDIT（若 crystallize 创建了新页面）
• wiki/log.md — APPEND

Graph edges created（仅 crystallize）

• output → paper: derived_from（回答引用的论文）
• output → concept: derived_from（回答引用的概念）
• output → claim: derived_from（回答引用的 claim）
• concept → paper: supports（若新概念从论文中归纳）
• claim → paper: supports（若新 claim 从论文中提取）

Workflow

前置：确认工作目录为 wiki 项目根（包含 wiki/、raw/、tools/ 的目录）。 设 WIKI_ROOT=wiki/。

Step 1: 加载全局上下文