read-memories

read-memories 技能概覽

read-memories 的用途

read-memories 是一個 Claude Code 技能，用來搜尋先前的 session 日誌，幫你找回決策、重複出現的模式、未完成的待辦，以及使用者更正過的內容。當有人問「你記得嗎」、「我們當時決定了什麼」，或某個新任務明顯依賴先前脈絡時，它最有用。如果你是為 Workflow Automation 使用 read-memories 技能，可以把它想成一個檢索步驟：把舊對話歷史轉成可直接使用的工作脈絡。

誰適合安裝

如果你會跨多個 Claude Code session 工作、維護持續進行中的專案，或經常回頭處理未完成事項，就適合安裝 read-memories。對需要延續性、而不是大量新想法的 agents 和重度使用者來說，它很合用。如果你的任務大多彼此獨立、一次性完成，而且不依賴前一次對話，那它的價值就會比較有限。

它和一般記憶提示的差異

它的關鍵差異不只是「關於記憶」的泛用提示，而是一套具體的日誌搜尋流程：先安靜地查詢，再做後續整理。也就是說，它的主要價值不是抽象地「記住」，而是快速在本機 session 檔案裡找到證據，並在不把原始日誌暴露給使用者的前提下加以運用。

如何使用 read-memories 技能

正確安裝並限制作用範圍

請使用 read-memories install 流程，把技能加入你的 Claude Code 設定，並且只在本機有 session 日誌的環境中保留可用性。這個技能預期能存取 Bash，以及標準的 Claude Code 專案日誌結構。如果你打算把 read-memories 用在 Workflow Automation，務必確認執行環境讀得到它要查詢的日誌路徑。

從正確的輸入開始

這個技能在你提供明確關鍵字或主題時效果最好，例如很可能出現在先前日誌裡的功能名稱、ticket ID、客戶名稱或決策片語。像「查記憶」這種模糊請求太廣了。更好的提示會像這樣：Use read-memories to find prior decisions about the DuckDB export flow and summarize any unresolved issues. 這樣能給技能清楚的搜尋目標與輸出目的。

技能實際執行了什麼

這個 repo 的流程很簡單：先用 DuckDB 查 session 日誌，再把結果內化後回應。read-memories usage 的模式是以搜尋 $HOME/.claude/projects/ 底下的 JSONL 檔案為核心，並可選擇用 --here 把搜尋限制在目前專案。如果你要改寫這個技能，請先讀 SKILL.md，再確認實際的搜尋路徑邏輯，以及對結果採取的兩步處理方式。

有助於提升結果的做法

請用明確的關鍵字，不要用太籠統的概念。當同一個詞在很多地方都出現時，要加上專案脈絡。如果第一次搜尋雜訊太多，就用專案範圍或更精確的片語縮小範圍。若輸出要支援目前的工作，也要直接告訴技能你最在意的是哪種記憶：決策、TODO、使用者偏好，還是先前犯過的錯。這會影響它該從日誌裡萃取什麼。

read-memories 技能 FAQ

read-memories 只適用於 Claude Code 嗎？

它是以 Claude Code 的 session 日誌與 repo 中展示的本機專案結構為基礎設計的。這讓它很適合那個生態系，但不是通用型記憶工具。如果你的工作流程沒有把對話存到預期的 JSONL 路徑裡，這個技能就不會是好選擇。

它和一般提示有什麼不同？

一般提示是要模型自行推斷脈絡；read-memories 則是先做真正的日誌搜尋，再整理證據。也就是說，當正確性取決於先前決策時，它會更好用；如果你只是想要一個全新的答案，它就不一定划算。read-memories guide 談的因此是檢索，不是一般推理。

這個技能適合初學者嗎？

只要你說得出自己想找回什麼，就算適合。難點不是 Bash，而是要選到一個很可能曾經出現在過去 session 裡的關鍵字。如果不確定，就先用專案名稱加上任務標籤，再根據第一次搜尋結果繼續收斂。

什麼情況下不該使用它？

當本機沒有相關日誌、主題真的是全新的，或需求依賴的是外部事實而不是先前 session 時，就不要用 read-memories。這些情況下，標準的研究或起草流程通常更快，也更乾淨。

如何改善 read-memories 技能

提供更好的搜尋詞

影響品質最大的就是關鍵字。不要只用大範圍名詞，應該改用名稱、短片語，或在原始討論中很可能重複出現的識別字樣。例如，refund policy 就不如 Q4 refund exception，或一個 ticket number 來得精準。更好的輸入會帶來更準確的回憶，也會減少不相關的日誌雜訊。

明確指定你要哪一種記憶

請直接說清楚你希望 read-memories usage 輸出的是什麼：決策、未解問題、偏好、阻礙，還是下一步。如果你只要求「脈絡」，結果可能會太發散；如果你要求「找出最後一次確認的 API contract，以及任何反對意見」，技能就能更聰明地過濾。

留意常見失敗模式

最常見的失敗模式是搜尋範圍太廣、日誌命中重複，以及過度相信某一次舊 session。有效的 read-memories 技能檢視，應該確認取回的脈絡是否仍然有效，以及後續 session 是否已經推翻它。如果第一次抓到的是過時資訊，就用更窄的專案範圍，或更新的關鍵字重新搜尋。

在第一次結果後繼續迭代

先用第一次檢索找出更好的術語，再在需要時用那些術語重新搜尋。這在主題隨時間演變、而最初查詢只找到最早提及的情況下特別有幫助。對 read-memories for Workflow Automation 來說，最佳做法是把第一輪當成探索，再在把記憶用進自動化流程之前進一步收斂搜尋。