mcpField
S
session-search

session-search

github.com/pchalasaniAgent 工作流2.0k42 次安装1 天前更新
代码仓库

关于 session-search

session-search 是一项按工作内容、决策或代码模式查找 Claude-Code 或 Codex-CLI 历史会话的技能。它使用 aichat 搜索并汇总相关发现及会话引用，也可进一步检查最多三个会话文件。

主要功能

  1. 01使用 aichat 搜索会话
  2. 02按项目筛选结果
  3. 03检查最多三个会话文件
  4. 04汇总发现和会话引用

适用场景

  1. 01查找过去讨论设计决策的记录
  2. 02定位先前处理特定代码模式的工作
  3. 03获取先前任务的会话引用

安装

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

$npx skills add https://github.com/pchalasani/claude-code-tools --skill session-search

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

详细介绍

如果你使用的是 Claude Code： 请勿直接使用此技能。请改用 Task 工具调用 session-searcher 子 Agent——它处理起来更高效，也不会污染你的上下文。

session-search

搜索并查找以往的代码 Agent 会话（Claude-Code 或 Codex-CLI），以定位特定的工作、决策或代码模式。

工作流

  1. 理解查询：确定用户要查找的内容（代码模式、 决策、具体工作、设计方向）
  2. 使用 aichat 搜索：运行 aichat search --json -n 10 "[query]"（使用 -g "project" 按项目筛选）
  3. 解析结果：使用 jq 从 JSONL 输出中提取字段（session_id、 project、created、snippet、file_path）
  4. 必要时深入查阅：读取位于 ~/.claude/projects/*/[session-id].jsonl 的会话文件（最多 3 个文件）
  5. 总结：返回重点摘要，并附上关键发现和参考信息

运行 aichat search --help 查看所有选项（日期筛选、分支筛选等） 以及 JSONL 字段名称。

输出格式

返回简明摘要，包含：

  1. 关键发现：用 2-3 个项目符号回答查询
  2. 相关会话：供参考的会话 ID 和日期
  3. 具体内容：直接相关的代码片段或引文

请使用整洁的 Markdown 格式，不要输出原始 JSON。

示例

查询：“查找讨论过身份验证设计的会话”

aichat search --json -n 10 "authentication design"

摘要：

  • 会话 abc123（12 月 10 日）：讨论了 JWT 与基于会话的身份验证，最终决定采用 JWT
  • 会话 def456（12 月 8 日）：实现了刷新令牌轮换模式

限制

  • 始终在 aichat search 中使用 --json 标志（否则会启动交互式 UI）
  • 切勿向用户返回原始 JSON 输出——应总结并提炼发现
  • 每次查询最多读取 3 个会话文件
  • 如果没有找到结果，建议使用其他搜索词
  • 只报告在文件中直接观察到的信息——切勿推断或外推

错误处理

如果 aichat search 命令失败或未找到，请让用户安装：

uv tool install claude-code-tools   # Python package
cargo install aichat-search         # Rust search TUI

前置条件：

  • Node.js 18+（用于操作菜单）
  • Rust/Cargo（用于 aichat-search）

如果用户没有 uv 或 cargo：

curl -LsSf https://astral.sh/uv/install.sh | sh           # uv
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh  # Rust

评论

支持 Markdown