Community影像github.com

font-design

設計、建構並部署客製化可變字型(variable web font),專為品牌繪製,並通過三輪概念頁面挑選。

font-design 是什麼?

這項技能(skill)能用於設計、建構並部署一個自架的客製化可變網頁字型,專為特定品牌繪製,並透過三輪概念頁面進行挑選。它適用於當操作者想要為網站繪製、製作或建構一個獨一無二、專屬或品牌專用的字型或字體;需要一個標題、展示、標題區或主視覺字型,且希望是為其量身繪製而非從目錄中挑選;想要自己的字型而不是 Google Fonts 或現有庫存字體;需要一個文字商標或標誌衍生的字體、一個帶有字重或光學尺寸軸的可變字型,或是為此類字型新增斜體或新的字重;或當操作者要求「製作一個像 Bract 或 Driftwood 的字型」、調整、擴展或重新審查此類字型,或執行概念頁面光譜以獲得全新外觀。觸發條件是繪製或建構字體的意圖,而非單純的「標題」、「展示」或「主視覺」等詞彙。此技能不適用於推薦、挑選或搭配現有字型(包括標題、展示或主視覺字型,這些請改用 frontend-design 技能),也不適用於內文字型。

相容平台✓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 的新對話。

說明文件

font-design 是做什麼的?

版本 0.2.0 — 唯一權威來源是倉儲根目錄下的 VERSION 檔案;此行、frontmatter 以及 README 徽章(badge)會由 tests/test_versions_and_skill.py 比對。開始時請說出此版本號,以便操作者知道是哪個版本的回應。

此技能以製作 Bract(hopsafari.com,2026-11-15)的方式來製作字型:執行以下九個階段,完整運行一次。產生器及許多規則源自較早的字型 Driftwood(movingavg.com,2026-11-14),該字型是在此流程被記錄下來之前,透過一個靜態聯集管線(static union pipeline)建構為五個 CFF 檔案;其經驗教訓及後來發現的三個錯誤塑造了此技能,但 Driftwood 並未經歷這些階段。兩者皆為 John Knox 的設計(NOTICE.md)。工作流程為:稽核網站、推導設計準則、在三輪概念頁面中挑選設計、規劃建構並由他人獨立審查規劃、搭配自我檢查進行建構、在真實頁面上審查建構完成的字型直到某輪未發現問題、讓完成的變更由他人獨立審查、部署。此技能在各閘門(gate)之間以較少監督的方式運行,並在每個閘門處暫停。

目錄

  1. 開始之前
  2. 九個階段(每個階段皆有其閘門)
  3. 在較少監督下運作
  4. 發布封鎖事項
  5. 工具是什麼及其各自證明的項目
  6. 參考索引

1. 開始之前

  1. 說明版本(如上)並分類變更。全站性的展示字型屬重大變更:它會觸及公開頁面,且一旦連結並快取後便難以復原。請遵循完整順序:規劃 → 獨立審查 → 建構 → 獨立審查。若僅是對已審查過的概念進行參數微調,則屬例行作業:建構、測試、一輪設計審查。
  2. 檢查工具並說明哪些已就緒。請執行檢查,而非假設:
    • node --version(≥ 20);此技能自身的虛擬環境(venv)位於 <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 是否存在或缺失,若缺少任何項目,會印出確切的修復指令並以 exit 1 結束。(在虛擬環境建立前,可使用任何 Python 3 執行相同腳本:它僅使用標準函式庫,並會印出建立虛擬環境的指令。)支援 macOS 及 Linux;不支援原生 Windows(bash 腳本、POSIX 虛擬環境路徑);若在 Windows 上,請在 WSL 中執行整個技能。
    • 在首次於某台機器上使用此技能之前,以及每次更新技能之後,請在開始專案前執行 bash scripts/smoke.sh:它會建構三個固定測試案例(fixtures)、執行測試套件及突變測試、執行 FontBakery 閘門(若未安裝 FontBakery 則會跳過並說明)、以及建構概念頁面(--full 會加入瀏覽器步驟及環境檢查)。
    • 若有任何遺漏,請在繼續之前先閱讀 references/fallbacks.md;切勿在未告知的情況下跳過任何閘門,且切勿讓建構者自身的背景資訊同時擔任審查者。
  3. 提出起始問題,使用一則訊息,並將回答逐字記錄在規劃中:以操作者的話語說明目標(此句話會引用給每位審查者);哪個網站及哪些頁面;必須與之並排的內文字型;品牌來源(標誌、顏色、素材、歷史);所需的字重以及是否需要斜體;字型名稱候選者;字型名稱表中的擁有者與授權條款(無預設值 — 每次皆需詢問)以及字型的嵌入權限 names.fs_type(無預設值:4(Preview & Print)是專有字型的常見設定,0(Installable)是開放字型的常見設定;2(Restricted)會導致某些工具拒絕該字型;瀏覽器在網頁字型中會忽略此欄位);大小預算(size budget);概念頁面是否可以發佈為 claude.ai artifacts;是否同意將 artifacts 傳送給 Impasse(第三方供應商);由誰部署以及何時部署。決定專案檔案的存放位置(慣例為網站儲存庫中的 tools/<face>/),但先不要建立任何檔案:每個檔案應在產生其輸入資料的階段中建立 — requirements.json 在階段 2 建立,concepts.js 在階段 3 建立,font.json 及 scripts/ 的副本在階段 7 建立,屆時階段 6 的規劃已確定主軸(masters)與軸線(axes)。在專案進行期間,不得將任何東西寫入已安裝的技能資料夾中:暫存檔案(規劃的匯出、字元集預檢、測量結果)應放在專案的 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 headless 的最小佈局寬度為 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 專案中,在字型的 90a085c 之前的 hop-safari 2daac34):這些是操作者在此閘門判斷的網站設計變更,而概念將在這些頁面上被評判。字型本身的變更從此時開始,並在階段 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 <today's display family> --root 100 150 以取得字型在 16 px 根字體大小及讀者放大根字體大小下必須能正常顯示的尺寸,以及細線下限(hairline floor)(最小尺寸下的一個 CSS px 等於 1000/尺寸 單位;細線應保持在約 0.75 px,使用 --floor-px),並執行 .venv/bin/python3 scripts/mine-charset.py --html <built pages dir> --css <css> --family <today's display family> 以取得這些選擇器在已建構頁面中設定的文字的字元集及其陷阱(標題中的不換行空格(no-break spaces)、以 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.70 px,低於 0.75 的目標,其記錄將其作為待辦事項,而非通過。模板中的數字是虛構的 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 metrics)階段 7,首次建構
accepted_qa_findings([{id, reason, codes?}];codes 限制接受的訊息代碼)FontBakery 閘門的首次運行,每個條目在接受前需讀取;在此之前為 []階段 7

沒有 sizes 鍵:尺寸存在於設計準則及 font.json 的 review.sizes 中。

閘門: 設計準則已撰寫並展示,且明確提出三個決定,每個決定一個問題,並在繪製任何概念之前記錄在設計準則及 requirements.json 中:

  1. 產生器的每個字符

…

[為翻譯緣故而截斷]

相關技能