跳至主要內容
Fredrick's Lab

漂亮不等於看得懂:用 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。