| name | project-memory |
| description | 项目错误记录与经验积累技能。当遇到项目错误、需要修复问题、或进行配置修改时，自动记录错误原因和解决方案到项目专属记忆文件，而非根目录 memory。触发场景：项目报错、配置失败、部署问题、SDK集成问题、环境问题。 |
Project Memory Skill
项目专属错误记录和经验积累系统，避免污染全局记忆。
核心原则
- 错误即学习 — 每个错误都应记录原因和解决方案
- 位置正确 — 项目相关错误存在项目目录
.claude/project-memory/ 下，不写入根目录 memory
- 可追溯 — 记录时间、上下文、错误类型
目录结构
.claude/project-memory/
├── ERRORS/
│ ├── ssh-connections.md # SSH/服务器连接相关
│ ├── lark-sdk.md # 飞书 SDK 集成问题
│ ├── node-glibc.md # Node.js GLIBC 版本问题
│ ├── claude-code.md # Claude Code CLI 问题
│ └── [category].md # 按类型新增
├── SOLUTIONS/
│ ├── server-setup.md # 服务器配置经验
│ ├── env-variables.md # 环境变量配置
│ └── [topic].md # 按主题新增
└── MEMORY_INDEX.md # 记忆索引
工作流程
遇到错误时
- 首先检查
.claude/project-memory/ERRORS/ 中是否有相似记录
- 如果是新错误，创建新文件或追加到相关分类
- 如果是已记录的错误，验证解决方案是否仍然有效
记录格式
---
name: error-[short-name]
description: [错误简述]
type: error
date: YYYY-MM-DD
tags: [relevant-tags]
---
# 错误标题
## 问题描述
[清晰描述问题]
## 环境
- 服务器: [IP/主机名]
- OS: [系统版本]
- 组件: [相关组件版本]
## 错误信息
[完整错误日志]
## 根因分析
[分析根本原因]
## 解决方案
[具体解决步骤]
## 验证方法
[如何确认问题已解决]
记录经验时
---
name: solution-[short-name]
description: [经验简述]
type: solution
date: YYYY-MM-DD
tags: [relevant-tags]
---
# 经验标题
## 背景
[什么场景下学到的]
## 具体做法
[详细步骤]
## 注意事项
[避免踩坑]
## 相关错误
[链接到相关错误记录]
触发检查
遇到以下情况时，主动检查或记录：
- 部署/配置错误 → 记录到
ERRORS/
- SDK 集成问题 → 记录到
ERRORS/lark-sdk.md 等
- 环境兼容性问题 → 记录到
ERRORS/node-glibc.md
- 成功配置新服务 → 记录到
SOLUTIONS/
- 发现有用配置 → 更新
SOLUTIONS/
查询已有记录
遇到问题时，先查找是否有记录：
.claude/project-memory/ERRORS/
.claude/project-memory/SOLUTIONS/
使用文件内容判断是否已有相似问题。
与全局记忆的区分
- 全局记忆 (
MEMORY.md): SSH 连接配置、项目概览等长期不变的基础信息
- 项目记忆: 当前 session 会频繁遇到的具体错误和临时经验
简单判断：如果这个问题会在多个项目中出现，写入全局记忆。如果只在这个项目遇到，写入项目记忆。
