work-logs-knowledge-log

work-logs-knowledge-log 技能旨在作為 AI 輔助開發過程中的文件擷取工具。當 AI 代理處理儲存庫時，它不可避免地會識別出單從原始程式碼中無法立即顯現的細微差別、架構意圖和未記錄的業務邏輯。此工具允許代理提取這些發現並將其儲存為結構化的 Markdown 知識日誌以供未來參考，從而彌合原始程式碼與人類可讀的專案背景之間的差距。它主要適用於需要維護儲存庫環境內機構知識的開發人員和技術負責人。

• 自動在 ~/.claude/knowledge/${repo_name}/ 目錄中產生帶有時間戳記的知識日誌檔案。

• 優先記錄推斷的程式碼邏輯與實際使用者業務需求或限制之間的差異。

• 捕捉隱性規則、操作實踐以及解釋程式碼結構背後原因的具體設計理由。

• 使用標準檔案系統工具（Read, Write, Grep, Glob）來檢查程式碼並保存文件檔案。

• 支援基於亞洲/東京時區的標準化日期時間前綴，以確保時間順序的一致性。

• 當遇到程式碼功能與專案需求之間的差異時，或在任務的發現階段，請觸發此技能。

• 使用所記錄的日誌作為確定官方專案文件需要擴充或修正之處的基礎。

• 確保日期時間格式遵循 +%Y-%m-%d_%H-%M 約定，以便進行檔案組織。

• 依靠此技能來記錄技術債、具體的業務邏輯例外以及未在提交訊息或標準 README 檔案中記錄的架構決策。

• 該工具限制在定義的 ~/.claude/knowledge 路徑內運作，確保知識累積保持在代理的工作空間內。