/ 目录 / 演练场 / project-memory
← 全部服务器 ↗ GitHub
● 社区 SpillwaveSolutions ⚡ 即开即用

project-memory

作者 SpillwaveSolutions · SpillwaveSolutions/project-memory

Claude在提出更改之前会阅读四个人类可读的文件-- bugs.md、decisions.md、key_facts.md、issues.md。没有数据库的项目内存。

project-memory是一项Claude Code技能，它在docs/project_notes/下安装四个轻量级笔记，并教Claude在进行架构更改之前咨询它们。与内存库MCP不同，它是您在PR中查看的普通文件： bugs.md使用预防策略捕获错误模式， decisions.md是您的ADR日志， key_facts.md保存非敏感配置， issues.md是工作日志。可全局安装、按项目安装或按工作空间安装。

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

实时演示

实际使用效果

project-memory-skill.replay ▶ 就绪
0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： project-memory

现有代码库上的Bootstrap项目内存

👤 团队厌倦了向客服代表重新解释相同的背景 ⏱ ~15 min beginner

何时使用： 您一直在此存储库上使用Claude Code ，但上下文会重置每个会话。

前置条件
  • 适用于skilz安装程序的Python 3.10 + — pyenv或system Python
步骤
  1. 在项目范围内安装
    pip install skilz & & skilz install SpillwaveSolutions_project-memory/project-memory --scope项目✓ 已复制
    → .claude/skills/project-memory/SKILL.md出现
  2. 运行bootstrap命令
    /project-memory —初始化此存储库的四个文件。✓ 已复制
    → docs/project_notes/使用四个规范文件创建
  3. 种子决策.md有2–3个已知的选择
    为我们的ORM选择、错误处理约定和CI运行器添加ADR。✓ 已复制
    → 三个整洁的ADR条目

结果： Claude现在有一个持久的、可审查的大脑来进行这个回购。

注意事项
  • 使用密钥提交key_facts.md — 该技能明确将key_facts.md标记为「非敏感」—切勿将凭据放在那里
搭配使用： memory-bank-mcp

捕捉漏洞的根本原因，避免漏洞再次出现

👤 待命工程师扑灭火灾 ⏱ ~5 min beginner

何时使用： 您刚刚修复了一些棘手的东西，并希望课程持久。

步骤
  1. 让Claude录音
    将此添加到bugs.md —错误为billing.retry中的NoneType ；根本原因：过时的幂等密钥缓存；预防：缓存上的TTL。✓ 已复制
    → 具有根本原因+预防的新bugs.md条目

结果： 下次出现类似症状时支付股息的漏洞目录。

注意事项
  • 写下症状而不是原因 — 强制条目具有“根本原因”和“预防”部分—而不仅仅是“我修复的内容”
搭配使用： github

在建议重构之前，让Claude咨询decisions.md

👤 不喜欢与客服代表重新提起诉讼的团队 ⏱ ~10 min beginner

何时使用： 您的客服代表不断提出团队已经拒绝的框架/模式。

步骤
  1. 确保在decisions.md中做出决定
    记录： '我们使用存储库模式，而不是活动记录。理由：<x>.'✓ 已复制
    → 清除决策中的ADR.md
  2. 询问重构
    提出重构src/billing/—尊重我们的决定.md。✓ 已复制
    → 建议引用存储库决定，不建议使用活动记录

结果： 在审查中被拒绝的死胡同提案较少。

搭配使用： git

组合

与其他 MCP 搭配，撬动十倍杠杆

project-memory-skill + memory-bank-mcp

对策划的规范四个文件使用项目内存，对跨项目的自由形式工作内存使用内存-bank-mcp

将结构化ADR写入decisions.md ；将原始会话笔记转储到内存库中。✓ 已复制
project-memory-skill + github

合并PR后，更新decisions.md和issues.md作为PR描述的一部分

打开PR ，并在描述中包含decisions.md diff。✓ 已复制
project-memory-skill + git

在承诺之前检查记忆差异，以保持诚实

git diff docs/project_notes/—提交前阅读；修复任何误导性内容。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
/project-memory subcommand: init|add-bug|add-decision|add-fact|log-issue 启动文件并记录新条目 0

成本与限制

运行它的成本

API 配额
无
每次调用 Token 数
这取决于Claude加载的四个文件中的多少；条目要简短
费用
免费
提示
与长篇叙述相比，更喜欢简短、过时的条目— Claude每次会话都会对其进行扫描，因此尺寸很重要。

安全

权限、密钥、影响范围

凭据存储： 显式： key_facts.md仅适用于非敏感配置。将秘密保存在env或vault中，而不是在此处。
数据出站： 本地文件；技能本身没有网络活动

故障排查

常见错误与修复

Claude忽略决策.md

确保decisions.md有带有“Decision”和“Rationale”标题的清晰的ADR风格条目；模糊的项目符号会被略过。

验证： head docs/project_notes/decisions.md
文件不断增长

按季度存档—将旧条目移动到docs/project_notes/archive/，以便活动文件保持可扫描状态。

验证： wc -l docs/project_notes/*.md

替代方案

project-memory 对比其他方案

替代方案何时用它替代权衡
memory-bank-mcp您希望通过工具而不是文件访问跨项目内存更灵活，在公关评价中不太明显
codebase-memory您想要代码的符号图，而不是叙述性注释不同层次的记忆
marm-systems你想要一个更复杂的记忆框架更重的设置

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills