wps-deep-search - Agent Skills

name	wps-deep-search
description	【深度搜索】面向复杂问题的启发式检索助手。默认执行“笔记证据 + 网络权威信源”的混合检索，不止笔记内关键词搜索。当用户说“深度搜索”“帮我深挖”“关联查询”“全面梳理”“帮我核实一下”时使用。本版本为单代理串行执行，禁用 sub_agent。
metadata	[object Object]

Contract（契约）

Input Contract

类型: 自然语言查询或结构化搜索请求
必填字段:
- query: 用户问题或目标
可选字段:
- context: 对话上下文
- filters: 时间范围、标签、项目范围、来源偏好等
- max_results: 默认 10，范围 1-20
- search_depth: quick | standard | deep（默认 standard）
- source_mode: notes_only | web_only | hybrid（默认 hybrid）
验证规则:
- query 长度 >= 2
- 问题包含“最新/今日/近期”等时，必须启用网络时效检查

Output Contract

类型: 结构化检索结果 + 可读结论
保证字段:
- results: 结果列表（按综合相关性排序）
- search_dimensions: 实际执行的检索维度
- evidence: 证据清单（笔记证据 + 外部证据）
- confidence: 每条关键结论的置信度（High/Medium/Low 或 0-100）
- conflicts: 冲突信息或未决点
约束:
- 结论必须可追溯到证据来源
- 区分“已证实”和“待验证”
- 明确哪些结论来自笔记，哪些来自外部网络

Error Handling

无效查询 → 返回优化建议，不直接失败
无匹配结果 → 自动放宽一次约束重试，仍无结果则返回“证据不足”
工具失败 → 返回可用部分结果 + 未完成项
权威来源不足 → 降级输出，不给确定性结论

核心原则

深度搜索不是单轮关键词匹配，而是“启发式漏斗 + 证据收敛”。
除非用户明确要求“只查笔记”，默认使用 hybrid（笔记 + 网络权威源）。
外部来源必须可追溯，web_search 摘要只能作线索，web_fetch 正文才可作证据。
严禁编造来源、编造引用、把低权威单一来源当成定论。
本版本强制单代理串行执行，禁止调用 sub_agent。
该 Skill 为只读检索流程，不调用笔记写入类工具。

与 wps-note 的关系

本 Skill 是 wps-note 的深度检索场景封装层：

复用底层能力：搜索、定位、读取、标签聚合
新增智能能力：启发式扩展、证据融合、置信度评估
新增外部能力：网络权威信源检索与交叉验证

工具列表与调用方式

笔记侧工具（只读）

工具名	用途
`search_notes`	笔记级召回（标题/正文/标签维度）
`search_note_content`	单篇笔记内定位关键段落
`get_note_info`	获取元数据（标题、标签、更新时间）
`find_tags`	标签扩展与近义聚合
`get_note_outline`	获取结构并定位读取入口
`read_section`	章节级精读
`read_blocks`	精确回读证据块
`read_note` / `read_note_content`	全文读取（宿主工具名兼容）

网络侧工具（只读）

工具名	用途
`web_search`	单查询检索权威候选
`batch_web_search`	多查询并行召回（推荐）
`web_fetch`	抓取正文，形成可引用证据

禁用工具

sub_agent（本 Skill 禁止使用）

权威信源分级（必须执行）

级别	定义	结论作用
Tier 1（一级官方）	政府/监管/标准组织/公司官方披露/原始机构发布	结论主锚点
Tier 2（二级主流）	主流媒体、头部研究机构、可追溯作者和发布时间来源	交叉验证
Tier 3（三级补充）	社区、自媒体、二次转载、观点文	线索与背景，不单独定论

规则：

关键结论优先 Tier 1；无 Tier 1 时至少要有 2 条独立 Tier 2。
仅 Tier 3 时只能输出“探索性判断/证据不足”。

启发式检索漏斗（Heuristic Funnel）

第一层：意图澄清（Intent Clarification）

目标：把用户问题转成可检索任务。

识别任务类型：事实核查/关联挖掘/趋势判断/决策建议
提取结构化要素：实体、时间窗、约束、输出目标
设定 source_mode：notes_only | web_only | hybrid
对明显歧义最多澄清一次；否则基于保守假设继续并声明假设

第二层：候选扩展（Candidate Expansion）

目标：先充分召回，再高质量收敛。

同义词扩展：别称、缩写/全称、中英术语
反向词扩展：正负信号并查，降低单边偏差
时间锚点扩展：相对时间转绝对时间，并加对照窗口
实体关系扩展：上下游、竞品、监管、合作方、负责人
语境扩展：优先使用用户笔记里的项目名/内部术语

第三层：证据收敛（Evidence Convergence）

目标：让每条结论都可审计。

抽取证据单元：主张、证据片段、来源、时间、适用范围
独立交叉验证：关键主张需多源印证
冲突保留：标注争议点，不强行合并
输出置信度：高/中/低，并解释原因

Workflow（工作流程，串行）

步骤 0：模式选择

用户明确“只看笔记” → notes_only
用户强调“最新/外部动态/权威口径” → hybrid（或 web_only）
未明确时默认 hybrid

步骤 1：拆解问题为 claim

将问题拆成可验证断言（claim），每条 claim 至少包含：

subject
predicate
time_scope

步骤 2：规划检索与预算

每条 claim 默认 2 轮网络检索
每条 claim 默认最多抓取 6 个页面
提前停止条件：
- 已有 1 条 Tier 1 + 1 条独立 Tier 2
- 或已有 2 条独立 Tier 2 且一致

步骤 3：笔记侧检索（串行）

search_notes / find_tags 召回候选笔记
search_note_content 定位关键段落
read_section / read_blocks 抽取证据

步骤 4：网络侧检索（串行）

batch_web_search 执行多 query 扩展召回
web_fetch 抓取正文并过滤掉仅摘要结果
按 Tier 1 → Tier 2 → Tier 3 顺序保留候选

步骤 5：证据融合与评分

建议综合分（0-100）：

意图匹配度（30）
证据强度（25）
来源权威度（20）
时效匹配度（15）
跨源一致性（10）

置信度建议：

High：>= 80 且满足权威来源条件
Medium：60-79
Low：< 60 或存在重大冲突

步骤 6：结果呈现（来源透明）

必须包含：

查询主题与检索时间
结论摘要
claim 级判定（supported / partially_supported / conflicting / insufficient_evidence）
笔记证据（note_id / 位置 / 摘要）
外部证据（Tier、来源名、URL、发布时间、抓取时间、证据作用）
冲突与未决问题

常用编排模式

模式 1：事实核查（默认混合）

适用于“这件事是真的吗/最新口径是什么”：

claim 拆解 → 笔记检索 → 网络检索 → 证据收敛 → 置信度输出

模式 2：跨笔记关联 + 外部验证

适用于“这个主题和我过去笔记有什么关联，外部又怎么说”：

笔记召回 → 主题扩展 → 网络权威检索 → 一致性分析

模式 3：趋势研判

适用于“最近走势/风险变化”：

时间锚点扩展 → 多时间窗检索 → 证据对比 → 趋势结论

示例

示例 1：事实核查

输入：深度搜索：某 AI 公司最近是否发布了新的企业定价政策？

执行要点：

claim 拆解：是否发布 / 发布时间 / 涉及范围
串行执行官方信源 + 主流媒体检索
回查用户笔记里的历史定价讨论
输出 claim 级证据、置信度与冲突点

示例 2：关联挖掘

输入：深度搜索：把“模型成本压降”相关的内部笔记和外部权威资料一起梳理