历史搜索工具

一个用于项目范围内对话历史搜索的便携式代理技能,可查询测试命令、实现理由、先前修复和功能上下文等信息。

  • by ScriptedAlchemy
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ScriptedAlchemy/reverie-mcp

使用说明

代理历史搜索技能(TypeScript)

可移植代理技能,用于跨CLI代理进行项目范围的对话历史搜索。

它做什么

  • 根据历史证据回答项目记忆问题:
    • 以前使用的测试命令
    • 实施原理
    • 先前的修复和功能上下文
  • 在可用的情况下使用代理CLI/协议:
    • Claude CLI(claude)
    • Codex CLI(codex exec --json)
    • 光标CLI(agent 默认情况下;通过以下方式覆盖 CURSOR_CLI_COMMAND / CURSOR_CLI_COMMANDS)
  • 返回带有引用、置信度和提供者诊断的结构化输出。

构建/捆绑(rslib)

对于正常的技能使用,不需要本地构建。此仓库在技能目录中提供预构建的工件。

如果您正在开发技能并需要重新生成工件:

npm install
npm run build

捆绑输出被写入 skills/agentic-history-search/dist/ 包括:

  • history-search.js + history-search.mjs (ESM)

跑

查询过去(首选启动器)

bash skills/agentic-history-search/scripts/run-history-search.sh --mode query_past --query "what are the test commands?"

最近的会话(首选启动器)

bash skills/agentic-history-search/scripts/run-history-search.sh --mode recent_sessions --limit 10

启动器行为:

  • 需要捆绑的CLI: skills/agentic-history-search/dist/history-search.mjs
  • 使用此存储库签出时,消费者不需要构建。

验证

bash scripts/validate-skill.sh

将技能安装到本地代理技能目录中

bash scripts/install-skill.sh all symlink

安装程序需要此存储库中附带的预构建包。 为了兼容Codex,安装程序会同时写入以下内容:

  • ~/.agents/skills
  • ~/.codex/skills

论据:

  • 目标: codex|claude|cursor|all
  • 安装模式: symlink|copy
  • 模拟运行(可选第三个参数): true|false

测试

npm test

测试套件与 Rstest (rstest run)在与Rslib相同的Rstack生态系统中 @rstest/adapter-rslib 继承相关的Rslib配置。