Claude Code x 打造 AI 對話回顧系統

我們每天都在用 Claude Code 開發各種功能。一個電子書閱讀器、一個表單系統、一個部署流程——每次對話少則十幾回合，多則上百回合。做完就做完了，關掉視窗，開始下一個任務。

常常有人問我「這個功能是怎麼做出來的」，我想說直接把跟 AI 的對話紀錄貼給他看最快。但實際操作才發現很不方便——對話紀錄散落在系統各處，格式也不適合閱讀。於是就在想，有沒有更好的呈現方式。

為什麼要把對話紀錄整理出來

跟 AI 協作不像跟人開會，沒有人幫你做會議紀錄。但每一次對話其實都藏著寶貴的資訊：你怎麼描述需求、AI 怎麼理解、中間來回了幾次才對齊認知。

這些資訊如果不整理，就只是一堆文字。整理出來之後，它變成一面鏡子——讓你看到自己的溝通模式，哪裡說得清楚、哪裡含糊帶過。

我們想做的事情很單純：把跟 Claude Code 的對話變成一個可以閱讀、可以分享、可以回顧的頁面。

這個頁面長什麼樣子

想像一下通訊軟體的對話畫面。右邊是你說的話，左邊是 AI 回覆的內容。黃色泡泡是你，灰色泡泡是 AI。每一則訊息都有時間標記，長的內容會自動折疊，點一下就能展開。

旁邊有一個資訊面板，一眼就能看到這次對話的關鍵數字：

• 花了多少 Token（可以理解成 AI 處理了多少文字量）
• 工作了多長時間
• 來回了幾個回合
• AI 用了哪些工具、各用了幾次
• 使用的 AI 模型是哪一個

最上面還有兩個特別的區塊：一個是「初始需求」，把你一開始的需求精煉成一段摘要，別人看到就能直接拿去當提示詞；另一個是「對話改善建議」，根據對話內容分析出你下次可以怎麼溝通得更好。

從六十一回合的對話中學到什麼

我們拿「電子書閱讀器」這個功能的對話來當第一個測試案例。六十一個回合、將近一萬兩千個 Token、AI 呼叫了 278 次工具。整理出來之後，幾個問題馬上浮現。

需求可以一次說完。 第一則訊息其實描述得很詳細——要做電子書閱讀器、要有翻頁、要能調字型。但後來又追加了「如果未來有不同系列文章也想做成電子書」這個需求。如果一開始就提出來，AI 的架構設計會更完整，不需要中途調整。

截圖要配文字。 開發到一半發現畫面不對，截圖丟給 AI 是最直覺的做法。但光丟截圖，AI 要自己猜「到底哪裡有問題」。如果截圖的同時寫一句「頁碼顯示重疊」或「這個按鈕點了沒反應」，AI 的理解速度會快很多。

相似的調整可以合併。 有好幾個回合都在調 UI 細節——字型大小、行高、背景色。每次只改一項，AI 就要重新讀一遍程式碼、改一個地方、重新編譯。如果把「字型改大一點、行高加寬、背景用米色」寫在同一則訊息裡，效率會好很多。

別問 AI 已經知道的事。 「路徑是？」這種問題，AI 其實剛剛才建好檔案，路徑就在上一則回覆裡。多問一句就多花一個回合的 Token。如果提需求時直接說「放在 /ebook/ 底下」，連確認都省了。

這些觀察不是事後硬想出來的，是把對話攤開來看才發現的。就像運動員看比賽回放一樣——當下覺得打得還行，回放一看才發現很多可以改進的地方。

讓開發紀錄成為可分享的資產

整理完對話之後，我們想到另一件事：這些紀錄不只是給自己看的。

如果有人想知道「用 AI 做一個電子書閱讀器要花多少時間」，看一眼統計面板就知道了——五十分鐘、六十一個回合。如果有人想做類似的功能，「初始需求」那段摘要直接複製就能當提示詞。如果有人想學怎麼跟 AI 溝通，完整的對話紀錄就是最真實的教材。

所以我們把這個功能做成了可以嵌入文章的卡片。在任何一篇技術文章的最後面，放上對應的開發紀錄卡片，讀者點進去就能看到「這篇文章背後的 AI 協作過程」。

回顧是為了下一次更好

我們現在養成了一個習慣：每次用 Claude Code 完成一個功能，就把那次的對話整理成開發紀錄。不是為了記錄而記錄，而是為了讓下一次的溝通更精準。

第一次整理的時候，發現自己平均每個需求要來回四到五次才能對齊。幾次回顧之後，慢慢學會了怎麼把需求一次說清楚、怎麼在截圖旁邊加上文字說明、怎麼把相關的調整合併在一起。

跟 AI 溝通就像跟任何人合作一樣——溝通品質決定產出品質。差別只在於，AI 不會主動告訴你「你上次也犯了同樣的錯」。所以你需要自己回頭看。

這個開發紀錄系統，就是我們回頭看的方式。

想看看實際的對話紀錄長什麼樣子？這是我們做電子書閱讀器功能時的完整對話：電子書閱讀 開發紀錄。

---

常見問題

開發紀錄的資料從哪裡來？

Claude Code 會自動把每次對話存在本機。我們寫了一個工具，把這些原始資料整理成結構化的格式，再產生成網頁。

Token 數量是精確的嗎？

是估算值。根據文字內容用演算法推算，中文和英文的計算方式不同。實際數字可能有 10-20% 的誤差，但用來比較不同對話之間的差異已經夠用了。

對話中的敏感資訊怎麼處理？

整理過程中會自動過濾檔案路徑、本機網址等敏感資訊。路徑會被縮短成只顯示檔名，不會洩露完整的目錄結構。

手機上也能看嗎？

可以。對話介面會自動適應螢幕寬度，右側的統計面板在手機上會收起來，點一下「對話統計」按鈕就能展開。

我可以把開發紀錄分享給別人嗎？

可以。每一筆紀錄都有獨立的網址，直接分享連結就好。文章裡嵌入的卡片也會連到完整的對話頁面。

對話太長的話會不會很慢？

不會。對話會分批載入，一次只顯示二十則。捲到底部時自動載入下一批，不用等全部對話一次跑完。

「初始需求」那段文字是原始訊息嗎？

不是。是根據整段對話的脈絡，重新整理成一段精煉的需求描述。目的是讓別人看到就能理解這次開發在做什麼，也可以直接拿去當 AI 的提示詞。

改善建議是 AI 自動產生的嗎？

是的。AI 會分析對話中的來回模式、需求描述的精確度、工具使用效率等面向，產出具體的改善建議。但最終的判斷還是要靠自己——AI 提供觀察，你決定要不要採納。