SuperAPI AI 工具集

remembering conversations

写作与研究

查看项目

更新于 10-15 10:22

技能介绍

用途

Remembering Conversations 用于搜索已归档的 Claude Code 对话记录,从中查找事实、模式、决策与上下文。它支持语义相似度搜索和精确文本匹配两种方式。

其核心原则是:先搜索,再重造(Search before reinventing)。

使用时会先声明:「I'm searching previous conversations for [topic].」

安装与索引设置参见 INDEXING.md。

何时使用

适合搜索的场景:

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

不适合搜索的场景:

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

会话内使用

在 Claude Code 会话内使用时,始终通过子代理(subagents)调用,可节省 50-100 倍上下文。工作流参见 skills/using-skills。

直接搜索(手动/CLI)

供 Claude Code 会话之外的人工使用。

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

模式:

search-conversations "query"              # Vector similarity (default)
search-conversations --text "exact"       # Exact string match
search-conversations --both "query"       # Both modes

参数标志:

--after YYYY-MM-DD    # Filter by date
--before YYYY-MM-DD   # Filter by date
--limit N             # Max results (default: 10)
--help                # Full usage

示例:

# Semantic search
search-conversations "React Router authentication errors"

# Find git SHA
search-conversations --text "a1b2c3d4"

# Time range
search-conversations --after 2025-09-01 "refactoring"

返回内容:项目、日期、对话摘要、匹配的交流片段、相似度百分比、文件路径。

更多细节:运行 search-conversations --help。

适用场景

  • 回顾此前关于架构决策或设计模式的讨论
  • 调试与历史对话中类似的问题
  • 在实现熟悉功能前检索既有上下文
  • 通过精确文本匹配查找 git SHA 等具体字符串
  • 按日期范围筛选特定时间段内的对话

限制

  • 当前对话中已有的信息、以及关于当前代码库的问题,不应使用本工具,而应使用 Grep/Read。
  • 在 Claude Code 会话内使用时需通过子代理调用,否则上下文开销较大。
  • 关于收费、价格、支持平台等具体信息,资料中暂未提供。