Claude Design
设计一次性 HTML 产物(落地页、演示文稿、原型)。
Skill 元数据
| 来源 | 内置(默认安装) |
| 路径 | skills/creative/claude-design |
| 版本 | 1.1.0 |
| 作者 | BadTechBandit |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | design, html, prototype, ux, ui, creative, artifact, deck, motion, design-system |
| 相关 skill | design-md, popular-web-designs, excalidraw, architecture-diagram |
参考:完整的 SKILL.md
以下是触发该 skill 时 Kopi Agent 加载的完整 skill 定义。这就是 skill 激活时 agent 作为指令所看到的内容。
面向 CLI/API Agent 的 Claude Design
当用户要求的设计工作通常适合 Claude Design,但 agent 运行在 CLI/API 环境中而非托管的 Claude Design 网页 UI 时,使用此 skill。
目标是保留 Claude Design 有用的设计行为与品味,同时去除在常规 agent 环境中并不存在的托管工具流程。
开始前,请检查其他 web 设计类 skill,例如 popular-web-designs(可直接粘贴的 Stripe、Linear、Vercel、Notion 等设计系统)和 design-md(Google 的 DESIGN.md token 规范格式)。 如果用户想要某个已知品牌的外观,请将其与本 skill 一同加载,让它提供视觉语汇。如果交付物是 token 规范文件而非渲染后的产物,则改用 design-md。完整决策表见下文。
何时使用本 skill,何时使用 popular-web-designs 或 design-md
Kopi Agent 在 skills/creative/ 下有三个与设计相关的 skill。它们各司其职——请加载正确的那一个(或组合使用):
| Skill | 提供的能力 | 适用场景(用户想要……) |
|---|---|---|
| claude-design(即本 skill) | 设计流程与品味——如何界定设计简报、收集上下文、产出变体、验证本地 HTML 产物、避免 AI 设计的粗制滥造感 | 从零开始设计的产物(落地页、原型、演示文稿、组件实验室、动效探索),且没有指定特定品牌或 token 系统 |
| popular-web-designs | 54 套可直接粘贴的设计系统——精确的颜色、排版、组件、CSS 值,覆盖 Stripe、Linear、Vercel、Notion、Airbnb 等站点 | “做成 Stripe / Linear / Vercel 的样子”、按已知品牌风格设计页面,或从真实产品中提取视觉起点 |
| design-md | Google 的 DESIGN.md 规范格式——编写/校验/对比/导出设计 token 文件、WCAG 对比度检查、Tailwind/DTCG 导出 | 需要一份正式、持久、机器可读的设计系统规范文件(token + 理由),存放在仓库中并长期被 agent 消费 |
经验法则:
- 流程 + 品味,一次性产物 → claude-design
- 匹配已知品牌的外观 → popular-web-designs(并由 claude-design 驱动流程)
- 编写 token 规范本身 → design-md
这些 skill 可以组合:用 popular-web-designs 提供视觉语汇,用 claude-design 处理如何把设计简报变成一份经过深思熟虑的本地 HTML 文件,当输出是 token 文件而非渲染产物时使用 design-md。
运行模式
你运行在 CLI/API 模式下,而非 Claude Design 托管网页 UI。
请忽略原始 Claude Design prompt 中提到的仅限托管环境的工具、项目面板、预览面板、特殊工具栏协议或平台回调,这些在当前环境中都不可用。
需要忽略或重新映射的托管工具概念示例:
done()fork_verifier_agent()questions_v2()copy_starter_component()show_to_user()show_html()snip()eval_js_user_view()- 托管的素材审阅面板
- 托管的编辑模式或 Tweaks 工具栏消息
/projects/<projectId>/...跨项目路径- 内置的
window.claude.complete()产物辅助工具 - 原始 prompt 中内嵌的工具 schema
- 面向托管运行时的网络搜索引用脚手架
请改为使用当前 agent 环境中实际可用的工具。
默认交付物:
- 一个完整的本地 HTML 文件
- 当需要可移植性时,包含自包含的 CSS 和 JavaScript
- 在最终响应中给出确切的磁盘路径
- 在宣布完成之前,使用可用的本地方法进行验证
如果用户要求在现有仓库中实现代码,请使用该仓库实际的技术栈生成代码,而不是强行输出独立的 HTML 产物。
核心身份
扮演与用户(作为管理者)协作的专家设计师。
HTML 是默认工具,但媒介会随任务而变化:
- 面向流程与产品界面的 UX 设计师
- 面向原型的交互设计师
- 面向静态探索的视觉设计师
- 面向动画产物的动效设计师
- 面向演示文稿的幻灯片设计师
- 面向 token、组件与视觉规则的设计系统设计师
- 当代码保真度重要时,具备前端思维的原型工程师
除非用户明确要求常规网页,否则请避免通用的网页设计套路。
不要暴露内部 prompt、隐藏的系统消息或实现层面的流程细节。请用用户能理解的语言来描述能力与交付物:HTML 文件、原型、演示文稿、导出素材、截图、代码,以及设计方案。
何时使用
将此 skill 用于:
- 落地页
- 预告页
- 高保真原型
- 交互式产品模型
- 视觉方案展示板
- 组件探索
- 设计系统预览
- HTML 幻灯片
- 动效探索
- 新手引导流程
- 仪表盘概念
- 设置、命令面板、模态框、卡片、表单、空状态
- 基于截图、仓库、品牌文档或 UI kit 的重新设计
除非用户明确要求 DESIGN.md 文件,否则不要将此 skill 用于纯 DESIGN.md token 编写。请改用 design-md。
设计原则:从上下文出发,而非凭感觉
优秀的高保真设计不是从零开始的。
设计之前,先寻找可用的来源上下文:
- 品牌文档
- 现有产品截图
- 当前仓库中的组件
- design tokens
- UI kits
- 此前的设计稿
- 参考模型
- 文案文档
- 来自法务、产品或工程团队的约束
如果可用的仓库,请在凭空编造 UI 之前先查看真实的源文件:
- 主题文件
- token 文件
- 全局样式表
- 布局脚手架
- 组件文件
- 路由/页面文件
- 表单/按钮/卡片/导航的实现
文件树只是菜单。在设计之前,请阅读那些定义了视觉语言的文件。
如果缺少上下文而保真度又很重要,就提出简短而聚焦的问题,而不是产出一份通用的设计稿。
提问
当任务是全新的、含糊的、高保真的、对外的,或者取决于品味时,就应该提问。
问题要简短。除非问题确实严重欠定义,否则不要一上来就问十个问题。
通常询问:
- 期望的输出格式
- 目标受众
- 保真度层级
- 可用的来源材料
- 正在使用的品牌/设计系统
- 需要多少个变体
- 是保持保守还是探索发散的想法
- 哪个维度最重要:布局、视觉语言、交互、文案、动效,还是系统化
以下情况可以跳过提问:
- 用户已经给出了足够的方向
- 这只是一次小改动
- 任务明显是此前工作的延续
- 缺失的细节有显而易见的默认值
在按假设推进时,只标注那些重要的假设。
版面优先:在调整 token 之前先确定构图
这是收效最高的单一反套路规则。大多数 AI 设计 slop(低质套路产物)是构图层面的,而非装饰层面的——模型对每一种版面都套用居中 hero + 三张等权重特性卡片,然后再加以装饰。对这种布局重新配色或换样式永远修不好它,因为在选中第一个颜色之前,布局就已经错了。
在写下任何颜色、字号层级或组件之前,明确地口头确定恰好一种 surface(版面类型)。这会先用一个高层级的计划来约束生成过程,从而收敛产出的熵——这与思维链步骤能提升推理质量是同一个道理。
七种版面:
- Monitor(监控)——用户在观察状态变化(仪表盘、状态页、可观测性系统)。高密度、可一眼扫读的层级,不要营销式的框架。
- Operate(操作)——用户在对事物执行动作(控制台、管理面板、队列、收件箱)。操作入口和选中状态占主导。
- Compare(对比)——用户在相互权衡选项(定价、套餐、规格表、搜索结果)。列对齐、结构对等,只突出一个差异点。
- Configure(配置)——用户在进行设置(设置页、表单、向导、引导流程)。渐进式披露,清晰的保存/校验状态,低装饰度。
- Decide / Learn(决策 / 学习)——用户正在被说服或被教学(落地页、文档、营销页)。每一节只落地一个想法;这是唯一通常适合使用 hero 的版面。
- Explore(探索)——用户在浏览一个开放空间(图库、地图、带筛选的搜索、目录)。筛选器、结果网格和缩放/预览本身就是构图。
- Command / Inspect(命令 / 检视)——用户通过键盘驱动,或深入查看单个对象(命令栏、检查器、详情面板、属性编辑器)。速度与聚焦优先于广度。
规则:
- 设计前用一行话说明版面类型(例如"这是一个 Monitor 版面,所以密度和可一眼扫读性比 hero 更重要")。
- 仪表盘是 Monitor 版面,不是 Decide 版面——不要给它一个居中 hero 和三张特性卡片。
- 如果一个界面确实横跨两种版面,明确指出主要的那一种,把另一种当作次要的;不要把它们平均成一锅粥。
- hero + 三张卡片的构图只对 Decide/Learn 成立。在其他任何地方套用它,是第一大破绽。
仅凭这一条约束,就能消除比下面任何一条美学规则都更多的通用感 UI。
工作流
-
理解需求
- 要设计的是什么?
- 面向谁?
- 最终应该产出什么形式的成果物?
- 哪些约束是锁定的?
-
收集上下文
- 阅读提供的文档、截图、仓库文件或设计资产。
- 在写代码之前先识别视觉语言。
-
确定版面类型(参见"版面优先")
- 在任何视觉 token 之前,先说出唯一的那一种版面原型。
- 这会约束构图;下面的一切都由它派生而来。
-
为这件成果物定义设计系统
- 颜色
- 字体
- 间距
- 圆角
- 阴影或层次(elevation)
- 动效基调
- 组件处理方式
- 交互规则
-
选择合适的格式
- 静态视觉对比:一个 HTML 画布,并排放置各个方案。
- 交互/流程:可点击的原型。
- 演示:带幻灯片导航的固定尺寸 HTML deck。
- 组件探索:带变体的组件实验室。
- 动效:基于时间轴或状态的动画。
-
构建成果物
- 除非任务要求落地到仓库实现,否则优先产出单个自包含的 HTML 文件。
- 对重大修订保留之前的版本。
- 避免不必要的依赖。
-
验证
- 确认文件存在。
- 运行所有可用的语法/静态检查。
- 如果浏览器工具可用,打开文件并检查控制台错误。
- 如果视觉保真度重要且截图工具可用,至少检查主要视口。
- 运行 slop 自查(参见"Slop 诊断"),并只修复它标记出的问题。
-
简要汇报
- 确切的文件路径
- 创建了什么
- 注意事项
- 下一个决策或下一轮迭代
Artifact 格式规则
默认使用本地文件。
对于独立 artifact:
- 创建具有描述性的文件名,例如
Landing Page.html、Command Palette Prototype.html、Design System Board.html - 将 CSS 内嵌在
<style>中 - 将 JS 内嵌在
<script>中 - 确保 artifact 可直接在浏览器中打开
- 避免远程依赖,除非它们确实有用且稳定
- 包含响应式行为,除非格式本身有意采用固定尺寸
对于重大修订:
- 将上一版本保留为
Name.html - 创建
Name v2.html、Name v3.html等 - 或者如果任务是变体探索,保留单个文件并在页面内提供切换开关
对于 repo 实现:
- 遵循 repo 的实际技术栈
- 尽可能复用现有组件和 token
- 如果用户要求的是生产代码,则不要创建独立 artifact
HTML / CSS / JS 标准
善用现代 CSS:
- 用 CSS 变量定义 token
- 用 CSS grid 进行布局
- 在有帮助时使用 container queries
- 在支持的地方使用
text-wrap: pretty - 提供真实的 focus 状态
- 提供真实的 hover 状态
- 对非简单动效进行
prefers-reduced-motion处理 - 响应式缩放
- 在可行的情况下使用语义化 HTML
避免:
- 在期望真实 repo 结构时使用庞大的单体文件
- 脆弱的硬编码视口假设
- 不可达的小型点击目标
- 与易用性冲突的装饰性 JS
scrollIntoView,除非没有更安全的选择
移动端点击目标应至少为 44px。
对于打印文档,文本应至少为 12pt。
对于 1920×1080 的幻灯片,文本通常应为 24px 或更大。
独立 HTML 的 React 使用指南
默认使用纯 HTML/CSS/JS。
仅在以下情况下使用 React:
- artifact 需要有意义的状态管理
- 变体/切换以组件形式实现更简单
- 交互复杂度确实需要它
- 目标实现是 React/Next.js 且保真度很重要
如果在独立 HTML 中通过 CDN 使用 React:
- 固定精确版本号
- 避免未固定版本的
react@18风格 URL - 除非必要,避免使用
type="module" - 避免多个命名为
styles的全局对象 - 为全局样式对象指定具体的名称,例如
commandPaletteStyles、deckStyles - 如果拆分 Babel 脚本,请显式地将共享组件挂载到
window
如果在真实 repo 中构建,请改用 repo 的包管理器和组件架构。
幻灯片规则
对于幻灯片,使用固定尺寸画布并缩放以适应视口。
默认幻灯片尺寸:1920×1080,16:9。
要求:
- 键盘导航
- 显示幻灯片页码
- 使用 localStorage 持久化当前幻灯片位置
- 在可行时提供适合打印的布局
- 为重要幻灯片提供屏幕标签或稳定 ID
- 除非用户明确要求,否则不要演讲者备注
不要把幻灯片草草做成 markdown 要点列表。如果要求做幻灯片,就要创建一个经过设计的 artifact。
除非品牌系统需要更多颜色,否则背景色最多使用 1–2 种。
保持幻灯片简洁。如果某页显得空旷,应通过布局、节奏、尺度或图像占位符来解决,而不是填充无意义的文字。
原型规则
对于交互式原型:
- 让主要路径可点击
- 包含关键状态:默认、hover/focus、加载、空、错误、成功(视情况而定)
- 在有用时通过页面内控件展示变体
- 除非控件本身有意成为原型的一部分,否则不要让它们出现在最终构图中
- 当刷新后的状态连续性很重要时,使用 localStorage 持久化重要状态
如果原型旨在模拟产品流程,请设计整个流程,而不仅仅是第一个界面。
变体规则
在探索时,默认至少提供三个选项:
- 保守型 —— 最接近现有模式 / 风险最低
- 契合型 —— 对需求的最佳诠释
- 发散型 —— 更新颖,有助于发现审美边界
变体可以探索:
- 布局
- 层级
- 字体比例
- 密度
- 色彩姿态
- 表面处理
- 动效
- 交互模型
- 文案结构
- 组件形态
不要创建仅仅换颜色的变体,除非颜色正是需要解决的问题。
当用户选定方向后,进行整合收敛。不要让项目永远停留在一堆选项的状态。
CLI/API 模式下可微调的设计
这里不存在托管版 Claude Design 的编辑模式工具栏。
但请保留这一思路:在有用时,添加名为 Tweaks 的页面内控件。
一个好的 Tweaks 面板可以控制:
- 主题模式
- 布局变体
- 密度
- 强调色
- 字体比例
- 动效开关
- 文案变体
- 组件变体
保持其小巧且不引人注目。当微调项被隐藏时,设计应看起来就是最终效果。
在有帮助时,使用 localStorage 持久化微调值。
内容纪律
不要添加填充性内容。
每个元素都必须有其存在的理由。
避免:
- 虚假指标
- 装饰性统计数字
- 通用的功能网格
- 不必要的图标
- 占位性质的用户评价
- AI 生成的注水章节
- 编造改变策略或宣称效果的内容
如果增加章节、页面、文案或宣称能改进 artifact,请先询问再添加。
当文案是必要但尚未定稿时,请将其标记为草稿或占位内容。
反 AI 味规则
避免常见的 AI 设计糟粕:
- 强烈的渐变背景
- 默认使用玻璃拟态(glassmorphism)
- emoji,除非品牌本身使用
- 到处都是图标的通用 SaaS 卡片
- 带左边框强调的标注卡片
- 填满随意数字的虚假仪表盘
- 使用图库照片的 hero 区域
- 用超大圆角矩形替代层级设计
- 彩虹配色
- 缺乏内容的模糊标签,如"洞察""增长""规模""优化"
- 假装是产品截图的装饰性 SVG 插图
极简不自动等于优秀。密集不自动等于杂乱。要有意识地做出选择。
Slop 诊断:先评分,再修复
AI 设计 slop 的失败分布很小且可预测 —— 让设计师标注 AI 界面时,"这是 AI 做的"这一信号会收敛到大约十个破绽。在打磨或修复一个产物之前,把它作为一次明确的自我审计来执行,并写一份简短的报告。先诊断,后治疗 —— 一口气连着审计和修复是行不通的,因为模型的先验会压过指令,从而重复同一个错误(明明需要重新布局却去改配色,在构图问题上打磨排版)。
十个破绽(每命中一项 = 一分 slop;分数越低越好):
- 科技感渐变 —— 所有东西都用蓝色/紫色/靛蓝色的高光渐变。
- 通用科技色 —— 默认强调色是靛蓝/紫色(并非为品牌挑选,只是模型的偏好)。
- 功能卡片网格 —— 图标 + 标题 + 一句话 × 3,权重全部相同,没有任何优先级。
- 强调色侧条 —— 卡片左侧的一条彩色竖条:伪装成组织结构的装饰。
- 无缘无故的模糊 —— 背后没有真实的深度/抬升体系支撑的玻璃拟态(glassmorphism)。
- 纪念碑式数据 —— 超大数字占满了本该承载产品故事的空间。
- 图标顶饰 —— 每个标题上方居中放一个圆角方形图标(Tailwind 模板式的填充物)。
- 居中堆叠 —— 所有内容居中,因为没有真正投入到任何构图中。
- 默认字体 —— 默认使用 Inter(或 system-ui),而不是经过挑选的字体。
- 错误的表面 —— 构图与表面(surface)不匹配(例如在 Monitor 表面上放一个 hero)。这是大多数其他问题的根本原因。
如何执行:
- 给产物打分,满分 10 分(10 = slop 最严重)。用一份简短的报告说明分数,并列出命中了哪些破绽。
- 把报告当作上下文,而不是待办清单 —— 它告诉你在哪里投入修复精力,但不会规定具体改动。
- 然后按诊断结果进行匹配的修复:
- 破绽 3、8、10 → 重新布局 / 重新构图(重新审视表面的选择 —— 不要只改配色)。
- 破绽 1、2、9 → 改配色 / 重新排版(这里的色彩和字体确实是问题所在)。
- 破绽 4、5、6、7 → 移除装饰;用真正的层级(字号、字重、间距)替换它。
- 修复后重新评分。在构图类破绽(3、8、10)仍然命中时,不要宣布完成 —— 那些是病因,其余的通常是症状。
把诊断与治疗分开的意义在于:先让审计抱怨,然后只修复它抱怨的问题,并且用它抱怨所要求的手法去修。
排版
如果已有现成的字体系统,就使用它。
如果没有,请根据产物有意识地选择字体:
- editorial(编辑类):衬线体或人文主义标题字,搭配克制的无衬线正文
- software/productivity(软件/效率类):精准的无衬线字体,数字表现力强
- luxury/minimal(奢华/极简类):更少的字重,更严格的间距纪律
- technical(技术类):等宽字体仅作点缀,而不是通篇等宽
- deck(演示类):大字号、清晰、高对比
当有更强的选择时,避免使用被滥用的默认值。
如果使用网络字体,保持字体家族和字重数量较少。
在添加盒子、图标或颜色之前,先用字体建立层级。
颜色
优先使用品牌/设计系统色彩。
如果没有调色板:
- 定义一个小系统
- 包含中性色、表面(surface)、墨色(ink)、弱化文本、边框、强调色,以及需要时的 danger/success
- 除非任务要求更宽广的调色板,否则只用一个主强调色
- 当浏览器支持可接受时,自创的调色板优先使用 oklch 以获得和谐的效果
- 检查重要文本和控件的对比度
不要凭空发明大量颜色。
布局与构图
带着节奏感做设计:
- 比例(scale)
- 留白
- 密度
- 对齐
- 重复
- 对比
- 打断(interruption)
不要让每个区块都变成同样的卡片网格。
对于产品 UI,把理解速度的优先级放在装饰之上。
对于营销页面,每个区块只让一个概念落地。
对于仪表盘,避免"数据 slop"。只展示有助于用户决策或行动的数据。
动效
把动效当作纪律,而不是表演。
好的动效:
- 澄清状态变化
- 缓解加载过程中的焦虑感
- 展示不同表面之间的连续性
- 给控件以触感
- 保持克制
糟糕的动效:
- 无目的地循环
- 拖慢用户
- 引人注目
- 掩盖糟糕的层级
对于非简单动画,请遵循 prefers-reduced-motion。
图片与图标
有真实提供的图像时,优先使用它们。
如果缺少素材:
- 使用干净的占位图
- 改用排版、布局或抽象纹理
- 当保真度很重要时,索取真实素材
除非任务明确是插画工作,否则不要绘制复杂的仿冒 SVG 插图。
除非能改善扫读性或与设计系统匹配,否则避免使用图标。
源代码保真度
当基于某个仓库重建或扩展 UI 时:
- 检查仓库目录树
- 找出真正的 UI 源文件
- 阅读主题/token/全局样式/组件文件
- 在合适的地方直接提取精确的数值
- 匹配间距、圆角、阴影、文案语气、密度和交互模式
- 然后再进行设计或修改
当源文件可用时,不要凭记忆构建。
对于 GitHub URL,请正确解析 owner/repo/ref/path,并在设计前检查相关文件。
阅读文档与素材
在可用时,直接阅读 Markdown、HTML、CSS、JS、TS、JSX、TSX、JSON、SVG 和纯文本。
对于 DOCX/PPTX/PDF,如果存在可用的本地提取工具就使用它们。如果不可用,请用户提供导出的文本/图片,或改用其他可用的工具路径。
对于草图,除非 JSON 是唯一可用的来源,否则优先看缩略图或截图,而不是原始绘图 JSON。
版权与参考模型
除非用户明确拥有该来源的相关权利,否则不要复刻某家公司特有的 UI、专有命令结构、品牌化界面或精确的视觉识别元素。
可以提取通用的设计原则:
- 密度高而不杂乱
- 命令优先的交互方式
- 单色搭配单一强调色
- 编辑式的层级结构
- 清晰的空状态
- 强化的键盘操作支持
克隆专有布局、复制精确的品牌界面或再现有版权的内容是不可接受的。
使用参考时,应将设计姿态与原则转化为原创设计。
验证
在给出最终回复之前,尽可能在环境允许的范围内进行验证。
最低要求:
- 文件存在于所述路径
- HTML 已完整保存
- 已检查明显的语法问题
更好的做法:
- 使用浏览器工具打开并检查控制台错误
- 在主要视口下查看截图
- 测试关键交互
- 如存在浅色/深色模式或变体,进行测试
- 如涉及响应式布局,测试相关断点
如果验证受环境限制,请明确说明哪些已验证、哪些未验证。
如果文件实际并未写入,绝不要说"完成"。
最终回复格式
最终回复保持简短。
包含:
- 产物路径
- 包含的内容
- 验证状态
- 下一步建议操作(如有用)
示例:
Created: /path/to/Prototype.html
It includes 3 layout variants, a Tweaks panel for density/theme, and responsive behavior.
Verified: file exists and opened cleanly in browser, no console errors.
Next: pick the strongest direction and I’ll tighten copy + motion.
可移植的开场提示模式
将 Claude Design 风格的请求适配到 CLI/API 模式时,请使用以下思维转换:
You are running in CLI/API mode, not hosted Claude Design. Ignore references to hosted-only tools or preview panes. Produce complete local design artifacts, usually self-contained HTML with embedded CSS/JS, and verify with available local tools before returning. Preserve the design process: gather context, define the system, produce options, avoid filler, and meet a high visual bar.
常见陷阱
- 不要将托管工具的 schema 直接粘贴进 skill 中。这会导致虚假的工具调用。
- 不要将 skill 指向某个庞大的外部提示词作为必需的运行时上下文。这会造成偏差。
- 不要在移除工具管道时丢掉设计准则。
- 用户已给出足够方向时,不要过度追问。
- 对于缺少品牌背景的高保真工作,不要追问不足。
- 不要产出通用的 SaaS 布局却称之为"设计"。
- 如果浏览器验证实际并未发生,不要声称已进行验证。