review

review skill 概覽

review 會做什麼

review 是一個用於稽核 Claude Code auto-memory 的 self-improving-agent skill。它能協助代理檢查 MEMORY.md、找出適合提升為長期指引的候選項目、辨識過時或重複的記錄，並產出維護建議，避免專案記憶無限制膨脹。當你想了解代理學到了什麼、哪些內容應該成為可長期沿用的專案指引、哪些內容應該修剪時，就適合使用 review skill。

這個 review skill 最適合的情境

這個 skill 最適合已將 Claude Code memory 納入 Context Engineering 工作流程的團隊。若你的專案會自動記錄反覆出現的經驗、工具偏好、架構決策或常見錯誤，但需要定期做編輯式審查，review skill 會很有幫助。反之，如果專案沒有使用 Claude Code memory、沒有 .claude 專案記憶目錄，或只是需要一次性摘要某個原始檔，這個 skill 的用途就比較有限。

它和一般 prompt 有什麼不同

一般的「summarize my memory」prompt 通常會漏掉實務上的檢查步驟。review skill 會提供代理一條明確的稽核路徑：定位專案專屬的 memory 目錄、讀取 MEMORY.md、依 200 行啟動限制檢查行數壓力、偵測重複出現的模式、確認過時的檔案參照，並將適合提升的候選項目和低價值記錄分開。這樣的結構讓輸出更能直接用於維護長期運作的代理上下文。

如何使用 review skill

安裝 review 並先檢查哪些檔案

使用以下指令從 GitHub repository 安裝 skill：

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

安裝後，先閱讀 SKILL.md。這個 repository 路徑把完整工作流程放在單一檔案中，沒有額外的 rules/、resources/、references/ 或 scripts 需要檢查。最重要的來源章節是 Usage、What It Does、Step 1: Locate memory directory，以及 Step 2: Read and analyze MEMORY.md。

review 的基本使用指令

上游 skill 的設計是以 /si:review 這類呼叫方式為中心：

• /si:review 用於完整的 memory audit
• /si:review --quick 用於取得行數與主要候選項目
• /si:review --stale 用於聚焦過時記錄
• /si:review --candidates 只顯示可能適合提升的項目

實務上，請在你想稽核的專案根目錄呼叫 review skill。這個 skill 需要能存取 Claude Code 的專案記憶，通常位於從目前工作目錄推導出的 ~/.claude/projects/.../memory 路徑底下。

讓 review 輸出更好的輸入方式

較弱的 prompt 是：「Review memory。」

更好的 prompt 是：

「Run the review skill for this repository. Check the project auto-memory, count MEMORY.md lines against the startup limit, identify recurring lessons that should be promoted into durable instructions, flag stale entries that reference deleted files or old tools, and group recommendations by promote, consolidate, prune, and keep.」

這樣效果更好，因為它明確指定了稽核標準與決策分類。如果你知道近期專案有哪些變更，也請一併提供：重新命名的目錄、移除的工具、新的程式碼標準，或政策變更。這些資訊能幫助代理判斷某條 memory entry 已經過時，還是仍然有價值。

建議的 review 工作流程

如果 memory 檔案很大，或你只需要先做分流，請從 /si:review --quick 開始。當你準備刷新上下文、替新的代理設定做 onboarding，或在大型功能週期前清理累積的 memory 時，再執行完整 review。大型重構、依賴變更或檔案搬移之後，使用 --stale。如果你的目標是 Context Engineering，也就是把反覆出現的經驗提升到 CLAUDE.md、專案文件或團隊規則中，請使用 --candidates。

review skill 常見問題

review 只適用於 Claude Code memory 嗎？

是。這個 skill 是特別依照 Claude Code auto-memory 慣例設計的，尤其是 ~/.claude/projects/.../memory 底下的專案記憶與 MEMORY.md。你可以把 review guide 改用在其他 memory 檔案上，但當代理能依照預期的 Claude Code memory layout 執行時，它的價值最高。

如果沒有 memory 目錄會怎樣？

skill 應該會回報 auto-memory 可能尚未啟用或無法使用，接著建議檢查 memory 設定，例如使用 /memory。這也是安裝前值得考慮的一點：如果你的團隊尚未啟用或累積 Claude Code memory，在 memory 存在之前，review 幾乎沒有內容可分析。

什麼時候不該使用 review？

不要把 review 當成 code review、security review 或 documentation QA 的替代品。它稽核的是代理記憶品質，不是原始碼正確性。對於沒有重複模式的全新專案、刻意避免持久化代理記憶的團隊，或你只需要某一份文件的簡單摘要時，它也不太適合。

review 如何協助 Context Engineering？

對 Context Engineering 來說，review 會把原始 memory 轉成一份維護佇列。它協助判斷哪些反覆觀察應該成為穩定上下文、哪些項目彼此重複，以及哪些過時筆記在誤導未來代理之前應該移除。當你把它的輸出視為對代理操作上下文的一次編輯審查時，最能發揮價值。

如何改善 review skill

提供 review 證據，而不只是下指令

當代理能檢查實際的 memory 檔案與目前 repository 時，review skill 的表現會更好。請確保它能透過檔案系統檢查來驗證被引用的路徑，而不是只依賴 memory 文字。如果你懷疑某些指引已經過時，請說明原因，例如：「we migrated from Jest to Vitest」、「the api/legacy folder was removed」，或「the deployment process changed last week」。

要求可直接決策的分類

請要求輸出能對應到具體行動的分類。好的分類包括：

• Promote to durable project instruction
• Consolidate with similar entries
• Prune because stale or low-value
• Keep as temporary memory
• Investigate because evidence is unclear

這能避免 review 輸出變成模糊摘要，也更方便在稽核後更新 CLAUDE.md、團隊文件或 memory 檔案。

常見失敗模式與注意事項

最常見的失敗，是把一次性的觀察過度提升為長期指引。通常只有在某個 memory item 反覆出現、具有政策性，或對未來多次 session 都有廣泛幫助時，才適合提升。另一個失敗模式，是只因為記錄很舊就把它刪掉；時間久本身並不代表過時。更可靠的過時訊號包括檔案不存在、工具已被替換、慣例彼此矛盾，或引用的是已完成的暫時性工作。

第一次 review 後持續迭代

第一次 review 後，請代理把建議轉成最小 patch plan：哪些要新增、合併、移除，以及重新檢查。接著再用 quick mode 執行一次 review，確認 memory 變得更短、重複更少，並且更符合目前的專案行為。這會讓 review 成為持續的維護循環，而不是一次性的報告。