Git 笔记记忆系统
让 Claude Code 把决策、偏好和待办静默存进仓库的 git notes,下次开会话自动带回上下文。
功能与用途
每次新开会话都要重讲一遍项目背景、之前定过的方案和你的个人偏好,这种事做多了很消耗人。这个技能把会话中产生的决策、偏好、学到的结论、任务和阻塞,按 git notes 的形式存进当前仓库,跟着分支走,换台机器拉下来还在。它刻意做成静默运行:不会问你要不要记住,也不会跳出来说正在保存,你只是在正常干活,下次提问时它已经知道之前定过什么。按分支隔离,新分支自动继承主分支的记忆,合并代码后再把两边的记忆合到一起。
适用场景
- 每次新开会话都要重新解释项目用的是什么架构、当初为什么这么选:每次新开会话都要重新解释项目用的是什么架构、当初为什么这么选
- 上周已经说过「错误提示要详细一点」,这周代理又按默认的简短风:上周已经说过「错误提示要详细一点」,这周代理又按默认的简短风格回答
- 同时开好几个功能分支,希望每个分支记住自己的上下文,合并后再:同时开好几个功能分支,希望每个分支记住自己的上下文,合并后再汇总到一起
- 想查一下当初为什么放弃 Vue 选了 React,但当时的对:想查一下当初为什么放弃 Vue 选了 React,但当时的对话早就翻不到了
适用人群
- 长期用 Claude Code 做同一项目的开发者
- 需要代理跨会话记住架构决策的技术负责人
- 在多个功能分支上并行开发的工程师
使用步骤
- 确认你的项目目录已经是一个 Git 仓库,并知道 memory.py 脚本的实际路径。
- 在会话开始时执行 sync --start,拿到当前分支、高频话题和关键记忆的概览。
- 正常对话即可,代理会静默把决策、偏好、任务和更正按重要度存进去,关键偏好用 critical 级别。
- 需要查旧事时用 get 看某个话题、search 做全文检索,或用 recall 按 ID、标签、最近条数取回。
- 会话结束写一条摘要;分支合并代码之后,再执行 merge-branch 把两个分支的记忆合并起来。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 1.0.0
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Git-Notes-Based knowledge graph memory system. Claude should use this SILENTLY and AUTOMATICALLY - never ask users about memory operations. Branch-aware persistent memory using git notes. Handles context, decisions, tasks, and learnings across sessions.
使用前准备
- 需要 Python 3 环境、memory.py 的实际路径和一个 Git 仓库目录
- 使用者的代理须遵守静默运行规则
依赖与权限
- SKILL_PATH
- 读取用户主动提供的内容