vscode-templete/.claude/skills/auto-wiki-cn/references/query-protocol.md

98 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Query 协议
> 基于 wiki 积累回答问题。不是 RAG——不搜原始文档搜编译后的 wiki 页面。
## 流程
```
1. 理解问题
├─ 识别目标 wiki从问题内容推断或用户指定
├─ 提取关键词(实体名、概念名、时间范围)
└─ 判断问题类型(事实查询 / 比较分析 / 趋势判断 / 开放探索)
2. 搜索 wiki
├─ 读 index.md按关键词匹配页面标题和描述
├─ 读取匹配的页面(通常 3-8 个)
├─ 如果页面中有 [[wikilink]],沿链接读取关联页面(一层展开)
└─ 注意 confidence 字段contested 页面需要特别标注
3. 综合回答
├─ 基于读取的页面内容综合分析
├─ 每个关键论点标注来源页面:[[page-slug]]
├─ 如果涉及 contested 信息,明确说明:
│ "关于 XXwiki 中存在矛盾:来源 A 说...,来源 B 说..."
└─ 如果信息不足,明确说明缺口并建议 ingest 方向
4. 可选归档
├─ 如果回答中包含有价值的新分析(不是简单复述页面内容)
├─ 提示用户:"这个分析要归档到 wiki 吗?"
└─ 用户同意 → 写入 analyses/{slug}.md更新 index
```
## 回答格式
### 事实查询
```
根据 wiki 中 {N} 篇源文件的积累:
{直接回答}
来源:[[page-1]]、[[page-2]]
```
### 比较分析
```
基于 wiki 中的记录,{A} 和 {B} 的对比:
| 维度 | {A} | {B} |
|------|-----|-----|
| ... | ... | ... |
来源:[[page-1]]、[[page-2]]、[[page-3]]
注:关于 XX 维度wiki 中数据有限(仅 1 篇来源),建议补充。
```
### 信息不足
```
wiki 中关于 {主题} 的信息不足:
- 相关页面:{N} 个
- 源文件:{N} 篇
- 缺口:{具体缺什么}
建议 ingest
- {建议补充的材料类型 1}
- {建议补充的材料类型 2}
```
## 跨 Wiki 查询
当问题涉及多个 wiki 时:
1. 列出 `.wiki/` 下所有 wiki 目录
2. 读取每个可能相关的 wiki 的 index.md
3. 分别搜索
4. 综合回答时标注来源属于哪个 wiki
```
综合 enterprise-annuity wiki 和 charlie-munger wiki 的内容:
{分析}
来源:
- enterprise-annuity: [[alpha-corp]]、[[fiduciary-responsibility]]
- charlie-munger: [[circle-of-competence]]、[[margin-of-safety]]
```
## 查询性能
| Wiki 规模 | 查询策略 | 预期延迟 |
|-----------|---------|---------|
| < 30 | index + 直接读匹配页面 | < 5s |
| 30-150 | index + grep 关键词 + top 匹配 | 5-15s |
| 150-500 | index + grep + 分批读取 | 15-30s |
| > 500 页 | 超出 Skill 设计范围 | 建议迁移到平台 |