我把畫面修正寫回共用元件庫,再更新各網站的舊寫法
經驗 L2 600 字 2 分鐘 v2.0.0 更新 2026-11-16
共用元件庫 ui.zyx.tw,各網站從這裡安裝同一份元件檔案。我也把設計規範集中在同一份文件,包含只用灰階、限定字級與使用方角。讓 Claude Code 製作畫面前,我會先要求 Claude Code 讀設計規範。
修正畫面時,我會先改元件庫與設計規範,再請 Claude Code 掃過各個網站。修正要進入共用元件,也要換掉各網站的舊寫法。
同一份元件檔案,讓修正有共用的來源
這個做法成立的前提,是網站使用同一份元件檔案。同一專案的網站直接共用檔案,元件更新後便共用修正;其他專案從元件庫安裝檔案,需要從 ui.zyx.tw 重新安裝更新後的元件,才能取得修正。
例如,設計規範要求右上角使用文字。若只把某個頁面的圖示換成文字,新頁面仍可能使用圖示,因為共用元件與規範沒有一起更新。
新增網站使用修正後的元件,不能把元件庫已修改當成各處都已修好。下圖比較只改單一網站、修改元件庫與設計規範,以及加入自動檢查時,修正如何到達各網站、違規修改如何被擋下。
修正寫在哪裡?
修改的網站
- 畫面得到修正
其他網站
- 仍使用舊元件
逐站替換舊寫法,再攔下違規修改
容易重現的問題,我會寫成由程式判斷是否違規的 自動檢查。檢查放在修改合併前的 pull request 階段,未通過就不能合併,藉此攔下再次違反規範的修改。
檢查項目包含規範以外的顏色與字級、圓角,以及直接寫在元件上的樣式。
信件也遵守相同規範
同一產品的設計範圍也包含網站寄出的信件。我會讓信件遵守相同規範。
例外逐檔登記原因
需要例外的檔案,例如分享用的預覽圖,我會逐項登記,並寫明每項例外的原因。