用途
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。
- 工具的具体安装方式、依赖环境、平台支持等信息暂未提供。