📦 Miremo Research Skill — Miremo Research 技能

Miremo Skill 前置条件：必须先于 OpenClaw 中连接 Miremo MCP server，才能使用本技能的工具。详见 README 中的设置说明。 Miremo 是一款 AI 笔记工具，存储用户的 memos、documents、supertags（带富内容的主题标签）以及 AI 提取的知识图谱实体。所有工具仅访问当前已认证用户自己的数据。

研究策略 当用户询问其知识时，先选择以下三种研究模式之一，并完整执行后再给出最终答案；一次搜索失败不得放弃。

模式 A — 浏览（用户想要概览） 触发语："what notes do I have"、"show me my recent notes"、"what have I been writing about"、"give me an overview" 步骤：

• list_memos(page_size=30) 抽样近期 memos
• list_supertags() 一览所有主题标签
• 综合两者生成结构化概览

模式 B — 主题研究（最常用） 触发语："what do I know about X"、"find notes about X"、"anything related to X"、"my thoughts on X" 步骤：

• global_search(query="X") 跨类型概览（memos + docs + supertags）
• search_memos(query="X", search_type="semantic") 深度语义匹配
• 若出现相关 supertag：list_supertags(q="X") 通过该标签扩展
• 对关键人物、概念或事件：list_entities() → get_entity_graph(entity_id) 探索关系

迭代规则（关键）：

• 若初始结果稀少，用同义词、英文等价词或拆分关键词再试，方可得出"未找到"
• 第二次尝试将 similarity_threshold 降至 0.25–0.35
• hit_text 仅为片段，勿仅凭其下结论；用 global_search 确认全类型范围
• 仅当 2–3 种不同搜索策略均返回空时，方可声明"无相关笔记"

模式 C — 精确查找 触发语："do I have a note about X"、"find the exact note where I wrote Y"、"the note titled Z" 步骤：

• search_memos(query="Y", search_type="full_text") 精确短语匹配
• 若未命中，退回模式 B 进行语义搜索

可用工具 搜索工具 search_memos — 按关键词或自然语言搜索 memos 参数：query（搜索文本）、limit（最大结果，默认 10，建议 ≤20）、search_type（"hybrid" | "semantic" | "full_text"） 返回：id、hit_text、similarity_score、created_at、modified_at

global_search — 跨 memos、documents、supertags 搜索 参数：query、limit（每类型默认 10）、include_memos / include_documents / include_supertags 返回：类型、id、title、description、score

列表工具 list_memos — 分页列出 memos 参数：page_index、page_size（默认 20）、q（模糊过滤） 返回：items、total、page_size、page_index

list_supertags — 列出主题 supertags 参数：q（过滤）、page_index、page_size（默认 50，通常一次取完）

list_documents — 列出上传文档（PDF 等） 参数：q（名称过滤）、page_index、page_size（默认 20） 返回：document_id、name、created_at、modified_at、status

创建工具 create_memo — 新建 memo 参数：content（正文，首行为标题） 返回：{ memo_id: "<新 UUID>" } 创建后，后台自动执行向量化和知识图谱更新

知识图谱工具 list_entities — 列出 AI 提取的实体 参数：entity_type（可选）、page_index、page_size（默认 20）

get_entity_graph — 获取实体 1 跳关系图 参数：entity_id（需先通过 list_entities 获取） 返回：entity、related_entities、relationships

何时用何工具 用户意图 → 推荐工具 "Find notes about X" → 先用 global_search，再用 search_memos 细化 "Find notes with exact phrase" → search_memos，search_type="full_text" "What do I know about X"（语义） → search_memos，search_type="semantic" "Show me recent memos" → list_memos "What topics do I write about" → list_supertags "Find a document / PDF" → list_documents，加 q 过滤 "Save / record / note down X" → create_memo "Explore my knowledge graph" → list_entities → get_entity_graph

推荐工作流 回答 "What do I know about X"：

• global_search(query="X") 跨类型概览
• 需更细节：search_memos(query="X", search_type="semantic")
• 若存在相关 supertag：list_supertags(q="X") 进一步扩展

帮用户记录新信息： 确认意图 → 调用 create_memo(content="...") → 告知用户笔记已创建