Communitygithub.com

本地设计系统

用于当交付物是视觉内容时:如HTML/CSS文件、Web交互、落地页、海报、报告或备忘录页面、仪表盘原型等。它仅把控风格和结构——交付方式由任务本身决定。

本地设计系统 是什么?

这个技能是针对视觉交付物(如HTML/CSS文件、Web交互、落地页、海报等)的设计规范。它确保输出的设计具有一致的品味和结构,而具体的交付方式(如通过Artifact工具、文件导出等)则交由主任务自行决定。该技能源自BaoCut和Anthropic的设计系统,但移除了对特定平台(如BaoCut-canvas)的依赖,假设用户直接编写原生HTML/CSS。其核心规则包括:在布局前先确定设计方向(通过提问或自行选择明确风格),然后为所有颜色、字体、间距定义CSS自定义属性(即在`:root`中声明令牌集),并严格禁止使用渐变背景、占位符内容(如Lorem Ipsum)或虚假的UI元素(如模拟手机状态栏)。此外,它强调以实际HTML元素构建界面(而非`div`加`role`),确保可访问性(对比度≥4.5:1),并对Landing Page和印刷品提供了精细化指导。当需要复现现有界面时,要求参考真实源代码而非凭记忆或截图,避免侵犯其他公司的专有设计。该技能适用于Claude Code等AI编码助手,帮助开发者在生成前端代码时遵循良好的设计原则。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/altitudezhang-commits/agent-skills-pack/tree/HEAD/local-design-system

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

页面、交互与 HTML/CSS 输出的设计规范

当交付物是视觉内容时——如 HTML/CSS 文件、Web 交互、落地页、海报、报告或备忘录页面、仪表盘原型,或任何用户会看的页面——请使用本技能。它仅把控品味与结构,交付方式(artifact 工具、文件、导出)由任务本身决定。

归属:以下规则改编自 BaoCut 内置的 design 和 design-system 技能,而这两项技能又源自 Anthropic 的 anthropic-design 技能(参见 references/brand-colors.md 中的来源说明)。BaoCut-canvas 机制(.dc.html、DCLogic、canvas.json、design_check、素材导入工具)已被有意去除;此处所有内容均假设你直接编写原生 HTML/CSS。在引用的参考资料中,请将“board/artboard”理解为你正在制作的页面或文件,将 <helmet> 理解为 <head>。

在布局前确定方向

  • 在发明任何东西之前先收集设计上下文:用户的品牌、现有的设计系统、页面将伴随的代码库或页面、他们提供的截图或文件。高保真度设计应源于该上下文;从零开始模拟整个产品是最后的手段,且效果通常很差。

  • 当指定了品牌或设计系统时,要精确匹配其颜色、字体、间距、圆角、字体族——并让这些设定覆盖本技能中的所有默认值。当用户提到某个品牌或产品名称时,请询问或获取其真实资产,而不是盲目设计。

  • 当无人能够回答且没有系统约束你时,选择一个明确的、有意图的美学方向(粗野极简、极繁主义、复古未来、编辑风格、野兽派、装饰艺术、柔和粉彩、工业风、奢华风、俏皮风……),用一句话说明你的假设,然后构建。永远不要以无人能回答的问题结尾,也永远不要每次都不知不觉地做成同一套外观。

  • 如果两个或更多决策会改变结果,并且有人可以回答,那么在开始制作前只问一次——最多 4 个问题,每个问题提供 2–4 个具体且明显不同的选项(你的推荐放在最前面),切勿进行模板式需求收集。否则,由你决定,说明你选择了什么,然后继续。

在构建前定义令牌集

  • 在编写布局之前,先写一个小型令牌集,并只使用这些值。将其放入文件顶部的 :root CSS 自定义属性块中(或页面加载的令牌文件中)——页面使用的每个颜色、尺寸和字体都追溯到此,每个值只有一个来源:
:root{
  --surface: #faf7f2;              /* 唯一色调基色 */
  --ink: #211d19;
  --accent: oklch(0.62 0.14 45);   /* 0–2 个强调色,oklch */
  --font-display: "Space Grotesk", "Avenir Next", sans-serif;
  --font-body: "Source Sans 3", system-ui, sans-serif;
  --space-1: 4px; --space-2: 8px; --space-3: 16px; --space-4: 24px; --space-5: 40px;
  --radius-sm: 6px; --radius-md: 10px;
}
  • 颜色:一个色调基色(暖色、冷色或中性色)。白色和黑色应带有轻微色调——纯白在作为全页背景时饱和度保持在 0.02 以下;切勿使用纯 #FFF。强调色:0–2 个,以 oklch 表示,具有相同的彩度和明度,仅色调不同。优先使用品牌/系统颜色;如果约束过紧,则从中导出和谐的 oklch 颜色,而非发明新色调。

  • 字体:1–3 个家族——一个独特的展示字体搭配一个精致的正文字体。每个 Web 字体都要有度量匹配的系统回退字体,因为回退字体在字体加载时以及任何无法嵌入的地方渲染。避免使用通用默认字体作为首选:不要用 Inter、Roboto、Arial 或 Fraunces。除非刻意追求效果,否则字符间距保持为 0。

  • 同样在同一个令牌定义过程中,固定一个小型字体比例(展示/标题/ heading /正文/小号/说明,含大小、字重、行高)、一个间距比例和一个圆角比例。实际来源中的确切值要精确复制——绝不四舍五入到 4/8px 网格。

反草率规则(硬性)

  • 没有大的渐变 wash 或渐变背景作为装饰,没有蓝紫色渐变,没有带彩色左边框的圆角卡片,没有用 emoji 作为图标或 UI 符号(图标应为内联 stroke SVG 或真正的图标集;emoji 仅当其真正属于品牌时才出现)。

  • 没有填充内容:没有 Lorem Ipsum,没有虚构的统计数据、推荐语或“数据填充”来填满空间。每个元素都必须有其存在的理由;感觉空荡的区域是布局问题,而不是内容发明提示。缺失的事实应被标记为可见的占位符,如 [YOUR PRICE]。

  • 没有虚假的 chrome:绝不在设备样机中绘制虚假的手机状态栏或键盘。

  • 执行程度要与方向匹配:极繁主义设计使用丰富效果;极简设计在间距和细节上体现克制和精度。用强烈的强调色搭配主色调,胜过均匀微弱分布的颜色;不对称、重叠、充足的留白或受控的密度,胜过默认的居中网格。

布局机制

  • 用 flex 或 grid 配合 gap 排列兄弟元素组(按钮、chip、卡片、导航项、工具栏)——绝对不要依靠空白文本节点或兄弟元素之间的每外边距。内联流仅用于包含偶尔 <a>/<strong> 的散文内容,不用于排列 UI 元素。

  • 页面是流动的:根元素不使用 px 宽度,使用 max-width 容器并添加侧内边距,采用 %/rem/fr 尺寸,网格写为 repeat(auto-fit, minmax(min(<min>px, 100%), 1fr)),以便在手机上折叠为单列而不是溢出。vh 仅用于真正填满屏幕的根元素;其余段落使用 px/rem min-height。偏好稍高而非被截断。

  • 固定尺寸的根元素仅用于固定格式:设备样机、海报、社交图片、印刷品。手机应用屏幕为 390×844;页面设计需在手机宽度下正常工作——标题不能出现尴尬的换行,网格不能挤压,文字不能缩小至难以阅读。

  • 交付页面中的图表是普通的行内 SVG(放在 <figure> 中即可);保持标签和标注为真实文本,以便他人可能需要进行编辑。

可访问性是画进去的,而不是事后检查

  • 即使在静态样机中也要使用真实元素:<button>、<a href>、<input> 配合 <label>。绝不要用 div/span 加上 role 或 onClick 作为替代——键盘会跳过它们,屏幕阅读器也无法获取信息。仅图标按钮要添加 aria-label;装饰性 SVG 使用 aria-hidden="true",有意义的 SVG 使用 role="img" 并带有标签。

  • 文字对比度至少为 4.5:1(24px 及以上的文字为 3:1)。常见的失败是灰色标注文字和彩色背景上的白色文字——将两者调暗直至通过。

  • 需要区分的颜色还必须在明度上有所差异,而不仅仅是色调;优先使用蓝/橙而非红/绿。

  • 点击目标至少 44px。印刷正文至少 12pt。

内容与编辑规范

  • 添加内容前先询问:如果额外章节、页面或文案能提升作品,请先询问,而不是未经许可就添加。

  • 一个小型、有针对性的变更只改动那一处:其他所有的布局值、间距、字体、尺寸、位置、颜色和内容都保持原样。先执行请求的更改,然后如果需要更大的改动,仅作建议,不要未经请求就执行。要求重新设计或重头开始则不同——那时才进行大改。

  • 在扩展现有页面或文档时,先阅读其视觉语言——复制样式、调色板、语气、悬停状态、阴影和卡片模式、密度——并用其继续编写。

  • 当被要求复现某个你可获取源码的界面时,依据真实源码工作:读取组件和样式,复制实际素材,复制确切值。在有源码存在时,绝不可凭记忆或截图复现。不要为不属于该公司的人复现其独特的专有设计;应提供针对其实际目标的原创设计。

落地页与印刷

  • 落地页:一个 hero 区域,用一句话说明提供什么,并附带一个明确的行动号召;让访问者信任的证据(推荐语、标志、数字——他们的,或带有明显标记的占位符);解决真正异议的好处部分,而非列举功能。每页一个主要行动,随着页面下滚重复。文案即产品:具体、根植于用户实际销售的内容,绝非可互换的营销模板。

  • 印刷品(海报、传单、手册、备忘录、报告、任何导出为 PDF 的内容):在开始前阅读 references/print.md——首先决定是固定页面还是流动文档,使用真实纸张尺寸(Letter 816×1056,A4 794×1123 CSS px),≥40px 安全边距,≥1px 规则,灰色文字不低于 #767676,传单层级结构需在整个房间内三秒可读。

Anthropic 品牌工作

  • 对于带有 Anthropic/Claude 品牌的作品:基色 Ivory #FAF9F5,文字 Slate #141413,强调色 Clay #D97757,衬线展示字体搭配无衬线正文。完整的暖灰色阶、辅助调色板和标志规则在 references/brand-colors.md 中;字体堆叠和字体比例在 references/brand-typography.md 中。奶油基底 + 衬线标题 + 陶土色的惯例仅用于 Anthropic 品牌作品或当简报要求时——非默认选项。

参考资料

  • references/craft.md — 这些规则背后的完整推理:与用户一起确定方向、变体与线框图轮次、落地页结构、从源码复现界面以及共享内容规则。当设计决策有争议或作品需要深度时阅读。

  • references/brand-colors.md — Anthropic 品牌颜色系统(暖灰色、Claude 调色板、数据可视化比例)及其来源说明。

  • references/brand-typography.md — Anthropic 品牌字体堆叠(含度量匹配的回退字体)和品牌字体比例。

  • references/print.md — 印刷工艺:固定页 vs 流动页、纸张尺寸和单位、边距、表格、传单规则。

相关技能