changelog

Changelog 技能為使用 Claude Code 的開發者提供了一套先進的稽核與可觀測性工具。透過 PostToolUse 鉤子直接整合至開發迴圈中，它能在您工作時自動捕捉事件的時間序列。這使子代理、除錯器與人類開發者能夠重構導致專案當前狀態的操作序列，有效回答關於專案配置如何演變的問題。此技能維護一個持久性的 JSONL（JSON Lines）日誌檔案，確保事件數據結構化，適合機器讀取與人工分析。它是 auto-loop 檢查點系統的重要夥伴，提供與檢查點靜態快照互補的歷史脈絡串流。專為軟體工程師與技術團隊設計，特別適用於除錯複雜故障、執行開發會話的事後分析，以及為多代理團隊協作提供背景資訊。

• 使用 PostToolUse 鉤子自動記錄檔案建立與修改事件，實現即時可觀測性。

• 記錄 Bash 層級活動，包括測試執行結果（通過/失敗）與 Git 提交事件。

• 實作自動化日誌輪替邏輯，將當前日誌檔案保持在 500 行以內，以防止效能下降或過度佔用磁碟空間。

• 透過使代理能夠查詢歷史日誌來了解先前的專案互動與環境狀態，促進會話復原。

• 透過使用 CLAUDE_PROJECT_DIR 環境變數，支援可攜式路徑管理。

• 請確保該技能在您的專案環境中啟用，以利於 Write、Edit 與 Bash 工具使用時觸發自動鉤子。

• 請檢查所產生的 .director-mode/changelog.jsonl 檔案，以獲取當前會話的完整稽核追蹤。

• 若鉤子被繞過或失效，開發者可透過 auto-loop 提示手動觸發事件記錄，以維持稽核流的一致性。

• 系統強制要求每個專案僅能執行一個 auto-loop 會話；請使用 --resume 或 --force 旗標來管理會話衝突或重新初始化日誌。

• 歸檔檔案以時間戳記命名儲存，允許對專案隨時間的演變進行長期歷史分析。