SuperAPI AI 工具集

Remembering Conversations

办公与效率

查看项目

更新于 10-15 14:13

技能介绍

用途

Remembering Conversations 用于搜索已归档的 Claude Code 对话记录,帮助找回之前讨论过的事实、模式、决策和上下文。其核心原则是“先搜索,再重造”(Search before reinventing)。

主要能力

  • 支持两种搜索模式:语义相似度搜索(向量搜索,默认)和精确文本匹配。
  • 可通过 --both 同时使用两种模式。
  • 支持按日期范围过滤(--after、--before)和限制结果数量(--limit,默认 10)。
  • 返回结果包含:项目、日期、对话摘要、匹配的交流片段、相似度百分比、文件路径。

使用方式

何时使用

在以下情况搜索:

  • 人类伙伴提到“我们之前讨论过这个”
  • 调试类似问题
  • 查找架构决策或模式
  • 在实现熟悉的功能之前

在以下情况不要搜索:

  • 信息在当前对话中
  • 问题是关于当前代码库(应使用 Grep/Read)

会话内使用

始终使用子代理(可节省 50-100 倍上下文)。工作流参见 skills/using-skills。

手动/CLI 使用

供 Claude Code 会话之外的人类直接搜索。

工具路径:${SUPERPOWERS_SKILLS_ROOT}/skills/collaboration/remembering-conversations/tool/search-conversations

模式:

search-conversations "query"              # 向量相似度(默认)
search-conversations --text "exact"       # 精确字符串匹配
search-conversations --both "query"       # 两种模式同时使用

标志:

--after YYYY-MM-DD    # 按日期过滤
--before YYYY-MM-DD   # 按日期过滤
--limit N             # 最大结果数(默认:10)
--help                # 完整用法

示例:

# 语义搜索
search-conversations "React Router authentication errors"

# 查找 git SHA
search-conversations --text "a1b2c3d4"

# 时间范围
search-conversations --after 2025-09-01 "refactoring"

适用场景

  • 找回之前对话中讨论过的技术决策或架构模式。
  • 调试与历史对话中类似的问题。
  • 在实现熟悉功能前检索相关上下文。
  • 通过精确文本匹配查找特定标识符(如 git SHA)。

限制

  • 设置说明参见 INDEXING.md(具体内容暂未提供)。
  • 会话内使用需依赖子代理工作流,相关细节参见 skills/using-skills。
  • 工具的具体安装方式、依赖环境、平台支持等信息暂未提供。