mcpField
H
hindsight-local

hindsight-local

github.com/vectorize-ioAgent 工作流55.5k501 次安装今天更新
代码仓库

关于 hindsight-local

hindsight-local 是一项使用 hindsight-embed 命令行持久保存记忆的 Agent 技能。它指导 Agent 记录有用上下文，并在任务开始前检索相关信息，同时包含初次配置检查。

主要功能

  1. 01保存详细记忆
  2. 02任务前检索上下文
  3. 03通过 reflect 综合记忆
  4. 04按上下文标记记忆

适用场景

  1. 01保存项目约定与偏好
  2. 02记录任务结果和解决方法
  3. 03实施前查阅过往上下文

安装

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

$npx skills add https://github.com/vectorize-io/hindsight --skill hindsight-local

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

详细介绍

Hindsight Memory Skill（本地）

你可以通过 hindsight-embed 命令行获得持久记忆。主动存储经验并召回上下文，以提供更好的协助。

设置检查（仅首次）

在使用记忆命令之前，请确认 Hindsight 已配置：

uvx hindsight-embed daemon status

如果此命令失败或显示 "not configured"，请运行交互式设置：

uvx hindsight-embed configure

这会提示你输入大模型提供商和 API 密钥。设置完成后，下面的命令即可正常使用。

Hindsight 的工作原理

当你调用 retain 时，Hindsight 不会按原样存储字符串。服务会运行一条内部流水线，它会：

  1. 使用大模型从内容中提取结构化事实
  2. 识别实体（人物、工具、概念）并关联相关事实
  3. 构建事实之间的时间与因果关系
  4. 生成嵌入以支持语义搜索

这意味着你应当传入丰富、完整的上下文内容——服务比预先总结的字符串更擅长提取关键信息。你的职责是决定何时存储，而不是提取什么。

命令

存储一条记忆

使用 memory retain 存储你学到的内容。传入完整上下文——原始观察、会话笔记、对话摘录或详细描述：

uvx hindsight-embed memory retain default "User is working on a TypeScript project. They enabled strict mode and prefer explicit type annotations over inference."
uvx hindsight-embed memory retain default "Ran the test suite with NODE_ENV=test. Tests pass. Without NODE_ENV=test, the suite fails with a missing config error." --context procedures
uvx hindsight-embed memory retain default "Build failed on Node 18 with error 'ERR_UNSUPPORTED_ESM_URL_SCHEME'. Switched to Node 20 and build succeeded." --context learnings

你也可以传入带时间戳的原始对话记录：

uvx hindsight-embed memory retain default "[2026-03-16T10:12:03] User: The auth tests keep failing on CI but pass locally. Any idea?
[2026-03-16T10:12:45] Assistant: Let me check the CI logs. Looks like the tests are running without the TEST_DATABASE_URL env var set — they fall back to the production DB URL and hit a connection timeout.
[2026-03-16T10:13:20] User: Ah right, I never added that to the CI secrets. Adding it now.
[2026-03-16T10:15:02] User: That fixed it. All green now." --context learnings
召回记忆

在开始任务之前使用 memory recall 获取相关上下文：

uvx hindsight-embed memory recall default "user preferences for this project"
uvx hindsight-embed memory recall default "what issues have we encountered before"
反思记忆

使用 memory reflect 综合上下文：

uvx hindsight-embed memory reflect default "How should I approach this task based on past experience?"

重要：何时存储记忆

在你学到有价值的内容之后务必存储：

用户偏好
  • 编码风格（缩进、命名约定、语言偏好）
  • 工具偏好（编辑器、linter、格式化工具）
  • 沟通偏好
  • 项目约定
流程结果
  • 成功完成任务的步骤
  • 有效（或失败）的命令及其原因
  • 发现的变通方法
  • 解决问题的配置
任务中的经验
  • 遇到的 bug 及其解决方案
  • 有效的性能优化
  • 架构决策及其理由
  • 依赖项或版本要求

重要：何时召回记忆

在以下情况之前务必召回：

  • 开始任何非平凡任务
  • 做出实现相关的决策
  • 推荐工具、库或方法
  • 在项目的新领域编写代码

最佳实践

  1. 立即存储：当你发现某些内容时，立刻存储
  2. 传入丰富上下文：包含完整观察，而不是预先总结的字符串——服务会自动提取事实
  3. 包含结果：存储发生了什么以及为什么，包括失败和变通方法
  4. 先召回：在开始工作之前始终检查相关上下文
  5. 使用 --context 作为元数据：--context 标志用于标记记忆类型（例如 procedures、learnings、preferences），而不是替代完整内容

评论

支持 Markdown