---
site: "zyx.tw"
title: "我把畫面修正寫回共用元件庫，再更新各網站的舊寫法"
description: "共用修正需要更新元件，也需要替各網站換掉舊寫法。"
url: "https://www.zyx.tw/map/craft/one-design-system"
---

# 我把畫面修正寫回共用元件庫，再更新各網站的舊寫法

紀錄 033，經驗 L2，600 字，2 分鐘，v2.0.0，更新 2026-11-16

共用元件庫 ui.zyx.tw，各網站從這裡安裝同一份元件檔案。我也把設計規範集中在同一份文件，包含只用灰階、限定字級與使用方角。讓 Claude Code 製作畫面前，我會先要求 Claude Code 讀設計規範。

修正畫面時，我會先改元件庫與設計規範，再請 Claude Code 掃過各個網站。修正要進入共用元件，也要換掉各網站的舊寫法。

## 同一份元件檔案，讓修正有共用的來源

這個做法成立的前提，是網站使用同一份元件檔案。同一專案的網站直接共用檔案，元件更新後便共用修正；其他專案從元件庫安裝檔案，需要從 ui.zyx.tw 重新安裝更新後的元件，才能取得修正。

例如，設計規範要求右上角使用文字。若只把某個頁面的圖示換成文字，新頁面仍可能使用圖示，因為共用元件與規範沒有一起更新。

新增網站使用修正後的元件，不能把元件庫已修改當成各處都已修好。下圖比較只改單一網站、修改元件庫與設計規範，以及加入自動檢查時，修正如何到達各網站、違規修改如何被擋下。

**修正寫在哪裡？ 只改單一網站**

修改的網站:
- 畫面得到修正

其他網站:
- 仍使用舊元件

共用元件沒有更新。其他網站仍會使用舊元件。

**修正寫在哪裡？ 修改元件庫與設計規範**

使用共用元件的網站:
- 更新元件後取得修正

新增的網站:
- 使用修正後的元件

同一專案的網站共用修正。其他專案需更新元件。讓 Claude Code 製作畫面前先讀設計規範。

**修正寫在哪裡？ 加入自動檢查**

違反規範的修改:
- 檢查未通過，不能合併

檢查項目:
- 規範以外的顏色
- 規範以外的字級
- 圓角
- 直接寫在元件上的樣式

將容易重現的問題寫成檢查。讓檢查擋下違反規範的修改。

## 逐站替換舊寫法，再攔下違規修改

容易重現的問題，我會寫成由程式判斷是否違規的 自動檢查。檢查放在修改合併前的 pull request 階段，未通過就不能合併，藉此攔下再次違反規範的修改。

檢查項目包含規範以外的顏色與字級、圓角，以及直接寫在元件上的樣式。

## 信件也遵守相同規範

同一產品的設計範圍也包含網站寄出的信件。我會讓信件遵守相同規範。

## 例外逐檔登記原因

需要例外的檔案，例如分享用的預覽圖，我會逐項登記，並寫明每項例外的原因。

## 地圖

- 相關：[把能自動判斷的規則設成合併條件](https://www.zyx.tw/map/principles/rules-become-checks.md)
- 回到：[習慣](https://www.zyx.tw/map.md)
