JimLiu/baocut / skills/baocut/built-in-skills/design-system
design-system
Verified用户要建立或修改设计系统时用:品牌的颜色、文字样式、间距与圆角 tokens,给智能体看的品牌手册 README,bundle 与预览,标志、图标与字体。在工作目录写一个设计系统目录(design-system.json 加 tokens.json、README.md、components/、assets/、fonts/),可以从代码仓库或设计工具里的真实来源整理;图片、视频与 PDF 导入设计系统的素材库,校验通过后线程里出现设计系统卡片,用户在功能区预览与编辑;做好的设计系统可以装进设计稿。
| File | Kind | Size |
|---|---|---|
| .baocut-meta.json | config | 2.0 KB |
| SKILL.md | skill md | 16.4 KB |
| references/cover.md | markdown | 6.8 KB |
| references/craft.md | markdown | 8.6 KB |
| references/demo.json | config | 161.1 KB |
| references/format.md | markdown | 18.4 KB |
| references/from-code.md | markdown | 11.3 KB |
| references/from-design-tool.md | markdown | 16.0 KB |
| references/sample-seazar-tokens.json | config | 11.0 KB |
references/craft.md
View on GitHub# 写好设计系统:规则
SKILL.md 里有检查清单;这里是清单背后的规则。设计系统存在,是为了让后来的 agent 能在这个品牌的基础上构建——从品牌的**真实**来源(代码库、附带的文件、演示文稿、规范)来写它。
- **README 是写给使用它的 agent 看的用法规则**——页面把它显示成品牌手册。用祈使句,**点名** token、样式和素材(「正文用 `body`;`surface-100` 上用 `ink`;Clay 只用于 Claude 自己的声音」)。不写标题(页面会显示设计系统的名字),不写出处、构建笔记或「下一步」——这些写在你的回复里。篇幅随来源而定:只丢来几个文件的,写几条要点;真实的代码库或指南,值得分章节写,配上品牌自己的例子——content fundamentals(语气、大小写、用「我」还是「你」、用不用 emoji;引用真实的 copy)、visual foundations(颜色、字体排印、间距、图像、动效、state、边框、阴影、圆角、layout)、iconography(用哪套图标系统、格式、emoji 还是字形)。绝不注水。
- **素材是复制来的,绝不仿造。** 来源里没有标志 ⇒ 用普通文字排出名字,并注明没有标志;绝不凭记忆画出或复原一家真实公司的标志,绝不用用户没提供的 identity 给品牌改头换面。复制品牌自己的图标(图标字体、sprite、SVG);如果确实拿不到,换成最接近的替代品,并在 Iconography 下**标注**出来。
- **来源决定清单。** Token:来源里真实的名字和值,按它的顺序。组件:恰好是来源定义的那些 family——不加「常见」的额外组件(Toast、Avatar……),除非列在「Intentional additions」下并写明理由;只有从零开始或只有规范文字的品牌才配一套标准组件。先列出**完整**清单,对照它跟踪,全部构建;如果中途停下,确切报告还剩什么并询问——绝不在没做完的情况下悄悄结束。
- **值要精确,取自真实来源。** 来源胜过任何与它相像的组件库(shadcn、MUI……);内边距、圆角、尺寸和行高都照抄——5px 就是 5px,不要吸附到 grid 上。代码是事实,截图是有损的参考;预览是复刻,绝不另起炉灶。如果读取中途失败,说明你读了什么、没读什么——绝不编造名字、结构或值。
- **每个值只有一个来源。** 清理时,进了 `tokens.json` 的值要从预览加载的样式表里**删掉**,这样在页面上改的值才能胜出;页面不会用同一个 `--name` 声明的,保留。这等于重做样式表,别人写的样式表也不例外:先把它的旧版本整份挪到一边(见下文「挪到一边」)。页面只在有人保存时才写 `tokens.css`:设计系统自己没有 `tokens.css` 的,第一份由你来写,按 `format.md` 里「编译出的 tokens.css」那一条的样子排,第一行是 `/* <title> — generated from tokens.json */`(页面只接管第一条注释以这几个词结尾的文件)。如果设计系统的组件把自己包在一个声明了 tokens 的元素里,页面上的值就进不到里面:它们的值照样写进 `tokens.json`,什么都不删,并告诉用户在页面上编辑不会改变那些预览。
- **不留过时的 `manifest.json`。** 清理时**删除**旧的 `manifest.json`,绝不重写它:它列的是已经不存在的路径,而在有人保存一次编辑之前,页面不会写新的。
- **别人做的东西挪到一边。** 清理只删除设计系统顶层的旧 `manifest.json`、`migration-map.json` 和 `publish-progress.json`;在其他任何路径上叫这些名字的文件都是别人的。其他任何文件离开它的路径只能靠**移动**:**一次**改动,把文件写到一个空闲路径(那里没有文件,也没有别的文件写到那里),内容与你最后一次读到的完全一致(复制它,绝不重新敲一遍),并删除旧路径。原样去往 `format.md` 给它的位置的文件,就移到那里。本来你要删掉的文件(你拆分或重做的卡片,不论它在原处还是在去往它位置的途中;一个展示颜色、字体排印、间距或圆角 specimen 的 HTML 页面)要**挪到一边**,挪到 `archived/` + 它在设计系统里的路径。样式表也一样,在从中提取值之前整份挪开:**一次**改动把旧文件挪到一边,并在它的路径上写新文件。在 `README.md` 里修好路径,删掉迁移时在末尾追加的那一节(「## Migrated from …」),然后补充;其他内容一律不删、不改写。不要留下任何仍链接到你已清空路径的保留文件;迁移自己在 `assets/notes/`(或 `docs/`)下的笔记既不移动,也不改指向。
无法移动的文件(没有空闲路径;你的工具不能删除文件)留在原处:点名列出。`archived/` 里原有的东西绝不移动,也绝不提议删除。specimen 页面只有在它展示的每个颜色、尺寸和 `--name` 都已经以相同的值进了 `tokens.json` 之后,才挪到一边(在 specimen 页面里搜 `#`、`rgb`、`hsl`、`lch`、`lab`、`px`、`em`、`%` 和 `var(--`)。展示标志或图标的 HTML 页面不算 specimen 页面:把它重做成 `components/<Comp>/preview.html` 处的预览,然后像其他卡片一样把旧页面挪到一边。保留的文件仍链接着的文件绝不挪开,除非有新文件占用它的路径,或者那些链接已改指向。
- **每个 token 和素材都有用法说明**,写明它用在哪里(只用一种 ink 的 SVG,说明里要点名它的 ink——`<img>` 继承不了颜色)。
- **在每个 theme 里都清晰可读。** 文字颜色的用法说明要点名它所在的底色(「`surface` 和 `surface-raised` 上的正文」),每一对这样的组合在**每个** theme 里都至少达到 4.5:1 的 contrast(WCAG 2;24px+ 或 19px+ 粗体的文字,以及任何承载含义的边框、焦点环、图标或其他标记为 3:1)——要检查后面几个 theme 的值,不只是第一个 theme 的。组件预览和 `bundle.css` 画出来的东西也要达到同样的下限。你自己选的颜色(从零开始的品牌、预览自己的样式、焦点环)直接达标就行:把 accent 调亮的 dark theme,上面通常要用深色文字,所以给这样的填充色一个 `on-…` token,而不是写死白色;你选的焦点环要做成实色,在它落到的每个 surface 上都至少 3:1,并写在 visual foundations 下。真实来源里不达标的配对保持原样——在它的说明里讲明,而不是悄悄给品牌换色。
- **无障碍方面的要求有固定含义。** *high-contrast theme* 是一个**新增**的 theme,绝不是给品牌自己的 theme 换色:每种文字颜色在它的说明点名的底色上至少 7:1(24px+ 或 19px+ 粗体的文字为 4.5:1;WCAG AAA),surface 和控件靠达到 3:1 的边框区分开,而不是只靠 shade。*色盲安全的 status 颜色*:每种 status 还要带一个词或图标,成功和危险绝不能是只靠色相区分的一绿一红——要么两者之间的明度相差至少 3:1,要么成功色离开红绿轴、偏向蓝色(普通绿色旁边配一个橙色的危险色不算)。真实来源里不满足这一点的绿和红保持原样:安全的那一对放进品牌自己 theme 旁边的一个**新增** theme 里,就像 high-contrast theme 那样,并在它们的用法说明里写明哪个 theme 是安全的。没有需要保留的品牌色相 ⇒ 从 Okabe & Ito 的配色出发,用作文字的地方调暗。对这两者之一的*检查*,要在改动任何东西之前,按 theme 列出不达标的配对,每一对附一个修改建议。这是每种要求单独出现时的含义——用户的明确指示优先于这些定义,真实来源自己的颜色保持原样,如上所述。本 skill 的 `references/sample-seazar-tokens.json` 是这一切的 worked example(看它的 tokens)。
- **使用指南写明使用方要提供什么**(props、children、容器、数据),以及什么时候用它、该做和不该做的事。
- **填进真材实料:**每个 theme 凡与其他 theme 不同的地方都要填上,type scale 接到品牌真实的字体文件上,每个组件都有实时预览**和** README。
- **避免 AI 套路**,除非来源里真的有:蓝紫色渐变、拿 emoji 当装饰、带彩色左边框 accent 的圆角卡片、凑数的统计数字、用烂了的字体(Inter、Roboto……)。不要凑数的内容;有针对性的改动就保持有针对性;绝不为不在某家公司工作的人复刻这家公司的专有界面。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |