摘要:这是我在 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 同步;部署另走既定流程。同步成功后,仍要确认正式网域实际提供的内容。
版本已保存、镜像已同步、网站已发布,需要各自确认。
对读者而言,不必照抄我的工具组合;更值得带走的是先约定交付范围,再选相应的检查与发布方式。
按下去以前,先知道自己允许了什么
这趟经验让我更看重三件事:范围先说清楚,来源当场核对,结果照标准验收。它们不保证不出错,却能让一次「完成」更容易被理解和检查。
这也延续了我对多模型协作与品味和判断力的想法:不是把所有执行交出去后就结束,而是把目的、权限与结果连起来。
下次确认框出现时,我仍想先问:这次究竟允许它动什么?


💬 留言讨论
加载中...