code-review-facilitator

Code Review Facilitator 是一款專為使用 Arduino、ESP32 與 RP2040 平台的嵌入式系統開發者所設計的專業工程工具。它如同自動化的導師，系統性地分析 C++ 韌體以確保程式碼的穩定性、記憶體效率與維護性。透過 scripts/analyze_code.py 工具進行靜態分析，此技能可識別常見的陷阱，例如堆積記憶體碎片、堆疊溢位、String 類別的不當使用以及阻塞式的 delay() 呼叫。適用對象涵蓋從建構原型的愛好者到完成生產級韌體的工程師。開發者可在需要程式邏輯回饋、於發布至 GitHub 前確保品質，或遇到不明原因的執行階段崩潰時使用此功能。該技能可解析專案目錄或單一檔案，並提供清晰、可執行的重構檢查清單——從將龐大的函數拆解為模組化任務，到實作非阻塞式狀態機與安全的緩衝區處理。它強調微控制器專屬的最佳實踐，例如 PROGMEM 的使用、消除幻數以及為 I2C、SPI 與感測器等硬體周邊實作健全的錯誤處理機制。

• 對 C++ 原始碼檔案執行靜態分析，偵測 15 種以上嵌入式程式設計常見問題。

• 支援單一檔案檢查與遞迴專案目錄掃描，以進行全面性審查。

• 提供關於記憶體安全的自動化指導，包括堆積/堆疊管理與防止緩衝區溢位。

• 為非阻塞式計時、按鍵去彈跳及模組化硬體抽象化建議重構路徑。

• 為改善專案結構與程式碼可讀性生成可操作的分類檢查清單。

• 提供互動模式，針對貼上的程式碼片段進行即時回饋。

• 使用 'uv run scripts/analyze_code.py [target]' 執行分析以取得即時診斷報告。

• 使用 --severity 旗標根據專案階段或嚴重程度過濾回饋。

• 遵循輸出中建議的重構模式來解決已識別的警告。

• 非常適合在開發物聯網感測器、機器人控制器與資料記錄器時使用。

• 與硬體偵錯互補；使用此工具在部署至生產板之前消除邏輯與安全性漏洞。