remember

remember skill 概覽

remember 會做什麼

remember skill 是一個聚焦於 Knowledge Capture 的技能，用來在資訊重要到不該只依賴自動擷取時，明確把事實、慣例、決策與容易踩雷的細節保存到 Claude auto-memory。它適合用在像是「我們終於找到 CI 問題了」、「這個專案有一個沒寫在文件裡的慣例」，或「Claude 不應該忘記這個團隊偏好」這類時刻。

與其只是請助理「記住這件事」然後期待它之後真的會保留，remember 讓代理有一套可重複的流程：解析要保存的知識、檢查是否重複，並寫入帶有時間戳記與脈絡的記憶項目。

最適合的使用者與團隊

如果你處理的是長期專案，而且反覆出現的脈絡很重要，就適合使用 remember skill：例如工程團隊、同時維護多個 repository 的獨立開發者、AI 輔助除錯流程，或需要隨時間累積經驗的代理。當重要知識存在於聊天紀錄中，但尚未整理到 CLAUDE.md、文件、測試或程式碼註解裡時，它特別有用。

這個 skill 不是完整的知識庫、筆記 app，也不是文件產生器。它的任務更窄：保存精簡、可執行，且應該影響未來 Claude session 的記憶。

與一般 prompt 的差異

像「remember this」這樣的一般 prompt 很模糊。remember skill 加入了操作上的紀律：它會要求釐清要記住什麼、為什麼重要，以及這段記憶是專案限定還是全域適用。它也包含重複檢查步驟，避免記憶檔被同一件事的不同版本塞得過於雜亂。

因此，當「忘記」的代價很高時，remember 會很有價值：例如重複除錯、選錯工具、忽略 coding convention，或偏好逐漸漂移。

如何使用 remember skill

remember 安裝與原始碼檢視

使用你的 skill manager 從 repository 安裝這個 skill，例如：

npx skills add alirezarezvani/claude-skills --skill remember

接著檢視來源檔案：

engineering-team/self-improving-agent/skills/remember/SKILL.md

這個 skill 很精簡；從 repository preview 來看，沒有獨立的 scripts/、references/、rules/ 或 resources/ 目錄，因此 SKILL.md 是主要需要閱讀的檔案。在把它用於 production agent setup 之前，請特別留意使用範例、重複檢查指令，以及記憶項目的寫入流程。

remember 基本用法

呼叫 skill 時，使用 /si:remember，後面接上你想保存的確切知識：

/si:remember "This project's CI requires Node 20 LTS — v22 breaks the build"

好的輸入應該具體、耐久，而且可執行。較弱的輸入像是：

/si:remember "CI is weird"

較好的輸入像是：

/si:remember "CI fails on Node 22 because the build image expects Node 20 LTS; use Node 20 for local reproduction and GitHub Actions parity"

較強的版本會告訴未來的 Claude 發生了什麼、適用在哪裡，以及應該採取什麼行動。

prompt 裡應該包含什麼

為了得到最好的結果，請包含四種資訊：

• Fact： Claude 應該保留的事實。
• Context： 適用的地方，例如 repo、endpoint、test suite、tool 或 team。
• Reason： 為什麼忘記它會造成不好的輸出。
• Scope： 它是專案限定，還是一般偏好。

範例：

/si:remember "Project-specific: In this repo, API auth uses a custom JWT library instead of passport. Do not recommend passport middleware unless we are replacing the auth layer."

這會提供足夠材料，讓 skill 建立日後真正有用的記憶，而不只是模糊的備註。

Knowledge Capture 的實務流程

在完成一項發現、決策或修正後，立刻使用 remember。最佳時機是資訊還很新鮮、而對話尚未切換到下一件事之前。

一個實用流程：

1. 在除錯、review 或規劃過程中發現一個耐久的事實。
2. 把它轉成一句帶有脈絡與後果的句子。
3. 執行 /si:remember "<fact>"。
4. 讓 skill 檢查是否已有重複記憶。
5. 如果已有類似項目，請更新或釐清，而不是加入雜訊。
6. 繼續工作，讓新的記憶可供未來 session 使用。

這個流程能讓記憶保持實用，而不會變成逐字聊天紀錄。

remember skill 常見問題

什麼時候應該使用 remember？

當某項知識很可能影響未來工作，而且並未明顯存在於 codebase 或文件中時，就適合使用 remember。好的候選內容包括 build requirements、framework constraints、architecture decisions、反覆發生的測試問題、未文件化的慣例，以及穩定的使用者或團隊偏好。

除非某個暫時任務狀態在 session 結束後仍然重要，否則不要用它保存像「我目前正在編輯 file X」這類資訊。

remember 適合初學者嗎？

適合，因為指令很簡單；但初學者要小心，不要保存模糊或情緒化的備註。像「the database is annoying」這樣的記憶沒有幫助。像「Local DB tests require Docker Compose service postgres-test to be running before npm test」這樣的記憶才有用。

當使用者能清楚描述操作上的教訓時，這個 skill 的效果最好。

remember 和 CLAUDE.md 有什麼不同？

CLAUDE.md 更適合穩定、共享的專案指示，也就是每個未來代理都應該作為 repo 一部分讀到的內容。remember 則更適合漸進式學習、辛苦找出的發現，以及可能還沒準備好寫成正式文件的脈絡。

好的模式是先使用 remember，之後再把反覆出現或團隊層級的記憶提升到 CLAUDE.md、README 檔、測試或架構文件中。

什麼時候不該使用 remember？

不要用 remember 保存 secrets、credentials、private tokens 或敏感個人資訊。當某項知識應該讓整個團隊都看得見時，也不要把它當成 source-controlled documentation 的替代品。另外，除非你清楚標示不確定性，否則也應避免保存猜測、尚未解決的理論，或一次性的觀察。

記憶應該降低未來犯錯的機率，而不是保存推測。

如何改善 remember skill

用更精準的輸入改善 remember 結果

影響品質最大的關鍵是輸入句子。在呼叫 remember 之前，先把粗略發現改寫成耐久的指引。

粗略版本：

/si:remember "Jest hangs sometimes"

較好版本：

/si:remember "Project-specific: Jest integration tests can hang after DB tests unless run with --forceExit; use this flag when reproducing CI test hangs locally."

這個版本點出了工具、條件、解法與適用範圍，讓保存下來的記憶更容易被 Claude 正確套用。

避免重複與過時的記憶

上游 workflow 包含針對 project memory file 的重複檢查。請尊重這個步驟。重複的記憶會產生彼此衝突的指引，特別是當某個慣例隨時間改變時。

如果你找到較舊的項目，建議從概念上修訂該記憶：「This replaces the old Node 18 note; the project now standardizes on Node 20 LTS.」清楚標示取代關係，會比累積互相矛盾的事實更好。

把反覆出現的記憶轉成文件

如果同一個被記住的事實會影響多位 contributor，就應該把它從 memory 中提升出來。把它加入 CLAUDE.md、README.md、onboarding docs、test setup notes 或 architecture decision records。remember 很適合用來擷取知識，但 source-controlled documentation 更適合共享治理。

一個實用規則：如果 Claude 已經需要同一段記憶超過兩次，人類很可能也需要它。

常見失敗模式

主要的失敗模式是保存過多、範圍不清，以及在缺乏證據時保存結論。避免過於寬泛的項目，例如「always use explicit error handling」，除非那真的是全域偏好。請優先使用有範圍的指引：「In this repo, avoid catch-all error handlers in API routes because errors are logged by middleware.」

好的 remember 用法會建立精簡、具脈絡的記憶，提升未來協助品質，同時不會讓代理變得僵化或充滿雜訊。