Git笔记记忆系统

技能简介

git-notes-memory 是一个利用 Git notes 机制实现的持久化记忆系统。它通过将记忆数据存储在 Git 仓库的 notes 中，实现跨会话的上下文保持与知识积累，支持分支级别的隔离与合并。

业务背景

解决AI助手会话重启后丢失上下文的痛点，让项目决策、技术方案等关键信息在多次对话中持续累积。通过Git分支隔离机制，不同功能线的记忆互不干扰，同时支持按重要度分级管理，避免信息淹没。

落地案例：某开发团队使用Claude进行架构设计时，每次新建会话都需重复说明技术栈和已确定的方案。启用该工具后，团队在首次会话中将「微服务拆分原则」标记为关键记忆并打上#架构标签。后续会话执行sync –start即可自动恢复上下文，通过search #架构快速定位历史决策，新成员加入时也能通过Git notes查看完整知识脉络。

能做什么

• 在 Claude 会话间自动同步项目上下文与决策记录
• 按重要性分级存储信息（关键/高/普通/低）
• 通过标签体系组织记忆内容，支持全文检索
• 识别当前 Git 分支，提供分支相关的历史记忆
• 静默运行，无需用户干预即可完成记忆操作

使用说明

安装准备

1. 确保系统已安装 Python 3 与 Git
2. 克隆或下载技能仓库中的 memory.py 文件
3. 确认目标项目目录已初始化为 Git 仓库

基础命令格式

python3 /path/to/memory.py -p /project/dir <command>

会话生命周期管理

1. 会话开始时执行：sync --start 获取当前分支的记忆概览
2. 会话中按需调用：remember 存储决策、get 或 search 检索历史
3. 会话结束时可选：sync --end 提交会话摘要并触发维护

核心命令示例

# 初始化会话
python3 $SKILL_PATH/memory.py -p $DIR sync --start

# 存储重要决策
python3 $SKILL_PATH/memory.py -p $DIR remember '{"decision":"选用PostgreSQL"}' -t db,backend -i h

# 检索主题相关记忆
python3 $SKILL_PATH/memory.py -p $DIR get authentication

# 全文搜索
python3 $SKILL_PATH/memory.py -p $DIR search "数据库迁移"

输入与输出

见下方输入与输出表格。

风险提示

• 该技能设计为静默自动运行，若配置不当可能导致意外写入 Git notes
• Git notes 与普通提交历史分离，需特定命令查看，存在数据遗忘风险
• 多分支场景下记忆分散，切换分支时可能丢失上下文关联
• 依赖本地 Git 环境，远程协作时记忆不会自动共享
• 长期积累的 notes 可能影响仓库体积，建议定期清理低重要性条目

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mourad-ghafiri/git-notes-memory/SKILL.md
来源类型：开源技能仓库