cursor-diary

Cursor Diary 技能專為重視開發流程中可重現性與結構化文件的軟體工程師而設計。透過維護細膩的實作日誌，它能確保開發過程中的每個環節（包含意圖、執行指令、錯誤輸出與設計決策）皆被系統化記錄。此工具作為個人知識庫，連結了原始程式碼變更與長期專案文件之間的斷層。

• 自動將實作步驟連結至 docmgr 工單與工作空間，以進行統一的專案追蹤。

• 完整擷取錯誤日誌與失敗過程，有助於後續偵錯與根本原因分析。

• 鼓勵小步提交（tiny-step commits），確保每一項變更皆獨立且具備對應的提交雜湊值（commit hash）。

• 提供捕捉高價值資訊的模板，例如處理技術瓶頸的心得與適合進行程式碼審查（code review）的觀察點。

• 支援雙向追蹤，利用絕對檔案路徑將特定的原始程式碼檔案連結至日記條目。

• 透過自動化記錄工單工作流，簡化變更日誌（changelog）的維護作業。

• 使用者應在開發會話或任務開始時啟動日記，以確保涵蓋完整的上下文資訊。

• 輸入內容應包含任務意圖、執行的命令、遭遇的錯誤及建構過程中的洞察。

• 工具依賴於 docmgr 工作空間，並建議使用者遵循約定的目錄結構（通常位於 ttmp/ 目錄下）。

• 最佳實踐是將日記更新與程式碼變更分開提交，以保持 Git 歷史記錄的整潔。

• 限制方面，需要持續使用 docmgr CLI 進行元資料（metadata）管理與檔案關聯。

• 輸出結果經最佳化，適用於開發者自我回顧，或提供足夠的背景資訊供他人進行程式碼審查，確保所有技術工件與決策理由與程式碼庫保持一致。