/ 目錄 / 演練場 / 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 project✓ 已複製
    → 出現.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中
    記錄:「我們使用儲存庫模式,而不是Active Record。理由:<x>. '✓ 已複製
    → 清除決策中的ADR.md
  2. 詢問重構
    建議重構src/billing/—尊重我們的決定.md。✓ 已複製
    → 提案參考了儲存庫決策,並未建議使用中的記錄

結果: 在審查中被拒絕的死角提案更少。

搭配使用: git

組合

與其他 MCP 搭配,撬動十倍槓桿

project-memory-skill + memory-bank-mcp

將專案記憶體用於規範的四個檔案,將memory-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僅適用於非敏感配置。在環境或保險庫中保守祕密,而不是在這裡。
資料出站: 本機檔案;技能本身沒有網路活動

故障排查

常見錯誤與修復

/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