wiki-query

Wiki 查询

提出问题。阅读 Wiki。综合信息并附上引用。主动询问是否要将答案存回 Wiki。

前置条件

查找 SCHEMA.md（从当前工作目录向上搜索，或在 ~/wikis/ 中搜索）。如果找不到，请告知用户先运行 wiki-init。阅读该文件，获取 Wiki 根目录路径和交叉引用规范。

链接样式。 从 SCHEMA.md 中读取 link_style:。如果缺少此字段，或 <wiki-root>/config/link-style.md 不存在，则默认使用 obsidian（[[slug]]）。否则，阅读 <wiki-root>/config/link-style.md，了解生成和解析规则。按照 ## Parse 规则跟进页面中的交叉引用。将答案写回 Wiki 页面时（步骤 4），按照 ## Emit 规则生成引用和交叉引用。

流程

1. 首先阅读 wiki/index.md

重新生成索引，使其反映当前页面 — python bin/generate-index.py — 然后浏览完整索引，确定哪些页面可能与问题相关。不要依据 一般知识作答 — Wiki 是此处的事实来源，即使你认为自己知道答案也一样。

2. 阅读相关页面

完整阅读已识别的页面。按照 config/link-style.md 中的 ## Parse 规则匹配交叉引用链接，并跟进一层相关链接（如果其指向的页面似乎与问题相关）。

3. 综合答案

撰写的回复应：

• 以你阅读的 Wiki 页面为依据
• 对每项来源于特定页面的说法，使用 Wiki 的 link_style 以内联交叉引用标注出处
• 指出页面之间的一致和分歧之处
• 标出信息缺口：“Wiki 中没有关于 X 的页面”或“ 尚未涵盖 Y”
• 建议后续可导入的来源或值得调查的问题

根据问题类型采用以下格式：

• 事实类 → 附引用的正文
• 比较类 → 表格
• 原理类 → 编号步骤
• 关于 X 已知什么 → 包含待解问题的结构化摘要

4. 始终询问是否保存

回答后，询问：

“值得保存为 wiki/pages/<suggested-slug>.md 吗？”

如果用户同意：

• 使用完整 frontmatter 编写页面：title、category: Analyses（或 Wiki 中对应的类别）、summary（单行）、tags: [query, analysis]、sources: [all cited slugs]、created: <today>、updated: <today>
• 重新生成索引 — python bin/generate-index.py — 不要手动编辑 index.md
• 按照 SCHEMA 的操作日志与提交规范记录操作：
  • **Git Wiki：**建议提交（保存查询的默认提交信息为 docs:，并附上 trailer）；经确认后提交。

    docs: add analysis — <question summary>
    
    Wiki-Op: query
    

  • **非 Git Wiki：**在 wiki/log.md 末尾追加：

    ## [<today>] query | <question summary>
    Filed as: <slug reference to the new slug, in the wiki's link_style>
    

如果用户不同意：

• **Git Wiki：**没有更改，因此无需提交 — 不记录此次查询。
• **非 Git Wiki：**在 wiki/log.md 末尾追加：

  ## [<today>] query | <question summary>
  Not filed.
  

常见错误

• 凭记忆作答 — 始终阅读 Wiki 页面。Wiki 可能与您认为自己知道的内容相矛盾，而这种矛盾是有价值的信号。
• 跳过保存询问 — 优质的查询答案能不断提升 Wiki 的价值。始终主动询问。
• 没有引用 — 每项事实性说法都应能追溯到一个 slug 引用（使用 Wiki 的 link_style）。