mcpField
A
aesthetic-guide

aesthetic-guide

github.com/petekp设计与 UI1051 次安装21 周前更新
代码仓库

关于 aesthetic-guide

为指定的 UI 美学风格生成可直接实施的设计系统指南。技能会查询现有目录或研究细节,再按结构输出包含具体数值的 Markdown 指南。

主要功能

  1. 01查询已研究风格目录
  2. 02研究自定义或未收录风格
  3. 03提供颜色、字体、间距与动效数值
  4. 04列出 CSS 变量及 Tailwind 对应项
  5. 05生成 Markdown 指南

适用场景

  1. 01记录指定的视觉美学风格
  2. 02为编码 Agent 准备设计实现依据
  3. 03定义特定框架或混合风格

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/petekp/agent-skills --skill aesthetic-guide

安装后在 Claude Code 中输入/aesthetic-guide确认已加载。

附带文件references/aesthetic-catalog.mdreferences/output-schema.md

详细介绍

美学指南

为指定的 UI 美学编写详尽、可直接用于实现的设计系统文档。输出应是一份参考指南,细致到编码 Agent 几乎无需自行判断,就能忠实地实现这种美学。

工作流

  1. 识别美学:根据用户的请求确定美学风格
  2. 查阅目录:阅读 references/aesthetic-catalog.md,确认目录中是否已有该美学的研究数据
  3. 按需研究:如果目录中没有该美学,或用户希望定制变体,则进行网页研究,收集实现层面的具体信息(确切的 CSS 值、字体、颜色、时间函数)
  4. 加载输出架构:阅读 references/output-schema.md,了解所需结构
  5. 生成指南:为输出架构的每个部分填写具体、可直接复制粘贴的值。不得含糊其辞,也不得写“选择合适的值”——每个属性都必须给出确切值,或附有理由的限定范围。
  6. 以 Markdown 文件交付:将完成的指南写入项目(默认路径:.claude/docs/{aesthetic-name}-design-system.md)

研究规范

研究目录中没有的美学时:

  • 搜索 "{aesthetic} CSS"、"{aesthetic} UI design system"、"{aesthetic} web design examples"
  • 查找开源实现、CodePen 示例和设计系统文档
  • 提取具体值:十六进制颜色代码、字体名称、px/rem 值、cubic-bezier 曲线、阴影语法
  • 交叉参考多个来源,找出定义该美学的共识属性
  • 区分必要属性(缺少这些属性,就不再属于该美学)与特征属性(常见但可选)

输出要求

  • 每种颜色都必须使用十六进制或 HSL 值,不得使用“深蓝色”等名称
  • 每种字体都必须指定具体字体系列,并提供备用字体栈
  • 每个间距值都必须使用 px 或 rem
  • 每个过渡都必须指定持续时间和时间函数
  • 每种交互状态(悬停、激活、聚焦、禁用)都必须提供明确的 CSS
  • 每个组件都必须定义所有伪状态
  • 在适用时,同时提供 CSS 自定义属性(变量)和 Tailwind 对应写法

自定义

用户可能会要求:

  • 指定框架(Tailwind、原生 CSS、CSS-in-JS)——调整输出格式
  • 混合风格(“粗野主义搭配柔和阴影”)——融合美学风格,并注明各属性分别来自哪种风格
  • 指定变体(“暗色模式赛博朋克”或“亮色模式赛博朋克”)——生成指定变体
  • 部分指南(仅颜色、仅排版)——只生成用户要求的部分

评论

支持 Markdown