摘要:這是我在 2026 年六月把網站品牌 tokens 接進 Claude Design 的工作筆記。值得留下的,是同步範圍、權限與驗收的判斷;當時的介面、指令與方案不能當成今天的固定操作指南。匯入設計資料,也不等於每份產出都已符合品牌。
流程跑到一半,我盯著終端機的權限確認框,手指停在 Enter 上方。我只是要同步顏色、字體與間距,畫面卻提到一個看起來不相干的子目錄。
那一刻,我決定先停下來,讀它準備做什麼。
本文保留這次經驗,因為工具是否能執行,與我是否應該允許它執行,是不同的問題。這不是一次指令就能代替的判斷。
設計資料接進來,仍要核對產出
Claude 在 2026 年六月十七日的產品文章介紹設計系統匯入與 design-sync,說明如何把既有設計資料接入工作流。對我來說,吸引力是讓生成有更具體的依據,而不是每次只靠口頭描述品牌。
不過,讀進規格不是結果正確的保證。顏色有了依據,仍可能用錯場合;有字型資料,也不表示層級、間距與可讀性都合適。
匯入提供設計依據,成品仍需要逐項核對。
我想測的,就是這個連接在自己的網站上能做到哪裡。本文記錄的是那次工作的範圍,不是所有專案的相容性測試。
當時的入口,不能寫成永久的產品邊界
那次我選用 Claude Code 執行同步,另外使用設計工作區查看內容。這能說明我當時怎麼做,不能推出只有 Code 才能使用 Design,或 Chat 永遠不能參與。
本次修訂查看的官方入門文件,已說明可從對話、Artifacts 與 Claude Code 等入口使用 Design,也說明它與方案內其他使用共用用量。原文所說「有獨立的每週額度,不會影響 Chat 或 Code」不能繼續當成現行規則。
歷史操作與目前的產品說明,要分開閱讀。
這也不是對任何個別帳號的可用性承諾。真正開始之前,仍要看自己的方案、管理設定、工具版本與當下介面;不需要為了重現這篇經驗,就照著舊指令操作。
先決定要搬什麼,再看指令怎麼跑
我當時選擇只同步品牌 tokens,也就是顏色、字體與間距等底層規格,不搬完整元件。原筆記記錄了十個檔案與 validate 回傳 exit 0;這些是那次工作留下的結果,不代表這次修訂又重跑了一遍。
當時處理 Astro 專案時,我沒有把元件同步納入這次交付。因此我選了較小範圍。這不是 Claude Design 永遠不支援 Astro 的官方結論,也不能保證 tokens-only 就不會出錯。
同步範圍先說清楚,驗收才知道應該檢查什麼。
我還選擇開新專案,避免把這次網站專用的資料混入原本可能共用的設計系統。這是我在那次情境下的安排,不是所有人都必須採取的唯一做法。
至於原稿提到的 /update、/design-sync、tokens-only 選項與 .design-sync/,應當作當時工作筆記中的名稱;工具會變動,重做時需要另讀當下說明。
權限框要看完整動作與路徑
我當時把不相干的 worker 子目錄提示,追溯到工作目錄的選擇。這是那次排查的理解,不能保證所有相似提示都有相同原因。
真正能沿用的做法,是把授權範圍和眼前需求對起來:會讀哪些資料?會改哪些檔案?是否連外?授權只限這次,還是往後都有效?
指令名稱不能單獨證明它只讀不寫。
例如 sed 的行為取決於完整參數與組合方式;也不是只有出現 > 才可能寫入。沙盒能提供特定邊界,也不能單靠「在沙盒裡」就判定所有資料存取與動作都合適。
如果畫面上的範圍超過我理解的需求,我會先問清楚或縮小範圍。需要判斷的是實際動作,不是工具有沒有表現出自信。
讀檔,比雙方的記憶更可靠
同步過程中,我以為品牌資料在 src/,工具當時卻在 public/styles/ 找到來源。我把它留在文章裡,作為自己的記憶被修正的一次經驗,不是今天所有網站版本都應照搬的路徑。
重要的不是這次誰記得比較準,而是有沒有回到檔案核對。讀到檔案之後,也還要確認它是不是本次應使用的版本與來源,不能只因為它存在,就當成最終依據。
當場找到檔案之後,還要確認它的用途與版本。
同樣的原則也適用於發布方式。那次我曾以為推送程式碼就會自動部署,後來才回頭查專案規則。版控同步與網站正式上線,是兩個需要分別確認的結果。
exit 0,只回答它檢查過的問題
validate 回傳 exit 0,可以表示那項檢查按當時規則通過;它的意義取決於實際檢查內容,不能直接擴大成整個設計系統都正確。
我當時另外開了 Cowork,拿來源與同步後的內容比對顏色等項目。這是原筆記中的驗收安排;不是因為換一個視窗,就自然擁有獨立判斷。檢查者需要看得到原始資料、知道標準,也可能與執行者共享盲點。
第二雙眼睛的價值,在於重新核對證據與標準。
執行者的自檢仍有用;對重要交付,再加上未參與製作的角色複核,可以提供另一個檢查角度。我不再把「自己驗自己」說成完全沒有驗收。
而且,這次只比對 tokens,不表示所有生成畫面、元件、手機排版與可及性都已通過。驗收應該說明已經確認什麼,也說明尚未涵蓋什麼。
提交、同步與發布,各有終點
原筆記記錄了提交、鏡像對齊與沒有 force 的收尾。這些是當時的版控敘述,不能當作網站內容已上線的證據,更不應變成從任意工作目錄直接推 main 的教學。
依目前本站的共用規則,要進 main 的變更由主 checkout 整合,並在那裡使用 git sync 同步;部署另走既定流程。同步成功後,仍要確認正式網域實際提供的內容。
版本已保存、鏡像已同步、網站已發布,需要各自確認。
對讀者而言,不必照抄我的工具組合;更值得帶走的是先約定交付範圍,再選相應的檢查與發布方式。
按下去以前,先知道自己允許了什麼
這趟經驗讓我更看重三件事:範圍先說清楚,來源當場核對,結果照標準驗收。它們不保證不出錯,卻能讓一次「完成」更容易被理解和檢查。
這也延續了我對多模型協作與品味和判斷力的想法:不是把所有執行交出去後就結束,而是把目的、權限與結果連起來。
下次確認框出現時,我仍想先問:這次究竟允許它動什麼?


💬 留言討論
載入中...