🚀 一键安装： openclaw skill install dabin0927/query-rewrite

⛔ 禁止行为

以下操作绝对禁止：

• ❌ 修改原始 Query 的用户意图
• ❌ 在不需要改写时强行改写（零改写原则）
• ❌ 无上文时凭空补充实体

Query Rewrite — RAG 检索前置改写层 v1.0.0

定位： 在多轮对话场景中，将模糊/指代/多意图的 Query 改写为结构化检索词，提升 RAG 召回率。

核心职责：

• ✅ 快速检测 Query 是否需要改写
• ✅ 6 种模式自动识别并执行改写
• ✅ 原文 + 改写结果双路检索
• ✅ 结果去重合并

🆕 What's New in v1.0.1

• Quick Reference — Situation → Action 速查表
• Table of Contents — 链接式目录导航
• 对标 ClawHub — 结构升级，内容完整保留

📑 Contents

Quick Reference

🧠 改写检查清单

在调用任一检索工具（memory_search、wiki_search）或配合 raglite SKILL 进行向量检索前，按以下清单逐项检查当前 Query：

📋 6 种改写模式速查

详细模板和更多示例见 references/rewrite-patterns.md

多模式叠加优先级

当 Query 同时触发多种模式时，按以下顺序执行：

反问识别(5) → 指代消解(3) → 多意图拆解(4) → 上下文提取(1) → 对比消歧(2) → 条件提取(6)

🔄 执行流程

用户 Query
    │
    ▼
┌─────────────────┐
│ 检查改写检查清单  │ ← 逐项比对，0.5s 内完成判断
└───────┬─────────┘
        │
   ┌────┴────┐
   │ 需要改写？│
   └────┬────┘
        │
   ┌────┴────────────────┐
   │ YES                 │ NO
   ▼                     ▼
┌──────────┐      ┌──────────┐
│ 执行改写  │      │ 直接检索  │
│ 输出 1-N  │      │ 原 Query  │
│ 个 Query  │      └──────────┘
└────┬─────┘
     │
     ▼
┌────────────────────────────┐
│ 原文 + 改写结果全部检索     │
│ memory_search(原Query)     │
│ memory_search(改写1)       │
│ memory_search(改写2) ...   │
└────────────┬───────────────┘
             │
             ▼
┌────────────────────────────┐
│ 合并去重（按 score 降序）   │
│ 每条结果标注 query_source：  │
│ "original" / "rewrite_1"... │
│ 标注每条结果的 query_source │
└────────────────────────────┘

⚠️ 重要规则

1. 零改写原则 — 不需要改写时直接检索，不增加任何额外步骤
2. 意图保真 — 改写不改变用户原意，只补充上下文信息
3. 上文范围 — 默认提取最近 2-3 轮对话的实体
4. 改写不替代检索 — 改写是检索的增强，不是替代；原 Query 始终参与检索
5. 失败回退 — 无法确定指代/意图时，用原 Query 检索，标注 rewrite_skipped: true

📝 使用示例

示例 1：正常改写流程

上文：用户问"iPhone 15 Pro 有什么颜色"
当前 Query："保修多久？"
↓ 检查清单：语义不完整 → 模式1
↓ 改写：提取上文实体 "iPhone 15 Pro" → "iPhone 15 Pro 保修期限"
↓ 检索：memory_search("保修多久？") + memory_search("iPhone 15 Pro 保修期限")
↓ 合并去重返回

示例 2：多意图拆解

上文：（无）
当前 Query："涂布机价格？保修期？能不能定制？"
↓ 检查清单：多问句 → 模式4
↓ 改写：
  - "涂布机价格"
  - "涂布机保修期"
  - "涂布机定制支持"
↓ 检索：4 次（1 原文 + 3 改写）→ 合并去重

示例 3：无需改写

上文：（无）
当前 Query："赢合科技 CRM 系统架构设计文档"
↓ 检查清单：全否 → 直接检索
↓ memory_search("赢合科技 CRM 系统架构设计文档")

📎 参考资源

• 改写模式详解：references/rewrite-patterns.md（6 种模式触发条件 + 每模式 2-3 个示例）
• raglite 集成：配合 raglite SKILL 的增强检索管线使用

📝 变更记录