/ 目錄 / 演練場 / 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 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僅適用於非敏感配置。在環境或保險庫中保守祕密，而不是在這裡。
資料出站： 本機檔案；技能本身沒有網路活動

故障排查

常見錯誤與修復

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