功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

前端设计工坊

生成具有鲜明美学风格的生产级前端代码。避免通用 AI 美学(Inter/Roboto 字体、紫色渐变白底、千篇一律的卡片布局),追求具有记忆点的独特视觉表达。支持 HTML/CSS/JS、React、Vue 等多种技术栈. 范围外(本技能不做): 3D 建模与动画制作、后端 API 开发、数据库设计、DevOps 部署配置.

输入参数

参数名	类型	必填	说明
input	string	是	前端设计工坊处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

专业版增强能力

能力	免费版	付费版
基础功能	支持	支持
高清分辨率与无损输出	不支持	支持
批量生成与风格预设	不支持	支持
自定义模型微调	不支持	支持
商用版权授权	不支持	支持

前置条件

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

功能能力

设计思维

在编写代码之前,先理解上下文并确定一个鲜明的美学方向:

• Purpose(目的): 这个界面解决什么问题?谁在使用它?
• Tone(调性): 选择一个明确的美学方向。可选方向包括: 极简主义、极繁主义混沌、复古未来、有机自然、奢华精致、俏皮玩具、编辑杂志、粗野主义、装饰艺术、柔和粉彩、工业实用等。用这些方向作为灵感,但设计出真正忠于所选方向的作品.
• **Constrain

前端美学指南

排版字体

• 选择美观、独特、有趣的字体
• 避免通用字体: Inter、Roboto、Arial、系统字体
• 选择能提升前端美学的独特字体,搭配一个精致的正文字体与一个有辨识度的展示字体
• 不同生成之间应变换字体选择,不要每次都收敛到 Space Grotesk 等常见选择

配色主题

• 致力于一个连贯的美学方向,使用 CSS 变量保持一致性
• 主导色搭配锐利点缀色,优于

设计思维(补充)

• Constraints(约束): 技术要求(框架、性能、无障碍访问).
• Differentiation(差异化): 什么让这个设计令人难忘?用户会记住的一个亮点是什么?

关键原则: 选择一个清晰的概念方向并精准执行。大胆的极繁主义和精致的极简主义都有效,核心是有意为之,而非强度堆砌.

前端美学指南(补充)

排版字体(补充)

• 选择美观、独特、有趣的字体
• 避免通用字体: Inter、Roboto、Arial、系统字体
• 选择能提升前端美学的独特字体,搭配一个精致的正文字体与一个有辨识度的展示字体
• 不同生成之间应变换字体选择,不要每次都收敛到 Space Grotesk 等常见选择

配色主题(补充)

• 致力于一个连贯的美学方向,使用 CSS 变量保持一致性
• 主导色搭配锐利点缀色,优于胆怯的均匀分布调色板
• 避免老套配色: 尤其是白底紫色渐变

动效交互

• 用动画增强效果与微交互
• HTML 项目优先使用纯 CSS 方案;React 项目有 Motion 库时优先使用
• 聚焦高影响力时刻: 一次精心编排的页面加载(带交错出现的 animation-delay)比分散的微交互更有吸引力
• 善用滚动触发与悬停状态的惊喜感

空间构图

• 意想不到的布局: 不对称、重叠、对角线流动、打破网格的元素
• 大量留白或受控的高密度,两者皆可,关键是有意识的选择

背景与视觉细节

• 营造氛围与深度,而非默认使用纯色背景
• 添加与整体美学匹配的上下文效果和纹理: 渐变网格、噪点纹理、几何图案、分层透明度、戏剧性阴影、装饰性边框、自定义光标、颗粒叠加

绝不使用通用 AI 美学: 过度使用的字体族(Inter/Roboto/Arial/系统字体)、老套配色(白底紫色渐变)、可预测的布局与组件模式、缺乏上下文特色的千篇一律设计.

使用说明

Step 1: 理解设计上下文

• 明确界面用途: 落地页/仪表盘/组件/品牌页
• 明确目标用户: 消费者/企业团队/创意工作者
• 明确技术约束: 框架(HTML/React/Vue)、性能要求、无障碍要求

Step 2: 选择美学方向

从以下方向中选择一个并全力执行:

• 极简主义: 克制、精准、注重留白与排版
• 极繁主义混沌: 丰富、密集、多层次的视觉冲击
• 复古未来: 融合怀旧与科技感的视觉语言
• 有机自然: 柔和曲线、自然色调、生态质感
• 奢华精致: 精细排版、高级配色、考究细节
• 俏皮玩具: 圆润形状、鲜艳色彩、趣味交互
• 编辑杂志: 排版驱动、网格系统、阅读体验优先
• 粗野主义: 原始粗犷、单色对比、功能至上
• 装饰艺术: 几何对称、金属质感、复古优雅
• 柔和粉彩: 柔软色调、温柔渐变、舒适氛围
• 工业实用: 功能导向、中性色调、结构清晰

Step 3: 排版与配色决策

• 选择独特字体组合(展示字体 + 正文字体),避免 Inter/Roboto/Arial
• 确定主导色与点缀色,使用 CSS 变量管理
• 明确浅色/深色主题方向

Step 4: 实现生产级代码

• 编写功能完整、可直接运行的代码
• 注重每个细节的精致度: 间距、字重、阴影、圆角
• 添加动效与微交互(页面加载交错出现、悬停惊喜、滚动触发)
• 营造背景氛围(渐变网格、噪点纹理、几何图案等)

Step 5: 验证与交付

• 在浏览器中预览效果
• 检查响应式布局与跨浏览器兼容性
• 确认无障碍访问基础(WCAG 对比度、语义化 HTML)
• 将代码文件交付给用户

结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.

案例展示

案例一： 复古杂志风格咖啡品牌落地页

场景: 独立咖啡品牌需要一个有编辑感的落地页,传达手工烘焙的匠人气质

设计决策:

• 美学方向: 编辑杂志风格,搭配复古色调
• 字体: 展示字体用衬线字体(如 Playfair Display),正文用人文无衬线(如 Spectral)
• 配色: 暖米色背景 + 深棕主色 + 焦橙点缀
• 布局: 不对称网格,大标题跨越多列,图文交错排列
• 动效: 页面加载时文字逐行交错淡入,滚动触发图片视差位移

输出: 完整的 HTML/CSS/JS 单文件落地页,包含 Hero 区域、产品故事、烘焙工艺展示、门店信息等板块

说明: 编辑杂志风格的核心是排版驱动设计。通过衬线展示字体传达复古质感,不对称网格打破常规卡片布局,暖色调营造手工烘焙的温暖氛围。动效克制但精准,页面加载的逐行淡入模拟翻页阅读体验.

案例二： 工业实用风格数据仪表盘

场景: 企业团队需要一个数据分析仪表盘,要求功能清晰、信息密度高

设计决策:

• 美学方向: 工业实用风格,功能导向
• 字体: 等宽字体(如 JetBrains Mono)用于数据,无衬线(如 IBM Plex Sans)用于标签
• 配色: 深灰背景 + 青绿数据色 + 琥珀警示色
• 布局: 紧凑网格,高信息密度,清晰的功能分区
• 动效: 数据更新时的微妙脉冲,悬停时显示详细信息的工具提示

输出: React 仪表盘组件,包含数据卡片、趋势图表、状态指标、操作面板等模块

说明: 工业实用风格的核心是功能至上。等宽字体确保数据对齐,深色背景减少视觉疲劳,青绿与琥珀的对比清晰区分正常与异常状态。信息密度高但层次分明,每个模块都有明确的功能边界.

案例三： 装饰艺术风格品牌视觉页

场景: 珠宝品牌需要一个视觉展示页,传达奢华与几何美学

设计决策:

• 美学方向: 装饰艺术,几何对称与金属质感
• 字体: 展示字体用几何无衬线(如 Bodoni Moda),正文用精致衬线(如 Cormorant)
• 配色: 深墨绿背景 + 香槟金主色 + 象牙白文字
• 布局: 严格对称,几何分割,居中构图
• 动效: 页面加载时几何元素扇形展开,悬停时金属光泽流动

输出: 完整的 HTML/CSS/JS 品牌视觉页,包含品牌故事、产品展示、工艺传承、联系方式等板块

说明: 装饰艺术风格的核心是几何对称与金属质感。Bodoni Moda 的高对比度笔画传达奢华感,深墨绿与香槟金的搭配经典而高级。严格对称的布局强化品牌的庄重感,扇形展开的加载动画致敬装饰艺术的几何美学.

问题应对方案

错误场景	错误表现	原因分析	处理方式
generic_font_selection	使用 Inter/Roboto/Arial 等通用字体	未遵循排版字体指南	替换为独特字体组合,展示字体搭配正文字体,避免系统默认字体
cliche_color_scheme	白底紫色渐变等老套配色	未遵循配色主题指南	重新选择主导色与点缀色,使用 CSS 变量管理,避免白底紫色渐变
cookie_cutter_layout	千篇一律的卡片网格布局	缺乏空间构图创意	采用不对称、重叠、对角线流动等意想不到的布局,打破网格常规
missing_aesthetic_direction	设计缺乏明确风格,特征模糊	未在设计思维阶段确定方向	重新选择一个明确的美学方向并全力执行,避免风格混杂
inconsistent_design_system	字体/配色/间距不一致	未使用 CSS 变量或设计令牌	建立统一的设计令牌系统,用 CSS 变量管理颜色/字体/间距
accessibility_violations	对比度不足、缺少语义化 HTML	忽视无障碍访问要求	检查 WCAG 对比度标准,使用语义化 HTML 标签,添加 ARIA 属性
animation_performance	动画过多导致页面卡顿	过度使用动画效果	聚焦高影响力时刻,减少分散的微交互,优先使用 CSS transform 与 opacity
framework_mismatch	用户要求 React 但生成纯 HTML	未确认技术栈约束	在设计思维阶段明确技术栈,按用户要求的框架生成对应代码

热门问题

Q1: 如何选择合适的美学方向?

A: 从界面用途与目标用户出发。品牌落地页适合编辑杂志或装饰艺术风格;仪表盘适合工业实用风格;创意组件适合俏皮玩具或极繁主义;品牌视觉页适合奢华精致或有机自然。选择后全力执行,避免风格混杂。极繁与极简皆可,核心是有意为之.

Q2: 哪些字体应该避免?

A: 坚决避免 Inter、Roboto、Arial 和系统默认字体。这些字体过度使用,缺乏辨识度。推荐选择独特的展示字体(如 Playfair Display、Bodoni Moda、JetBrains Mono)搭配精致的正文字体(如 Spectral、Cormorant、IBM Plex Sans)。每次生成应变换字体选择,不要收敛到同一字体.

Q3: 如何平衡极简主义与极繁主义?

A: 两者没有优劣之分,关键是有意为之。极简主义需要克制、精准,注重留白、排版与微妙细节;极繁主义需要丰富、多层次,注重视觉冲击与密度控制。实现复杂度应匹配美学愿景: 极繁设计需要精心编排的动画与效果,极简设计需要精准的间距与字体处理.

Q4: 何时使用 React,何时使用纯 HTML/CSS/JS?

A: 取决于用户的技术约束。用户指定 React 时生成 React 组件,有 Motion 库时优先用于动画;用户未指定或需要快速预览时使用纯 HTML/CSS/JS,动画优先用纯 CSS 方案。在设计思维阶段明确技术栈,避免生成与用户环境不匹配的代码.

Q5: 如何确保无障碍访问?

A: 关注三个基础: WCAG 色彩对比度(正文与背景对比度至少 4.5:1)、语义化 HTML(使用 header/nav/main/article/section 等标签)、ARIA 属性(为交互元素添加 aria-label)。动画效果应提供 prefers-reduced-motion 媒体查询支持.

Q6: 如何避免通用 AI 美学?

A: 每次设计都应具有上下文特色。避免: 过度使用的字体族、老套的紫色渐变白底、可预测的卡片布局、缺乏个性的组件模式。多变换浅色与深色主题、不同字体、不同美学方向。解读用户需求时做出有创意的选择,让设计真正为特定上下文而做,而非千篇一律的模板.

功能边界

1. 需 LLM 支持: 无 LLM 环境无法使用,设计质量取决于底层模型能力
2. 不涵盖 3D 建模与动画: 仅支持 2D 前端界面,3D 内容需使用其他工具
3. 字体可用性依赖环境: 生成的代码引用的字体需用户环境可访问(如 Google Fonts CDN)
4. 复杂场景可能需要人工微调: 生成代码可能需要在细节(精确间距、动画时序)上人工调整
5. 性能取决于实现复杂度: 极繁主义设计可能因动画与效果较多而影响性能,需在视觉与性能间平衡
6. 不生成后端代码: 仅生成前端界面代码,后端 API 与数据库需另行开发
7. 跨浏览器兼容性需验证: 生成的 CSS 可能使用现代特性,老旧浏览器兼容性需单独处理

输出规范

{
  "success": true,
  "data": {
    "result": "前端设计工坊处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "anthropics-frontend-design"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

技术创新

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
排版设计	2小时	30分钟	1.5小时	15%
配色主题生成	1小时	15分钟	45分钟	25%
动效交互开发	4小时	1小时	3小时	25%
空间构图调整	3小时	45分钟	2.25小时	25%
背景纹理应用	1小时	30分钟	30分钟	20%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
设计效率	高效生成	低效，耗时	中等效率，需编程	高效，但需专业软件
美学风格多样性	多种风格预设	有限风格，需逐项调整	有限风格，需编程	多种风格，但需专业软件
代码质量	高质量代码	代码质量参差不齐	代码质量一般	高质量代码，但需专业软件
技术栈兼容性	多种技术栈支持	技术栈限制	技术栈限制	技术栈限制
学习成本	低学习成本	高学习成本	中等学习成本	高学习成本

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
设计效率低	设计工作耗时，影响项目进度	项目进度，成本	提供自动化设计工具	时间节约15%
美学风格单一	设计风格单一，缺乏创意	产品竞争力，用户体验	提供多种风格预设	美学风格多样性提升25%
代码质量差	代码质量差，影响项目维护	项目维护成本，用户体验	自动生成高质量代码	代码质量提升15%

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
设计输出不正确	输入数据错误	检查输入数据格式	修正输入数据
设计工具无法启动	系统环境问题	检查系统环境	安装或更新依赖项
设计输出延迟	网络连接问题	检查网络连接	优化网络连接或重试
设计输出异常	代码错误	检查代码逻辑	修正代码错误
设计工具崩溃	软件故障	重启软件	更新软件或联系技术支持

安全注意

1. 避免将敏感设计数据上传至公共平台。
2. 确保API Key安全，不要泄露给未授权人员。
3. 定期更新软件以修复安全漏洞。
4. 对设计输出进行备份，以防数据丢失。
5. 限制对设计工具的访问权限，防止未授权使用。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

用户常见咨询

Q1: 前端设计工坊支持哪些输入格式？

A1: 创建独特的生产级前端界面,专注排版配色动效与空间构图,避免通用AI美学。前端设计创作技能,生成具有鲜明美学风格的生产级前端代码。覆盖排版字体、配色主题、动效交互。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

故障恢复

针对前端设计工坊使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

前端设计工坊通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

使用场景

• 日常开发: 前端设计工坊可快速集成到现有开发流程中,提升工作效率
• 接口集成: 对接第三方API服务,实现数据自动获取和处理
• 内容生成: 自动生成文档、代码或结构化数据
• 文件批处理: 批量处理文件内容,支持多格式转换和解析
• 环境管理: 批量管理开发环境和部署流程
• 信息检索: 快速搜索和过滤目标数据
• 数据管道: 构建ETL流程,实现数据自动化流转