ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

用 Claude Design 的 create-design-system 技能搭建品牌设计系统:目录契约、token 管线与 UI Kit 全流程指南

2026/9/8 21:56:07 拓冰建站 浏览量
用 Claude Design 的 create-design-system 技能搭建品牌设计系统:目录契约、token 管线与 UI Kit 全流程指南 用 Claude Design 的 create-design-system 技能搭建品牌设计系统目录契约、token 管线与 UI Kit 全流程指南【免费下载链接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.项目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaks本指南基于 create-design-system SKILL.md 展开它定义了 Claude Design 环境中把一份公司资产转化为可编译、可索引的品牌设计系统的完整操作规范从目录布局、styles.css全局入口、组件/token/字体的识别规则到 foundation 卡片、Starting Points、UI Kit 的逐文件约定。读完你既能按规范亲手产出遵循该契约的设计系统工程也能理解自动化编译器如何不依赖文件夹名、仅凭文件内容与同级关系完成打包与索引。一、什么是设计系统一份由编译器读懂的目录契约技能文档首先给定了概念边界Design systems are folders on the file system—— 在 Claude Design 中设计系统不是一个 Figma 文档或一份规范 PDF而是一组落在文件系统中的目录其中包含字体排印指南、颜色、素材、品牌风格与语气指南、CSS 样式以及 UI、幻灯片等内容的 React 还原实现。它的价值在于让设计 Agent 可以对着公司既有产品做设计并用公司的品牌去生产素材。一份合格的设计系统工程应当包含四个层次的内容真实视觉素材logos、品牌插画等底层视觉基础字体排印细则、色彩系统、阴影、边框、间距系统等可复用 UI 组件高层级 UI Kit完整屏幕级还原。该技能在 Claude Design 内置 19 个技能列表中对应条目为Create design system见 skills/README.md其定位是用户要求创建设计系统或 UI kit 时调用。技能的 frontmatter 中user-invocable: true表明它可从斜杠菜单直接唤起而文档内有一句直接说明No need to invoke the create_design_system skill; this is it—— 当流程进行到创建设计系统时本技能文件就是唯一所需的执行指令不要再递归调用自身。1.1 编译器视角唯一固定位置是styles.css理解这套规范的关键在于它的消费端一个自动化编译器会读取整个项目把组件打包进运行时库并索引样式。文档强调编译器发现内容的方式是从文件内容与同级关系推断而不是依赖文件夹名——因此整个布局几乎可以自由发挥唯一固定的是全局 CSS 入口styles.css位于项目根或按index.css/globals.css/global.css/main.css/theme.css/tokens.css顺序取第一个命中的文件。该入口是面向消费者的唯一链接文件因此对它有一条硬约束文件内容只能是import行列表不要内联任何规则。其传递闭包所有被它import到的文件会整体随包发给消费者闭包中任意位置的font-face规则则声明网页字体。1.2 推荐目录布局可替换的默认方案除根级styles.css外其余结构均可按品牌习惯调整。文档给出的合理默认布局如下tokens/—— CSS 自定义属性按关注点一个文件colors.css、typography.css、spacing.css等每个都由styles.cssimportcomponents/group/—— 可复用的 React UI 基础组件ui_kits/product/—— 对真实产品界面的全屏可点击还原guidelines/—— 基础样例卡片specimen cards与深度说明文字assets/—— logos、图标、插画、图片素材readme.md根级—— 设计指南与清单manifest。文档原文提示除非所附代码库或品牌已有自己的惯例否则就用这套默认布局。二、编译器识别三要素组件、token、字体的判定规则无论文件放在哪个目录编译器只认三类由内容 同级关系定义的东西这构成了所有后续编写动作的事实依据要素识别规则备注组件component任意Name.jsx/Name.tsxPascalCase 词干且同目录存在同名Name.d.ts旁边可再放Name.prompt.md每个目录一个带dsCard标记的.html首行为!-- dsCard group… --token在:root或单选择器主题作用域下声明的任意--*自定义属性前提是所在文件可从styles.css的导入闭包内到达字体font同一闭包内的任意font-face规则其src: url(…)指向的二进制文件即随包发给消费者的字体文件注意组件判定中.jsx/.tsx需要PascalCase 词干且必须与.d.ts同级token 与字体都必须处于styles.css可达的导入闭包中——这是后续所有 CSS 都要被根文件 import 的原因。三、创建设计系统的标准执行清单技能要求在执行开始时先建立含下列任务的 todo list然后逐项跟进。以下流程即文档定义的标准工序。3.1 探索素材与产品语境读取所有提供的资产代码库、Figma 链接/文件等获得公司/产品语境的高层理解识别涵盖的各个产品、收集产品文案product copy、审阅核心界面寻找任何已有的设计系统定义。每个素材都要真正读一遍弄清它做什么。3.2 编写根readme.md与设置项目标题在根目录创建readme.md记录公司/产品语境的高层理解并明确列出用户给过的来源完整 Figma 链接、GitHub 仓库、代码库路径等——不要假设读者能访问这些来源但保留下来以备其确有访问权时使用。随后调用set_project_title用一个从品牌/产品衍生的短名称例如 Acme Design System替换通用占位标题让项目可被检索到。3.3 处理演示文稿与字体资源若附带了幻灯片 deck用 repl 工具逐个查看抽取关键素材与文字并写入磁盘若缺少字体文件到 Google Fonts 寻找最近似的替代字体将这一替换明确告知用户并请其提供正式字体文件。3.4 编写 token CSS 与根styles.css探索代码库和/或 Figma 设计上下文后编写 token 文件——在:root上声明 CSS 自定义属性既包括基础值base values如--fg-1、--font-serif-display也包括语义别名semantic aliases如--text-body、--surface-card。将 webfonts/ttf 拷入项目并在某 CSS 文件中编写对应font-face规则。最后编写根styles.css——它只是import行列表绝不内联规则且必须覆盖到每一个 token 与 font-face 文件。3.5readme.md的 CONTENT FUNDAMENTALS 与 VISUAL FOUNDATIONS在探索基础上持续充实根readme.mdCONTENT FUNDAMENTALS内容基要文案怎么写语气、大小写风格如何用 I 还是 you是否使用 emoji整体 vibe 如何需给出具体示例。VISUAL FOUNDATIONS视觉基要覆盖品牌的视觉母题与基础文档要求尽量回答以下所有问题颜色、字体、间距、背景纯图full-bleed手绘插画重复纹理/图案渐变动画缓动曲线淡入淡出弹跳无动画hover 态透明度变化、颜色加深/变浅press 态变色收缩边框、内/外阴影体系、protection gradient 与胶囊capsule形态的对立、布局规则固定元素透明度与模糊的使用时机图质的色彩氛围暖冷黑白颗粒圆角半径卡片长什么样阴影、圆角、边框。3.6 Foundation specimen 卡片与dsCard标记在推进过程中创建基础样例卡片小型 HTML 文件它们将填充Design System 标签页。约束如下单卡目标约700×150 px上限 400px——宁多小块不要少而密在子概念粒度上拆分primary / neutral / semantic 色分别成卡display / body / mono 字体分别成卡spacing token 与间距实际应用示例分开成卡一组典型 foundations 约12–20 张卡卡片不写标题与外框装饰——卡片名会渲染在卡片外部直接展示色板/样例/token装饰从简每张卡都要以相对路径链接styles.css从而吃到真实 token每张卡首行必须带卡片标记!-- dsCard groupGroup viewport700xheight subtitleone line nameCard name --。Design System 标签页会渲染项目内所有带dsCard标记的.html并按group原样分组展示。建议的 group 命名Type、Colors、Spacing、Brand——统一使用 Title Case 并保持一致。3.7 素材Assets与图标规范绝不臆造 logo把 logos、图标等视觉素材拷入assets/。文档给出了几条容易被忽视的红线如果来源里没有 logo就不要自造一个任何需要放置品牌标识的位置用纯文本渲染品牌名即可并在readme.md中注明缺失绝不凭记忆绘制、重构或近似公司的真实 logo/品牌标识——哪怕能从字体名或示例内容推断出公司身份也不行也绝不用用户没有提供的公司身份去重新品牌化这个设计系统在readme.md增补ICONOGRAPHY图标学章节回答是否使用特定图标系统是否有内置 icon font常用的是 SVG 还是 png 图标若是拷进来是否使用 emoji是否用 unicode 字符当图标务必把关键 logos、背景图、1–2 张全幅通用图片以及所有通用插画拷入自己手绘 SVG 或生成图片一律禁止图标能程序化复制就复制。图标素材的取舍顺序为① 优先复制代码库自带的 icon font / sprite / SVG 进assets/② 若图标集可从 CDN 获取如 Lucide、Heroicons从 CDN 引用③ 两者都不行时替换最接近的 CDN 图标集相同描边粗细/填充风格并标记FLAG这一替换。所有用法记录在 ICONOGRAPHY 中。3.8 编写组件、UI Kit 与幻灯片之后按文档要求依次编写可复用组件见下文组件规范、为每个产品创建 UI Kit、若给定幻灯片模板则创建样例幻灯片并给相应 HTML 打上卡片标记。最后在根readme.md中补充一个简短index作为根目录的 manifest列出可用文件、组件、UI kit 等的清单。3.9 收尾生成 SKILL.md 并明确迭代诉求流程的终点是生成一个 SKILL.md 文件模板见下文第六节使整套成果可下载到 Claude Code 中复用。收尾时不要对产出做总结陈词——只需说明 CAVEATS未能完成或不确定的事项并以**清晰、加粗的请求ASK**请用户帮助迭代让成果趋于完美。文档还提醒用户需要在 Share 菜单中把文件类型设为Design System组织中其他成员才能查看该设计系统。四、组件Components编写规范组件是品牌的可复用 UI 基础。技能对该建哪些组件给出了非常具体的原则核心是让来源定义清单而不是让惯例定义清单。4.1 组件清单从何而来当具体来源定义了清单时已挂载的 .fig 文件、Figma 链接、所附代码库中的组件库该清单就是组件列表——只建来源定义的那些家族不多不少不要添加设计系统通常都有的原语Toast、Avatar、Tabs 等除非来源里真定义了它们——一个来源里不存在对应物的组件会被消费者信任、却被设计师否认若确有必要新增例如为字形集做的 Icon 包装器需在readme.md的 Intentional additions 下列出并附一行理由仅当没有来源定义组件仅有品牌指引或从零开始时才编写标准组件集Button、IconButton、Input、Select、Checkbox、Radio、Switch、Card、Badge、Tag、Tabs、Dialog、Toast、Tooltip尺寸贴合品牌需求组件按关注点分组forms/、feedback/、navigation/放在任意父目录下小组件集也可只用一个core/组。4.2 先枚举、再全建动手前先把来源的完整组件清单列出来对已挂载的 .fig读取/METADATA.md的 Component families 章节对 Figma 链接用get_design_context列出文件页面与组件。把每个家族都放进 todo list全部建完并对照清单追踪进度不要止步于一个核心子集。若确实无法完成必须在本轮结束时精确报告哪些家族尚未建成并询问用户是否继续——绝不能静默地半途而废。4.3 单个组件的文件形态每个组件是一个文件Name.jsx或.tsx导出export function Name(props) {…}——命名导出、PascalCase该导出名即公共 API且字面意义上的export关键字必不可少因为打包器靠它识别。组件须自包含只import React样式一律引用 CSS 自定义属性不引 CSS-in-JS 库、不引 npm 包同级文件之间可用相对路径互相导入。在同目录下还需编写两份伴随文件Name.d.ts—— 提供 props 接口。同级.d.ts才赋予组件 props 契约、遵循规则与成为 starting point 的资格没有它的.jsx虽仍会被打包导出到命名空间下但拿不到上述任何能力Name.prompt.md—— 首行为一句话的 what when随后附一个小型 JSX 用法示例再列出值得注意的变体/props。4.4 组件卡片 HTML 与运行时挂载每个目录一张卡片 HTML命名随意如buttons.card.html其规范如下首行!-- dsCard groupComponents viewport700xheight nameDirectory label --用正确的相对路径链接styles.css通过script src…/_ds_bundle.js相对项目根的路径加载打包产物在script typetext/babel块中用const { Name } window.Namespace挂载组件——调用check_design_system可拿到确切的Namespace禁止直接script src那个.jsx其export无法被内联脚本访问卡片要展示关键状态/变体primary/secondary/ghost、不同尺寸、disabled、带图标等做到密集可扫读而不是单一默认渲染。4.5 生成文件勿手写_ds_bundle.js、_ds_manifest.json、_adherence.oxlintrc.json以及 barrel 文件index.js都由编译器自动生成禁止手工编写。这与主系统提示词中的消费方式相互印证设计组件DC在helmet中加载设计系统 bundle按 URL 去重后即可用x-import component-from-global-scopeNamespace.Component挂载其中的组件见 claude-design.md这也解释了为何组件必须走命名空间 打包产物的路线。五、Starting Points让组件与屏幕成为新设计的种子消费型项目会显示一个 Starting Points 选择器允许用户用本系统的组件或屏幕来播种一个新设计。该能力是**通过标记选择加入opt-in**的与填充 Design System 标签页的dsCard是两套互不相干的标记。标记一个组件在其Name.d.ts的 props 接口 JSDoc 上添加startingPoint sectiongroup subtitleone line viewportWxH。选择器的缩略图即该目录下带dsCard标记的 HTML——因此要保证它在声明的 viewport 下渲染合理标记一个屏幕在 HTML 文件首行添加!-- startingPoint sectiongroup subtitleone line viewportWxH --缩略图就是屏幕本身当用户说create a starting pointX或把X加为 starting point写一个以!-- startingPoint section… --注释为首行的 HTML 文件即可——项目中任何带该标记的.html都会被索引。ui_kits/x/index.html是惯例位置但并非强制当用户要求移除或重命名 starting point编辑对应标记要求改缩略图时组件改其目录中dsCard标记的 HTML屏幕则直接改该屏幕 HTML。六、UI Kit完整界面还原而非组件陈列UI Kit 是对完整界面的高保真视觉与交互还原——它们是屏幕不是原语。要点如下功能可以偷工减料不是真生产代码但视觉必须像素级精确能读原始 UI 代码就读代码或用 Figma 的get-design-contextUI Kit复用前面写好的组件原语——不要在 kit 里重新实现一个 Button每个 UI kit 的index.html要看起来像该产品的一个典型视图——这是还原recreations不是 storybook。为每个产品建立的执行步骤每项都进 todo list探索代码库 Figma 中的组件design context与代码为每个产品创建 3–5 个核心屏幕首页/App 主界面等带可点击交互串联对照设计上下文做 1–2 轮视觉迭代。其余硬性约定先判断该公司的核心产品有哪些可能只有一个也可能有移动 App、营销官网、文档站等多个每个 kit 内含针对该产品各界面侧边栏、编辑器、文件面板、hero、页头、页脚、博客文章、视频播放器、设置页、登录页等的 JSX要求结构良好、小而整洁index.html演示该 UI 的可交互版本例如聊天 App 应让你看到登录页、创建聊天、发消息——当然是模拟的视觉必须用 design context 或代码库导入做到准确还原但不必照抄组件实现做主要为外观的简化版——文档特别强调copy 很重要Its important to copy。覆盖面要求来源定义的每一个组件家族都要覆盖到——这里的覆盖指完整枚举清单而非挑挑拣拣的子集。UI Kit 屏幕内可以缩写重复内容如用 3 行代表 30 行相同列表但绝不能跳过任何一个组件家族。同时不要为 UI Kit 发明新设计——它的职责是复刻既有设计而非创造新设计若项目里没有看到某元素就省略或有意留空并附免责声明。若给定幻灯片模板则为其创建样例幻灯片——{index.html, TitleSlide.jsx, ComparisonSlide.jsx, BigQuoteSlide.jsx, …}放在各自目录中没给模板就不做。每个幻灯片类型一个 HTML 文件有 deck 就照搬其风格套用视觉基础并带入 logos 等素材。每张幻灯片 HTML 首行标记!-- dsCard groupSlides viewport1280x720 --让 16:9 画面缩放适配卡片。同理每个 UI kit 的index.html也要标记!-- dsCard groupProduct viewportdesign widthxabove-fold height --——声明的高度决定预览截断点因此选择最值得预览的段落。七、执行原则与中止规则Guidance技能在结尾给出整套运行守则其中多条直接决定了产出质量独立运行、不要随意停顿除非遇到关键阻塞例如无法访问粘贴的 Figma 链接、无法访问代码库制作幻灯片与 UI Kit 时不要在图标上偷工减料把图标素材拷进来不要用手搓 SVG、emoji 之类做图标的半吊子还原关键红线除非别无选择不要仅凭截图还原 UI应以代码库或 Figma 的get-design-context作为事实来源——截图的信息损失远大于代码截图只能当高层指引能找代码里的组件就一定要找所附 kit 是事实标准ground truth当它的取值与某相似公共组件库shadcn、MUI 等的公开惯例冲突时kit 胜出。从来源复制精确数值padding、圆角、字号、行高绝不四舍五入或吸附到 4/8px 网格或框架默认值——kit 说 5px 就写 5px不写 4px除非确定在代码库或 Figma 中见过否则避免这些视觉母题蓝紫渐变、emoji 卡片、只带彩色左边框的圆角卡片不要读取 SVG浪费上下文若知道其用途直接复制再引用即可使用 Figma 时用get-design-context理解设计系统与所用组件截图仅用于高层指引记得展开变量与子组件get_variable_defs以取得其内容资源不可及就停下只要提到了代码库却无法通过local_ls等访问就必须停下请用户用 Import 菜单重新附加这类资源经常被重新附加中途断连也不要硬做完设计系统Figma URL 不可访问同样停下请用户解决。绝不在拿不全资源时花大量时间硬做。中途失败同样适用一旦读取开始失败或遇到限流停下来精确汇报读了什么、没读什么——绝不臆测或编造未读内容的组件名、结构或取值。八、产出跨端可用的 SKILL.md整个设计系统工程在完成前需要生成一个 SKILL.md使其与Agent Skills规范交叉兼容——这样用户下载后可在 Claude Code 中直接使用。技能给出了标准模板skill-md --- name: {brand}-design description: Use this skill to generate well-branded interfaces and assets for {brand}, either for production or throwaway prototypes/mocks/etc. Contains essential design guidelines, colors, type, fonts, assets, and UI kit components for protoyping. user-invocable: true --- Read the README.md file within this skill, and explore the other available files. If creating visual artifacts (slides, mocks, throwaway prototypes, etc), copy assets out and create static HTML files for the user to view. If working on production code, you can copy assets and read the rules here to become an expert in designing with this brand. If the user invokes this skill without any other guidance, ask them what they want to build or design, ask some questions, and act as an expert designer who outputs HTML artifacts _or_ production code, depending on the need. /skill-md该模板的 frontmatter 只含name、description、user-invocable三键与仓库内其他 Agent Skill 文件的 frontmatter schema 一致见 Anthropic/claude-design/skills/README.md 对技能 schema 的说明。name处的{brand}应替换为实际品牌名如acme-design。此外还应提醒用户把文件类型设为Design System在 Share 菜单中组织内其他人方可查看该设计系统。九、在 Claude Design 技能生态中的位置该技能并非孤立存在而是与仓库内其他技能互为上下游作为产出端它生成的设计系统项目会被编译器打包、在 Design System 标签页与 Starting Points 选择器中呈现成为后续所有设计工作的绑定设计系统binding design system作为消费端hi-fi-design SKILL.md 规定正式设计开始前要找到现有 UI Kit、收集设计上下文、复制相关组件好的高保真设计不以空白起步——其理想素材正是 create-design-system 产出的设计系统与 UI Kit作为跨端桥梁结尾生成的 SKILL.md 模板用于把设计系统下载到 Claude Code 中继续做品牌化开发配合 handoff-to-claude-code SKILL.md 可将还原型 HTML 设计转译为生产代码实现文档作为宿主环境主提示词 claude-design.md 定义了整个工作环境的交互规则以 HTML 为工具、以文件系统项目为载体、用 todo list 管理多步工作等create-design-system 正是在这一宿主内被斜杠菜单调用的内置技能之一其技能列表第 247 行即本技能条目。十、结语设计系统即工程产物综上create-design-system 给出的是一套设计系统 可编译目录工程的方法论styles.css只做 import 转述token 收敛于:root组件以jsx d.ts prompt.md 卡片 HTML四件套定型屏幕与幻灯片用dsCard声明尺寸与分组起始组件/屏幕用startingPoint声明种子入口而品牌真实性不臆造 logo、不替换数值、截图只能当指引则靠贯穿全程的原则守住了底线。若你在自己团队中想让设计资产真正被 Agent 与设计工具自动消费这套目录契约与标记协议就是一份可直接照搬的参考实现——原文档全文见 Anthropic/claude-design/skills/create-design-system/SKILL.md。【免费下载链接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.项目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaks创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考