agent-memory

agent-memory 技能提供了一種穩健的持久化儲存機制，旨在協助 AI 代理在漫長的開發週期中維持上下文。透過在 .claude/skills/agent-memory/memories/ 建立專用目錄，此技能允許代理儲存珍貴的研究結果、架構決策、複雜的除錯過程以及進行中的開發任務。這能防止資訊隨對話結束而遺失，並作為結構化的知識庫，讓代理在開始新任務前能主動查詢，確保技術一致性並減少重複調查的工作量。

• 持久化儲存專案特定的見解，包括程式碼庫中的潛在陷阱（gotchas）以及複雜的依賴關係解析模式。

• 支援使用資料夾與 YAML 前置資料進行分類管理，可追蹤狀態、標籤與更新時間戳記。

• 與 ripgrep (rg) 指令整合，可透過摘要、標籤或全文關鍵字進行快速搜尋與過濾。

• 提供「儲存與恢復」工作流，允許代理記錄任務的當前狀態、已識別的阻礙問題以及未來的行動項目。

• 標準化記憶格式，確保所有條目皆可被機器讀取，且易於由代理的檔案系統操作功能進行遍歷。

• 每當你在除錯過程中發現不顯眼的模式或解決方案時，請使用此技能，以避免「遺忘」關鍵邏輯。

• 請務必重視 YAML 前置資料中的 summary 欄位，這將作為代理在搜尋既有筆記時的核心判斷依據。

• 請遵循 kebab-case 命名慣例來命名檔案與目錄，以保持記憶空間的整潔與可維護性。

• 定期整理或合併記憶內容，以避免碎片化，並確保代理僅能檢索到高品質、相關的資料。

• 執行搜尋操作時，務必對 ripgrep 使用 --no-ignore 與 --hidden 旗標，以確保代理即使在全域 gitignore 設定下，仍能正確遍歷記憶目錄。