mcpField
R
Remembering Conversations

Remembering Conversations

github.com/obraAgent 工作流755516 次安装54 周前更新
代码仓库

关于 Remembering Conversations

Remembering Conversations 是一项搜索归档对话的技能,支持语义相似度检索和精确文本匹配。它适合在重复熟悉的工作前查找以往决策、模式或相关调试讨论。

主要功能

  1. 01按语义相似度搜索
  2. 02匹配精确文本
  3. 03按日期筛选结果
  4. 04限制结果数量
  5. 05返回对话及匹配详情

适用场景

  1. 01查找以往的架构决策
  2. 02回顾类似问题的讨论
  3. 03定位特定字符串或 Git SHA

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/obra/superpowers-skills --skill remembering-conversations

安装后在 Claude Code 中输入/remembering-conversations确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

INDEXING.md
DEPLOYMENT.md
tool/
.gitignore
index-conversations
package.json
migrate-to-config.sh
package-lock.json
install-hook
search-conversations
tsconfig.json
test-install-hook.sh
test-deployment.sh
tool/hooks/
sessionEnd
tool/prompts/
search-agent.md
tool/src/
db.test.ts
db.ts
index-cli.ts
embeddings.ts
parser.ts
search-agent-template.test.ts
paths.ts
indexer.ts
search.ts
search-cli.ts
types.ts
summarizer.ts
verify.ts
verify.test.ts

详细介绍

记住对话

使用语义相似度或精确文本匹配来搜索已归档的对话。

核心原则: 先搜索,再重新发明。

宣布: “我正在搜索之前关于 [主题] 的对话。”

设置: 请参阅 INDEXING.md

何时使用

以下情况应搜索:

  • 你的搭档提到“我们之前讨论过这个”
  • 调试类似问题
  • 查找架构决策或模式
  • 在实现熟悉的内容之前

以下情况不要搜索:

  • 当前对话中已有相关信息
  • 询问当前代码库(使用 Grep/Read)

会话内使用

始终使用子 Agent(节省 50 到 100 倍的上下文)。工作流请参阅 skills/using-skills。

手动/命令行使用: 对于不在 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

评论

支持 Markdown