Community图像github.com

字体设计

设计、构建并交付一套自定义展示字型,以自托管可变网络字体形式用于网站。

字体设计 是什么?

该技能(font-design)使AI代理能够为网站设计并构建一套完整的自定义展示可变量字体,遵循严谨的九阶段流程,包括:站点审计、指南制定、三轮概念页面设计、独立评审、构建与自查、实页评审以及最终发布。它要求在开始前明确检查所有依赖工具(Node ≥20、特定Python环境、Chrome、Impasse及frontend-design技能),并严格通过每个阶段的“门控”检查点,由操作员决定是否继续。技能文档详细描述了从挖掘站点现有尺寸和字符集、生成设计指南、创建requirements.json,到通过参数化生成器构建可变字体、进行FontBakery质量门控、以及最终使用fontship发布的全过程。它专用于从零“绘制”字型,而非推荐现有字体,并支持macOS和Linux系统(Windows需WSL)。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/windaddict/font-design-skill/tree/HEAD

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

字体设计 是做什么的?

版本 0.2.0 — 唯一权威来源是仓库根目录的 VERSION 文件;此行、前置元数据和 README 徽章均由 tests/test_versions_and_skill.py 进行校验。开始执行时请说出此版本号,以便操作员知晓是哪个副本在响应。

本技能按照制作 Bract(hopsafari.com,2026-11-15)字体的方式制作字型:按顺序完整执行以下九个阶段。生成器和许多规则源自更早的字体 Driftwood(movingavg.com,2026-11-14),该字体在流程被记录之前就已构建,通过静态联合流水线生成五个CFF文件;其经验教训及后来发现的两个缺陷塑造了本技能,但Driftwood并未经历这些阶段。两者均为 John Knox 的设计(参见 NOTICE.md)。工作流程如下:审计站点、推导指南、通过三轮概念页面挑选设计、规划构建并接受独立评审、执行构建并附带自我检查、在真实页面上评审构建好的字体直至某轮未发现问题、对完成的变更进行独立评审、最终发布。本技能在门控之间几乎无需监督即可运行,并在每个门控处停止。

目录

  1. 开始之前
  2. 九个阶段(每个阶段均带有一个门控)
  3. 在较少监督下工作
  4. 发布阻塞项
  5. 工具及其作用
  6. 引用索引

1. 开始之前

  1. 说明版本(见上)并对变更进行分类。全站范围的展示字体是一次重大变更:它会影响公开页面,一旦被链接和缓存,很难撤销。遵循完整顺序:规划 → 独立评审 → 构建 → 独立评审。对于已评审概念内部的参数微调,属于常规变更:构建、测试、一轮设计评审。
  2. 检查工具并说明哪些存在。 执行检查,而非假设:
    • node --version(≥ 20);本技能自身的虚拟环境位于 <skill dir>/.venv,通过在技能目录中执行 python3 -m venv .venv && .venv/bin/pip install -r requirements.txt 创建(包含 fonttools 4.68.x、brotli、skia-pathops、pillow、uharfbuzz、unicodedata2);Chrome($CHROME 或 scripts/shoot.py 按操作系统默认搜索路径查找);Impasse 技能(~/.claude/skills/impasse);frontend-design 插件;以及 Agent 工具提供的最强模型(在本仓库记录中命名为“Fable”;在你所在的环境中使用最强模型)。
    • 本技能中的所有 Python 命令均使用该虚拟环境的解释器执行,并且命令中需明确写出该解释器路径。 请写 .venv/bin/python3 scripts/<tool>.py ...,切勿使用裸写的 python 或 python3,因为在 Homebrew Mac 系统上,后者指向的是另一个没有安装 fonttools 的解释器。任何命令都不能依赖先前 Bash 调用中设置的变量或目录:在大多数主机上,一次调用不会记住上一次调用的状态。“查找技能文件夹”部分说明了如何将短格式命令转换为可从任意目录执行的命令。
    • 首先运行 .venv/bin/python3 scripts/check-env.py。 它会列出平台、Python ≥ 3.10、四个指定版本的需求包、Node ≥ 20、Chrome 和 bash 的存在或缺失状态,为每个缺失项打印确切的修复命令,并在有任何缺失时退出并返回错误码 1。(在虚拟环境存在之前,可使用任意 Python 3 运行同一脚本:它仅使用标准库,并会打印虚拟环境的创建命令。)支持 macOS 和 Linux;不支持原生 Windows(bash 脚本、POSIX 虚拟环境路径);在 Windows 上请使用 WSL 运行本技能。
    • 在机器上首次使用本技能前以及每次更新技能后,均需运行 bash scripts/smoke.sh,然后再开始项目:它会构建三个测试用例,运行测试套件和变异测试,运行 FontBakery 门控(当 FontBakery 未安装时会跳过并说明原因),并构建概念页面(--full 参数会添加浏览器步骤和环境检查)。
    • 对于任何缺失项,请在继续之前查阅 references/fallbacks.md;切勿静默跳过任何门控,也决不能让构建者自己的上下文同时担任评审者。
  3. 提出开场问题,在一条消息中完成,并将答案逐字记录在计划中:
    • 操作员描述的目标原话(此句子将引用给每位评审者);
    • 涉及哪个站点以及哪些页面;
    • 该字体需要搭配的正文字体是什么;
    • 品牌资源(标志、颜色、材质、历史);
    • 需要的字重以及是否需要斜体;
    • 命名候选方案;
    • 名称表的所有者和许可证(无默认值——每次都要询问)以及字体的嵌入权限 names.fs_type(无默认值:4“预览与打印”是专有字体的常见设置,0“可安装”用于开放字体;2“受限”会导致某些工具拒绝该字体;浏览器在网页字体中忽略此字段);
    • 大小预算;
    • 概念页面是否可以作为 claude.ai 工件发布;
    • 同意将工件发送给 Impasse(第三方提供商);
    • 谁负责部署以及何时部署。
    • 决定项目文件的存放位置(约定为站点仓库中的 tools/<face>/),但暂不创建任何文件:每个文件将在产生其输入的阶段被创建——requirements.json 在第2阶段,concepts.js 在第3阶段,font.json 和 scripts/ 的副本在第7阶段(第6阶段的规划已确定了主母版和轴之后)。在项目期间,任何内容都不会写入已安装的技能文件夹:临时文件(导出的计划、字符集预检、测量数据)应放在项目自身的 tools/<face>/work/ 目录下,该目录已包含在站点的 .gitignore 文件中。

查找技能文件夹

本文档中所有 scripts/、references/ 和 templates/ 路径均相对于包含此 SKILL.md 的文件夹(即技能文件夹)。每次 Bash 调用时,通过宿主环境获取其绝对路径:

  • Claude Code: ${CLAUDE_SKILL_DIR},由 Claude Code 为当前运行的技能提供。若为空,则使用安装文件夹 ~/.claude/skills/font-design。
  • Codex: Codex 在其可用技能列表中显示的绝对路径。使用该路径,而非猜测的安装文件夹。
  • 任何其他宿主: 包含已加载的 SKILL.md 的目录的绝对路径。从宿主加载文件的位置读取该路径;不要根据哪个安装文件夹存在来做选择。

本文档中的每个命令都以从技能文件夹输入的短格式编写,例如 .venv/bin/python3 scripts/<tool>.py ...。要从其他目录运行某个命令,请在 .venv/bin/python3 和 scripts/ 前面加上技能文件夹的绝对路径,或者以 cd "<skill folder>" && 开始 Bash 调用;将项目自身的文件(font.json、站点根目录)作为绝对路径提供。项目脚本的副本 tools/<face>/scripts/ 以相同方式运行,但使用技能的解释器:<skill folder>/.venv/bin/python3 tools/<face>/scripts/...。

2. 九个阶段

每个阶段均标明其参考文件、产出物以及操作员做出决策的门控。不得自行通过门控。

阶段 1 — 首先审计站点(references/site-audit.md)

为即将发生变化的页面绘制的字体,是为错误的页面绘制的。使用以下命令对构建好的站点进行截图:.venv/bin/python3 scripts/shoot.py OUT --serve <static dir> --pages index.html <page>.html --widths 500 1280 1600 --scales 1 2。Chrome 无头模式的最小布局宽度为 500 px,因此对于 360 px 的阅读宽度,可使用 scripts/narrow.html,shoot.py 会在 __fd/ 路径下提供该页面,它会通过 iframe 报告内部页面的 scrollWidth 与 clientWidth 的对比:.venv/bin/python3 scripts/shoot.py OUT --serve <static dir> --pages __fd/narrow.html --widths 500 --scales 1 --dump-dom --no-sentinel --query url=/<page>.html --query width=360。读取导出的 .dom.html:仅当 <html> 元素同时包含 data-fd-overflow="false" 以及 data-fd-narrow-stage="fonts" 属性时,页面才算通过(后者表示在网页字体加载稳定后进行的测量;在字体加载之前进行的 "load" 阶段测量无效)。审美评审需借助已安装的 frontend-design 插件完成;否则使用 site-audit.md 中的校准列表。列出“AI 迹象”(重复其下方标题的标签、悬停时抬升的盒状卡片、作为装饰的线条、两个导航或两种日期格式、重复或令人困惑的文案、比内容更醒目的 chrome 界面元素),说明每项对字体的影响,并提出哪些应在绘制字体之前修复。使用 templates/reviewer-brief-audit.md 记录审计结果。阶段 1 仅审计并提出建议;在门控之前不进行任何修复。

门控: 操作员选择哪些项目在字体之前修复,哪些等待。然后在一个分支上实施选定的修复,每个修复均有一个测试监听其失败,并在阶段 2 之前将其作为独立的提交(Bract 项目:hop-safari 的 2daac34 提交,位于字体的 90a085c 提交之前):这些是操作员在此门控中判定的站点设计变更,而概念页面将基于这些变更后的页面进行评审。字体变更本身从此之后才开始,并且在阶段 9 之前保持未提交状态;阶段 7 中的“不提交任何内容”即指字体变更。

阶段 2 — 从站点推导指南(references/guidelines.md)

在挖掘之前,找出展示字体设置的所有元素。为两个工具都提供 --family <当前使用的展示字体系列名>(mine-sizes.py <css> --family 'Bodoni Moda';mine-charset.py --html <built pages dir> --css <css> --family 'Bodoni Moda'):每条其 font-family 首先命名该字体的规则,会给出其选择器(包括 @media 块),并打印出列表。在测试站点上手动键入的 h1,h2,.plate-title 遗漏了 .frontis-title、.wordmark 以及一个 15.2 px 的 .num,这导致下限从 44.6 单位移至 49.3 单位。局限性:一个从 body 继承字体的选择器无法被发现(即标题和正文共享一个字体系列的情况),通过 font: 缩写或自定义属性设置的系列也无法读取;此时需要根据模板手动命名选择器,并为家族规则遗漏的任何元素添加 --selectors 参数。运行 .venv/bin/python3 scripts/mine-sizes.py <css> --family <当前展示系列名称> --root 100 150 以获取字体在 16 px 根字号和读者放大的根字号下必须适应的尺寸,以及细线下限(最小尺寸下的一个 CSS px 等于 1000/尺寸 单位;细线应保持在约 0.75 px,--floor-px)。运行 .venv/bin/python3 scripts/mine-charset.py --html <built pages dir> --css <css> --family <当前展示系列名称> 以获取构建页面中这些选择器所设置的文本的字符集及其陷阱(标题中的不间断空格、使用 ASCII ' 输入的撇号、#、+、*、带重音字母,以及浏览器因 text-transform 规则而绘制的字母,该规则可能作用于选择器本身、其后代或文本内部的某个类,而这只有 --css 能检测到)。它无法识别的内容(因此字符集并非精确无误):通过内联样式、脚本或其无法读取的选择器设置的文本(references/guidelines.md 第6节列出了这些情况);请手动命名它们。--titles <file> 参数用于从文件(每行一个标题)读取而非从构建页面读取,--json 参数可提供机器可读的形式。编写指南:尺寸、下限、与正文字体的两个对比轴、字重、大小写、字符集、先前案例的经验教训。

现在从 templates/requirements.example.json 创建 requirements.json。它是经过评审的预期标准,测试将据此比较字体,且其变更只能由操作员决定(参见 docs/plan.md 中的 F002)。每个字段的来源和时机如下:

字段来源时机
required_characters、titlesmine-charset.py --json:required_characters 直接借用;标题来自其最长标题报告和站点的真实标题现在
cmap模板中的值:生成器的字符集加上构建者的引号和空格字形,这在每个项目中都是相同的;extra-glyphs.js 中添加的字形也会在此处添加现在,仅在添加字形时编辑
names开场问题(第1节,第3项):所有者、许可证、供应商现在;如果操作员尚未回答,该字段将保留模板中的占位符,且阶段 7 无法开始(font.json 的 names 从相同答案填充)
groups.*.axes、masters、instances、avar、interpolated_check阶段 6 的计划阶段 6,在 font.json 存在之前
groups.*.hairline_floors阶段 7 首次执行 export.js 的结果(每个主母版的 minStrokeWidth,向下取整),并且服务于最小显示尺寸的每个主母版的测量值必须达到或超过 mine-sizes.py 打印的目标值(1000 × 0.75 / smallest px);低于该目标的测量最小值是设计发现(加粗 thin,或将最小元素移至正文字体,门控决策 3),而非要记录的下限。Bract 的 15.2 px 数字在 0.75 目标下测得 0.70 px,其记录中将其作为未解决问题,而非通过项。模板中的数值是虚构的 Example 字体的。阶段 7,首次导出
groups.*.word_space、hand_kerns同一次首次导出(每个主母版的字间距)以及计划中的手工字偶对阶段 7
size_budget_bytes、fold_units、gasp开场问题(预算)和模板中的值现在
names.fs_type、tables(code_page_range1、prep_hex、mac_names)开场问题(嵌入权限)和模板中的值现在
groups.*.vertical_metrics(ascender、descender、line_gap)首次构建的 vertical metrics written 自我检查输出行,然后进行评审:这是平台读取 hhea 或 typo 表时字体的 line-height: normal 值(不涵盖 win 指标)阶段 7,首次构建
accepted_qa_findings([{id, reason, codes?}];codes 用于限制接受的消息代码)FontBakery 门控的首次运行,每个条目在被接受前均需阅读;在此之前的值为 []阶段 7

没有 sizes 键:尺寸信息存在于指南和 font.json 的 review.sizes 中。

门控: 撰写并展示指南,并明确要求三个决策,每个问题一个,并在绘制任何概念之前记录在指南和 requirements.json 中:

  1. 生成器的每个字符(请继续阅读...)

相关技能