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

98 lines
2.7 KiB
Markdown
Raw Normal View History

# 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 设计范围 | 建议迁移到平台 |