关于 awesome-design-md
awesome-design-md 是一项用于 UI 工作的技能,提供可选择的设计参考库。它帮助开发者按产品情境选定风格,并在保留现有约束的前提下应用。
主要功能
- 01可选的 UI 设计参考
- 02依据产品情境选择风格
- 03仅加载选定的设计指南
- 04布局、颜色与交互指导
- 05保留无障碍要求和项目惯例
适用场景
- 01编辑 UI 前确定视觉方向
- 02更新现有应用并保留原有流程
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ wearescientist/ awesome-design-md --skill awesome-design-md安装后在 Claude Code 中输入/awesome-design-md确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdLICENSESTYLE_INDEX.txtCONTRIBUTING.md.gitignore.github/FUNDING.yml.github/ISSUE_TEMPLATE/design-md-request.ymlagents/openai.yamldesign-md/airbnb/README.mdDESIGN.mddesign-md/airtable/DESIGN.mdREADME.mddesign-md/apple/README.mdDESIGN.mddesign-md/binance/DESIGN.mdREADME.mddesign-md/bmw-m/DESIGN.mdREADME.mddesign-md/bmw/DESIGN.mdREADME.mddesign-md/bugatti/DESIGN.mdREADME.mddesign-md/cal/README.mdDESIGN.mddesign-md/claude/README.mdDESIGN.mddesign-md/clay/README.mdDESIGN.mddesign-md/clickhouse/DESIGN.mdREADME.md详细介绍
Awesome Design MD
目的
将捆绑的 Awesome Design MD 库用作可选的 UI 设计参考集合。不要假设所有界面都采用同一种全局风格。选择最适合产品的风格,然后在更改 UI 前阅读该风格的 DESIGN.md。
所有库路径都相对于此技能文件夹解析,也就是包含此 SKILL.md 的目录。
捆绑库:
<skill-root>/design-md
风格索引:
<skill-root>/STYLE_INDEX.txt
风格文件路径格式:
<skill-root>/design-md/<style>/DESIGN.md
可选的选择说明:
<skill-root>/references/style-selection.md
工作流
- 如果用户指定了风格,且该风格存在,就使用该风格。
- 如果用户未指定风格,就检查产品背景并选择 1 种风格。开始编辑前,简要说明所选风格。
- 如果需要查看可用风格,请阅读
STYLE_INDEX.txt。 - 只阅读选定的
design-md/<style>/DESIGN.md;不要加载整个库。 - 将该风格作为布局、颜色、排版、间距、交互体验和组件视觉样式的指导。
- 保留现有的产品约束、数据密度、无障碍要求和框架约定。
- 对于现有应用,在不破坏既有流程的前提下逐步优化 UI,除非用户明确要求重新设计。
默认风格映射
- 开发者工具、AI Agent 控制台、自动化面板:
voltagent、cursor、warp、linear.app、raycast。 - SaaS 仪表板、任务或项目管理、管理控制台:
linear.app、stripe、vercel、posthog、supabase。 - 面向消费者、类似移动应用的精致产品:
apple、airbnb、spotify、pinterest、notion。 - 加密货币、Web3、交易平台、金融:
coinbase、binance、kraken、revolut、wise。 - AI 实验室、模型或产品页面:
x.ai、mistral.ai、cohere、together.ai、runwayml、replicate。 - 文档、开发者门户:
mintlify、vercel、stripe、supabase、hashicorp。 - 奢侈品、汽车、品牌主导的落地页:
bugatti、ferrari、lamborghini、bmw、tesla、nike。
如果有多种风格都适用,就选择最能改善特定屏幕的风格,而不是最炫的风格。
规则
- 不要在所有地方都盲目套用
voltagent。 - 除非用户要求,否则不要将
DESIGN.md导入目标项目;阅读捆绑库中的文件即可。 - 不要在最终答复中复制大段设计文本。
- 不要覆盖项目级的
DESIGN.md;如果存在,应将其视为本地路由说明,然后再阅读选定的捆绑风格。 - 避免使用通用的 AI UI 默认样式。采用所选风格的具体设计令牌和组件惯例。
- 对于有特定文件编码要求的项目,请遵循项目本地说明。
快速命令
从技能根目录列出可用风格:
Get-Content -LiteralPath '.\STYLE_INDEX.txt'
从技能根目录读取一种风格:
Get-Content -Raw -Encoding UTF8 -LiteralPath '.\design-md\linear.app\DESIGN.md'
评论
支持 Markdown