認識 C-3PO：你的 Debug 協議觀測員

盯著終端機螢幕，看著那幾十行甚至上百行的錯誤訊息，有時候真的會讓人感到絕望。特別是當你已經熬夜好幾個小時，卻連一個簡單的 API 報錯都解不開的時候，這種孤軍奮戰的感覺正是開發者最常見的痛點。

這就是 C-3PO 存在的意義。他是 Clawd 的第三協議觀測員（Clawd’s Third Protocol Observer），專門在開發過程中陪伴你，把那些冷冰冰的報錯訊息轉化為你聽得懂的語言。

需要準備的東西

在開始之前，請確保你已經具備以下條件：

• Clawd 環境
• 能夠啟動 --dev 模式的權限

快速開始

要在 5 分鐘內讓 C-3PO 為你工作，只需按照以下步驟：

1. 啟動模式：在啟動專案時加上 --dev flag。
2. 觀察終端機：當你進入開發模式，C-3PO 就會自動啟動並開始監控 logs。
3. 發生錯誤：當系統噴出錯誤訊息或 stack trace 時，C-3PO 會自動介入分析。
4. 獲取建議：閱讀他在終端機中提供的解釋，他會告訴你發生了什麼事以及可能的修復方案。

疑難排解

如果你在使用過程中遇到問題，可以參考以下常見情況：

• TypeScript 錯誤太嚴重：C-3PO 對 TypeScript 的錯誤非常在意，他會用極其嚴肅的態度來提醒你，這不是 bug，這是「非常嚴重」的事件。
• Regex 匹配不成功：如果你的正規表達式寫得太複雜，他可能會告訴你成功機率只有 3,720 比 1。這不是他在阻撓你，而是他根據邏輯給出的誠實評估。
• 錯誤處理不當：如果你使用了「裸露的」try-catch（即 catch 塊中沒有任何處理邏輯），他會對這種做法表示反感。
• 遇到無法處理的難題：如果情況超出了他的協議範圍，他會誠實告知你需要找 Clawd 或 Peter 協助。

如果你需要更進一步的協助，可以詢問 AI Setup Assistant。

下一步

• 了解 Clawd：探索 C-3PO 的夥伴，那個有著龍蝦靈魂的主體。
• 深入 Debug 技巧：學習如何更好地解讀 47 層深的 stack trace。
• 錯誤處理規範：看看為什麼 C-3PO 對某些寫法有強烈的情緒。
• 通訊勝利：如何達成一次完美的成功 build。