session-logs

session-logs 技能為 GeminiClaw 代理程式框架提供強大的介面，用於查詢與分析歷史活動。此工具專為需要審視多輪對話、稽核代理程式決策以及進行自主作業成本分析的開發者與進階用戶所設計。透過利用儲存在工作空間記憶體中的結構化 JSONL 資料，該技能能以程式化方式存取回應文字、工具執行狀態及 Token 消耗指標，是效能最佳化與偵錯複雜代理程式工作流程的關鍵工具。

• 使用 ripgrep (rg) 在所有歷史會話回應中進行細粒度的關鍵字搜尋，確保高速的模式匹配能力。

• 分析工具執行頻率，並識別導致錯誤或意外失敗的異常工具呼叫。

• 計算累積與每日的 Token 消耗趨勢，以管理預算並優化 LLM 提示詞效率。

• 檢索結構化會話資料，包括 RunID、時間戳記以及手動輸入或心跳事件等觸發來源。

• 存取與搜尋與 Obsidian 相容的 Markdown 摘要，其中包含摘要 (TL;DR)、關鍵決策及對話上下文。

• 利用 jq 過濾器解析嵌套的 JSONL 結構，以獲取特定元資料，例如失敗的工具呼叫或瀏覽器導航 (browser_navigate) 等特定工具名稱。

• 請確保根據 geminiclaw_status 工具或 GEMINI.md 設定正確配置 {workspace} 路徑。

• 請注意，摘要會在會話閒置時自動產生，亦可透過 geminiclaw session summary 指令手動強制執行。

• 若在處理 JSONL 日誌首行時遇到檔案處理錯誤，請使用 jq 過濾掉 null 項目。

• 本技能旨在 GeminiClaw 環境內執行，確保分析過程保留在 Docker 沙盒內，以實現最高的安全性與隱私保護。

• 為了發揮最佳效用，請確保您在具備標準 Unix 工具組 (包含 jq、rg 與 awk) 的終端機環境中執行這些查詢。