query-routing
Created: 2026-07-02 Updated: 2026-07-05
查询路由表
这页只负责回答一个问题：不同类型的问题，应该先读哪里，后读哪里，别一上来就把整个 wiki 和 raw 扔进上下文，太蠢也太贵。
维护属性：本页是知识库内部查询路由，不是外部事实 synthesis。
source_count: 0是有意设计；它的依据是当前 wiki 目录结构、generated coverage 和维护流程，而不是 raw 文献证据。
路由表
| 问题类型 | 先读什么 | 再读什么 | 不要先读什么 |
|---|---|---|---|
| 某工具 / 产品怎么用 | [[wiki/index]] 中 Agent 编程主线 的 entities 页；具体工具优先读 [[wiki/entities/Claude Code]]、[[wiki/entities/Codex 与 Claude Code 集成]]、[[wiki/entities/OpenClaw 与多 Agent 编排]] | [[wiki/entities/_context]]，再跳到相关 concepts 页，例如 [[wiki/concepts/Skills、Agents 与工具设计]]、[[wiki/concepts/上下文管理与 Harness Engineering]] | 不要先扫 raw 全库；不要先读 [[wiki/overview]] 里的仓库规则 |
| 某概念是什么 | [[wiki/index]] 的 concepts 区；进目录前读 [[wiki/concepts/_context]] | 读具体概念页顶部 TL;DR 和证据地图，再下钻正文 | 不要先读 syntheses；综合页适合比较，不适合定义概念 |
| 趋势、对比、矛盾 | [[wiki/syntheses/_context]] 和 [[wiki/syntheses/矛盾与视角差异]] | 回跳到参与比较的 concepts / entities 页 | 不要只读单一工具页，否则会把局部路线误当行业趋势 |
| raw 里有什么新东西 | [[wiki/hot]] 的最新动态和规模快照 | [[wiki/references/raw-catalog.generated]] 查完整 raw 清单；必要时再看 [[wiki/references/raw-主题索引]] 的人工主题落点 | 不要手动翻 raw 目录；目录太大，肉眼扫纯属折磨 |
| 某主题是否已被 wiki 覆盖 | [[wiki/references/raw-coverage.generated]] | 在 coverage 中找到对应 raw 后，看 wiki 引用页；再读对应 wiki 页 | 不要只看 [[wiki/references/raw-主题索引]]，它是主题解释入口，不是覆盖事实源 |
| 要做 ingest | 先读 [[wiki/hot]]、[[wiki/index]]、[[wiki/hints]] | 按主题进对应 _context.md，再决定更新哪个已有页；完成后跑 python3 scripts/generate-raw-index.py 和 python3 scripts/wiki-health.py | 不要直接新建孤立页；不要修改 raw 原文 |
| 要做 promote | 先读 [[wiki/overview]] 的晋升循环和 [[wiki/hints]] 的页面标准 | 读目标目录 _context.md，选择 concepts / entities / syntheses / references | 不要把 outputs 原文直接覆盖进 wiki 正文 |
| 要做 lint / 健康检查 | 运行 python3 scripts/wiki-health.py | 再运行 bash scripts/raw-integrity.sh status 查看 raw checksums 状态 | 不要先刷新 raw/.checksums；刷新是高风险维护动作 |
| 要写输出报告 | 先读 [[wiki/index]] 定位相关页 | 再读具体页证据地图和 raw 来源；报告放 outputs/reports/ | 不要把报告直接晋升为 wiki，除非后续走 promote |
快速判断
- 问“是什么”：
index -> _context -> 具体页 TL;DR - 问“有什么新 raw”：
hot -> raw-catalog.generated - 问“覆盖了吗”：
raw-coverage.generated -> wiki 引用页 - 问“怎么维护”：
overview -> hints -> wiki-health.py - 问“哪里有矛盾”：
syntheses/_context -> 矛盾与视角差异
维护规则
- 新增 generated 索引时，必须同步这页和 [[wiki/references/_context]]。
- 新增高频工作流时，优先在这页加一行路由，不要把长流程塞进 [[wiki/index]]。
- 如果某类问题需要读超过 3 个入口才能定位，说明路由表该更新了。