explaining-code

此技能作為開發者的智慧導師，將複雜或晦澀的程式碼轉換為易於理解的概念知識。它專為需要架起抽象邏輯與直觀理解之間橋樑的軟體工程師、學生及技術主管而設計。透過專注於「程式碼如何運作」而非僅僅是「它執行什麼」，此技能協助使用者進入新的儲存庫、排解舊系統故障或重構複雜模組。

本技能透過結構化的教學框架運作。它首先將技術實作與日常生活類比連結，讓使用者能將程式概念映射到現實世界現象。隨後，利用 ASCII 藝術圖表視覺化執行流程或結構關係，這對於理解呼叫階層、狀態轉換或元件依賴關係特別有用。接著提供詳細的逐步導覽，將思維模型映射到實際邏輯，最後透過強調常見的「陷阱」（Gotchas）——那些經常讓開發者掉入的誤區或反模式來總結。

• 生成直觀的比喻來解釋設計模式、演算法和複雜的資料結構。

• 建立基於 ASCII 的架構圖與流程圖，以便快速視覺化系統互動。

• 為複雜函式提供深入的逐行或逐區塊導覽。

• 識別程式碼庫中的常見陷阱、邊界案例與潛在配置錯誤。

• 使用對話式的語氣，使學習過程更具吸引力且易於理解。

• 在新成員入職或審查 Pull Request 時使用，以釐清實作細節。

• 非常適合記錄技術債，或透過解釋「如何做」背後的「為什麼」來證明架構變更的合理性。

• 輸入：儲存庫中的程式碼片段、檔案或特定邏輯路徑。輸出：包含圖表與技術見解的全面性多模態解釋。

• 限制：最適用於具有清晰邏輯流程的程式碼；對於高度混淆的程式碼，重點在於識別模式，而非強行使用過於簡單的類比。務必優先閱讀「陷阱」部分，以確保使用者避免常見的實作錯誤。