SuperAPI AI 工具集

session-search

编程与开发

查看项目

更新于 10-16 07:57

技能介绍

该技能用于在无子代理支持的命令行代理环境中,搜索并查找既往代码代理会话(Claude-Code 或 Codex-CLI),以定位特定工作、决策或代码模式。若使用 Claude Code,不应直接使用本技能,而应通过 Task 工具改用 session-searcher 子代理,以免污染上下文。

主要流程:先理解查询意图,识别用户要找的是代码模式、决策、具体工作还是设计方向;再用 aichat search --json -n 10 "[query]" 搜索,可用 -g "project" 按项目过滤;随后用 jq 从 JSONL 输出中提取 session_id、project、created、snippet、file_path 等字段;如需深入,读取 ~/.claude/projects/*/[session-id].jsonl 会话文件,每次最多 3 个;最后返回重点摘要与引用。运行 aichat search --help 可查看全部选项(日期、分支过滤等)及 JSONL 字段名。

输出要求:返回简洁摘要,包含关键发现(2-3 条要点)、相关会话的 ID 与日期、直接相关的代码片段或引用,并以 markdown 呈现,而非原始 JSON。

约束:必须始终对 aichat search 使用 --json 标志(否则会启动交互式界面);绝不向用户返回原始 JSON,需归纳提炼;每次查询最多读取 3 个会话文件;无结果时建议其他搜索词;只报告文件中直接观察到的信息,不得推断或外推。

错误处理:若 aichat search 失败或未找到,提示用户安装:uv tool install claude-code-tools 或 cargo install aichat-search。前置条件:Node.js 18+(用于操作菜单)、Rust/Cargo(用于 aichat-search);缺少 uv 或 cargo 时可安装:curl -LsSf https://astral.sh/uv/install.sh | sh 或 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh。