漂亮不等於看得懂:用 C4 Model 建立理解路徑
AI 很會把文件變成漂亮的 HTML,但漂亮不等於看得懂。
我做 doc-to-html 時,借用了 C4 Model 的分層概念:先看系統全貌,再逐步深入組成、模組與程式碼。
我不是要完整套用 C4,而是讓 AI 在整理資訊之外,也建立一條理解複雜系統的路徑。
人理解複雜系統,通常不是從細節開始,而是 top-down:
- 先建立全貌,認識系統的邊界與外部環境;
- 再理解主要組成部分,以及它們之間的關係;
- 最後才深入特定模組與實作細節。
這不只是把內容「由簡到難」排列,而是讓理解有一條可以逐步深入的路徑。
這條路徑裡,每一層資訊都在回答不同層次的問題:
- 系統層:它為誰解決什麼問題?
- 組成層:有哪些主要部分?彼此如何協作?
- 模組層:某個部分內部怎麼運作?
- 實作層:具體邏輯如何落到程式碼?
先分清楚問題的層次,資訊才不會全部擠在同一個平面上。
因此,我把 C4 Model 的分層概念當成 AI 整理資訊的骨架,用它幫助 AI 判斷:
- 什麼應該先講
- 什麼細節應該後講
- 不同層級的資訊如何連接
- 讀者可以在哪一層繼續往下探索
對我來說,doc-to-html 的重點,是把散落在文件與程式碼裡的資訊,重新整理成一條人能理解的路徑:
先看見全貌,再逐層走進細節。
我把這套做法用在兩份不同類型的技術文件上:
產生這些 HTML 的 doc-to-html skill 也放在 GitHub。