静默自动记忆,跨会话永不遗忘

Git-Based Knowledge Graph Memory System for Claude Code

收藏 13.3k
下载 4.5k
版本 1.0.0

基于 Git Notes 的静默知识图谱记忆系统,自动持久化会话上下文、决策与偏好,无需用户干预,实现跨会话的智能连续性。

基本信息

  • 技能名称?Git-Based Knowledge Graph Memory System for Claude Code
  • 中文名称?静默自动记忆,跨会话永不遗忘
  • 作者?mourad-ghafiri
  • 分类?专业技能
  • 版本?1.0.0
  • 标签?memory-system, git-notes, context-persistence, knowledge-graph, session-continuity, claude-integration, branch-aware, silent-operation

使用方法

使用说明
核心用法
GitNotesMemory 是一个面向 Claude 的 静默自动记忆系统 ,利用 Git Notes 实现分支感知的持久化存储。其核心设计哲学是 "JUST DO IT" —— 完全在后台运行,绝不询问用户、绝不-announce 操作、绝不展示命令输出。
典型工作流

  1. 会话启动 :自动执行 sync --start 加载当前分支的上下文概览(关键记忆、高频主题、记忆总数)
  2. 会话中静默记录 :通过 remember 自动捕获用户决策( -i h )、偏好( -i c/h )、学习任务等,支持标签分类与重要性分级(c/h/n/l 四级)
  3. 智能检索 :通过 get 、 search " " 或 recall 按需调取上下文
  4. 会话结束 :可选执行 sync --end 触发维护
    显著优点
    | 优势 | 说明 | |------|------| | 真正的零干扰 | 严格禁止询问/宣布/展示,用户体验无感知 | | 分支隔离+继承 | 每个 Git 分支拥有独立记忆空间,新分支自动继承 main,合并后支持 merge-branch 同步 | | 智能实体提取 | 自动识别 topic/subject、#hashtag、"引号短语"、首字母大写术语等,构建知识图谱 | | 类型自动检测 | 基于关键词识别 decision/preference/learning/task/question/progress 等 8 类记忆 | | 进化追踪 | evolve 命令支持记录决策变更历史,避免信息覆盖 | | 结构化存储 | JSON 格式内容,支持多字段决策记录(含理由、备选方案等) | 潜在局限性与风险
    | 局限 | 说明 | |------|------| | Git 依赖 | 必须在 Git 仓库内运行,非 Git 项目无法使用 | | 路径配置 | 需正确配置 $SKILL_PATH$DIR,配置错误导致失效 | | 静默失效难察觉 | 若命令执行失败,用户和 Claude 均无法感知,可能导致"失忆" | | 分支混淆风险 | 频繁切换分支若未及时 sync --start,可能加载错误上下文 | | 重要性主观性 | -i c/h/n/l 分级依赖 Claude 判断,存在误判可能 | | 隐私边界模糊 | 文档未明确说明敏感信息(密码、API key)的自动过滤机制,存在泄露风险 | 适合人群
    长期项目协作 :需要跨数周/数月维持上下文连续性的开发者
    多分支并行工作 :在 feature 分支间切换、需要隔离+合并记忆的场景
    高上下文依赖任务 :复杂架构决策、逐步演进的系统设计讨论
    常规风险
  5. 过度记忆 :缺乏明确的存储上限与自动清理策略(仅 -i l 可修剪),长期项目可能累积冗余
  6. 检索噪声 :实体提取的自动化可能索引过多无意义术语,降低检索精度
  7. 分支遗留 :已删除的 Git 分支若未清理对应 notes,造成存储浪费
  8. Claude 幻觉干扰 :若记忆内容与当前实际代码状态脱节,可能导致基于过时信息的错误建议

标签

专业技能

💬 评论 (0)

发表评论

支持 Markdown

📭 还没有评论,快来抢沙发吧!