/ 目录 / 演练场 / project-memory
● 社区 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

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "project-memory-skill",
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "project-memory-skill": {
      "command": {
        "path": "pip",
        "args": [
          "install",
          "skilz",
          "&&",
          "skilz",
          "install",
          "SpillwaveSolutions_project-memory/project-memory"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add project-memory-skill -- pip install skilz && skilz install SpillwaveSolutions_project-memory/project-memory

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: 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中,而不是在此处。
数据出站: 本地文件;技能本身没有网络活动

故障排查

常见错误与修复

/project-memory命令无法识别

技能未安装在预期范围内。使用skilz重新安装并重新启动Claude。

验证: ls ~/.claude/skills/project-memory/ or .claude/skills/project-memory/
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