Adi Design 是一套个人设计语言技能,目标是让 Adi 的每一个应用都感觉像同一个有品味的人做出的一个产品。它的整体气质被描述为“安静的书房”:干净的米白色、鼠尾草色强调、阅读用衬线字体、扁平细线表面、克制的动效。
用途 该技能用于在构建、重新设计或审查 Adi 个人项目的任何 UI 时,应用 Adi 的个人设计语言,使各应用在视觉上保持统一。
主要能力
- 携带一份身份与设计令牌的 vendored 副本,可在任意仓库中构建 Adi 风格的 UI,无需克隆规范仓库。
- 提供设计语言参考文档,包含美学、规则、do's/don'ts 以及各产品注意事项。
- 提供 assets/tokens.css 作为令牌值来源,要求引用令牌变量(如 var(--accent)、--space-lg),而非原始 hex/oklch 字面量。
- 支持按不同技术栈接入令牌:纯 CSS 场景直接复制并 @import 或 link tokens.css;Tailwind 场景导入 tokens.css 获取变量定义,再将 Tailwind 主题指向这些变量,并将正文字体换为 Newsreader、UI 字体换为 Inter,把奶油色背景替换为 --bg。
- 提供硬性规则检查,包括:不使用暖奶油色背景、只用一个强调色(sage)、卡片圆角不超过约 16px、避免边框加厚重阴影的幽灵卡片、阅读正文使用衬线字体。
- 若某产品需要自己的颜色(如图表、地图阶段),可放在核心之后叠加的本地 tokens.local.css 中,不加入共享的 assets/tokens.css。
使用方式
- 阅读 references/design-language.md,了解美学、规则、do's/don'ts 与各产品注意事项。
- 使用 assets/tokens.css(规范仓库的 vendored 副本)获取值,引用令牌变量而非原始色值。
- 按目标技术栈消费令牌的方式接入。
- 应用后对照硬性规则检查。
- 若产品需要自有颜色,使用本地 tokens.local.css 叠加。
规范与展示 规范来源是 ~/GitHub/adi-design 仓库(system/styles.css + system/tokens/),可在 https://design.adithyan.io 在线浏览。它直接在该仓库中编写,没有上游工具,也没有导出步骤。该技能携带身份与令牌的 vendored 副本;当规范的 VERSION 提升时,从该仓库的 system/styles.css 刷新 assets/tokens.css。
与 impeccable 的关系 impeccable 是通用前端工艺引擎,关注对比度、动效、反 slop 禁令以及 build/critique/polish 工作流,有严谨性但刻意没有自己的品牌风格。Adi Design 是缺失的另一半:身份。两者在不同轴上组合——impeccable 是方法(how),Adi Design 是 Adi 的外观(what)。在 Adi 的应用上运行 impeccable 或任何工艺检查时:将 assets/tokens.css 视为已确定的品牌色,不要运行 impeccable 的调色板生成/品牌种子步骤;在这些令牌之上应用 impeccable 的工艺严谨性,而非替代它们;sage 保持唯一强调色,不新增调色板,不使用奶油色背景。
范围与分工 三个技能按轴划分 Adi 的工作:adi-design 负责身份(外观),包括调色板、三种字体、空间/形状、功能强调色与无奶油色规则;impeccable 负责工艺(方法),包括对比度/动效严谨性、反 slop、布局模式选择、build/critique/polish,刻意没有自己的品牌风格;adi-writing 负责语气(文字),让文案与散文听起来像 Adi。在 Adi 的应用上,当它们重叠时,身份在外观上优先。新的经验应归入其所属轴:外观规则归此处,方法规则归 impeccable,语气规则归 adi-writing,单应用实现细节归该应用的本地文档或 tokens.local.css。不要将工艺、内容或应用特定内容并入此技能。
演进语言 美学在规范中变化,而非在此处:直接在 ~/GitHub/adi-design(system/)中编辑,提升 system/VERSION。然后保持此技能同步——从仓库的 system/styles.css 刷新 assets/tokens.css,并更新 references/design-language.md 中的理由以匹配。切勿只在此 vendored 副本中编辑令牌值;仓库是唯一来源。
限制 该技能是 vendored 提取,编写发生在规范仓库中。它不包含上游工具或导出步骤。关于收费、价格、平台支持等具体信息,资料中暂未提供。