Was macht Schriftdesign?
Version 0.2.0 – die alleinige Quelle der Wahrheit ist die Datei VERSION im Repository-Stamm; diese Zeile, die
Frontmatter und das README-Abzeichen werden von tests/test_versions_and_skill.py dagegen geprüft. Nenne
diese Versionsnummer, wenn du beginnst, damit der Operator weiß, welche Kopie antwortet.
Diese Fähigkeit erstellt eine Schriftart so, wie Bract (hopsafari.com, 2026-11-15) erstellt wurde: die neun Phasen
unten, einmal vollständig durchlaufen. Der Generator und viele der Regeln stammen von einer früheren Schrift, Driftwood
(movingavg.com, 2026-11-14), die erstellt wurde, bevor der Prozess niedergeschrieben wurde, durch eine statische Union-Pipeline
in fünf CFF-Dateien; ihre Lehren und die drei später darin gefundenen Fehler haben die Fähigkeit geprägt, aber
sie durchlief diese Phasen nicht. Beide sind Entwürfe von John Knox (NOTICE.md). Die Form der
Arbeit ist: Prüfe die Website,
leite Richtlinien ab, wähle ein Design über drei Runden Konzeptseiten aus, plane den Bau und lasse den
Plan unabhängig überprüfen, baue mit Selbstprüfungen, überprüfe die gebaute Schrift auf echten Seiten, bis eine Runde
nichts mehr findet, lasse die abgeschlossene Änderung unabhängig überprüfen, veröffentliche. Die Fähigkeit läuft mit wenig
Überwachung zwischen den Gates und hält an jedem Gate an.
Inhalt
- Vorbereitung
- Die neun Phasen (jede mit ihrem Gate)
- Arbeiten mit wenig Überwachung
- Veröffentlichungssperren
- Was die Werkzeuge sind und was jedes beweist
- Referenzindex
1. Vorbereitung
- Nenne die Version (oben) und klassifiziere die Änderung. Eine siteweite Display-Schrift ist eine wesentliche Änderung: Sie betrifft öffentliche Seiten und ist schwer rückgängig zu machen, sobald sie verlinkt und gecacht ist. Befolge die vollständige Reihenfolge: Plan → unabhängige Überprüfung → Bau → unabhängige Überprüfung. Eine Parameteranpassung innerhalb eines bereits überprüften Konzepts ist Routine: Bau, Test, eine Designrunde.
- Prüfe die Werkzeuge und nenne, welche vorhanden sind. Führe die Prüfung aus, geh nicht davon aus:
node --version(≥ 20); die eigene venv der Fähigkeit unter<Schriftverzeichnis>/.venv, erstellt mitpython3 -m venv .venv && .venv/bin/pip install -r requirements.txtim Fähigkeitsverzeichnis (fonttools 4.68.x, brotli, skia-pathops, pillow, uharfbuzz, unicodedata2); Chrome ($CHROMEoder der Standard pro Betriebssystem, denscripts/shoot.pydurchsucht); die Fähigkeit Impasse (~/.claude/skills/impasse); dasfrontend-design-Plugin; und das stärkste Modell, das das Agent-Werkzeug bietet (in dieser Repo-Aufzeichnung „Fable“ genannt; verwende, was immer bei dir am stärksten ist).- Jeder Python-Befehl in dieser Fähigkeit läuft auf dem Interpreter dieser venv, und der Befehl schreibt ihn
aus. Schreibe
.venv/bin/python3 scripts/<tool>.py ..., niemals ein bloßespythonoderpython3, was auf einem Homebrew-Mac ein anderer Interpreter ohne fonttools ist. Kein Befehl darf von einer Variable oder einem Verzeichnis abhängen, die in einem früheren Bash-Aufruf gesetzt wurden: Auf den meisten Hosts merkt sich ein Aufruf nicht den letzten. „Das Fähigkeitsverzeichnis finden“ unten sagt, wie man die kurze Form in einen Befehl umwandelt, der von jedem Verzeichnis aus ausgeführt wird. - Führe zuerst
.venv/bin/python3 scripts/check-env.pyaus. Es listet die Plattform, Python ≥ 3.10, die vier Anforderungen in ihren festgelegten Versionen, Node ≥ 20, Chrome und Bash als gefunden oder fehlend auf, gibt den genauen Reparaturbefehl für jede fehlende Komponente aus und beendet sich mit 1, wenn etwas fehlt. (Bevor die venv existiert, führe das gleiche Skript mit einem beliebigen Python 3 aus: Es verwendet nur die Standardbibliothek und gibt den venv-Befehl aus.) macOS und Linux werden unterstützt; natives Windows wird nicht unterstützt (Bash-Skripte, POSIX-venv-Pfade); unter Windows führe die gesamte Fähigkeit in WSL aus. - Führe
bash scripts/smoke.shvor der ersten Verwendung der Fähigkeit auf einem Rechner und nach jedem Update der Fähigkeit aus, bevor du ein Projekt startest: Es baut die drei Test-Fonts, führt die Suite und die Mutationen aus, führt das FontBakery-Gate aus (übersprungen, und so angegeben, wenn FontBakery nicht installiert ist) und baut die Konzeptseiten (--fullfügt die Browser-Schritte und die Umgebungsprüfung hinzu). - Für alles Fehlende lies
references/fallbacks.mdbevor du fortfährst; überspringe niemals ein Gate stillschweigend und lasse niemals den eigenen Kontext des Erbauers der Prüfende sein.
- Stelle die Eröffnungsfragen, in einer Nachricht, und notiere die Antworten wörtlich im Plan:
das Ziel in den Worten des Operators (dieser Satz wird jedem Prüfer zitiert); welche Site und
welche Seiten; die Brotschrift, neben der sie stehen muss; Markenquellen (Logo, Farben, Materialien, Geschichte);
Schriftschnitte und ob eine Kursivschrift gewünscht ist; Namensvorschläge; den Besitzer und die Lizenz der Namenstabelle (kein Standard –
jedes Mal fragen) und die Einbettungserlaubnis der Schrift,
names.fs_type(kein Standard: 4, Vorschau & Druck, ist die übliche Einstellung für eine proprietäre Schrift und 0, installierbar, für eine offene; 2, Eingeschränkt, lässt einige Werkzeuge die Schrift ablehnen; Browser ignorieren das Feld für Webfonts); das Größenbudget; ob die Konzeptseiten als claude.ai-Artefakte veröffentlicht werden dürfen; Zustimmung, Artefakte an Impasse (einen Drittanbieter) zu senden; wer bereitstellt und wann. Entscheide, wo die Projektdateien leben werden (die Konvention isttools/<Schrift>/im Site-Repository), aber erstelle noch nichts: Jede Datei wird in der Phase erstellt, die ihre Eingaben hervorbringt —requirements.jsonin Phase 2,concepts.jsin Phase 3,font.jsonund die Kopie vonscripts/in Phase 7, sobald der Plan von Phase 6 die Master und Achsen festgelegt hat. Während eines Projekts wird nichts in das installierte Fähigkeitsverzeichnis geschrieben: Arbeitsdateien (der Export des Plans, die Zeichensatzvorprüfung, Messungen) gehen untertools/<Schrift>/work/des Projekts, was die.gitignoreder Site benennt.
Das Fähigkeitsverzeichnis finden
Jeder Pfad zu scripts/, references/ und templates/ in dieser Datei ist relativ zu dem Verzeichnis, das
diese SKILL.md enthält, dem Fähigkeitsverzeichnis. Finde seinen absoluten Pfad einmal pro Bash-Aufruf, abhängig vom
Host:
- Claude Code:
${CLAUDE_SKILL_DIR}, das Claude Code für die laufende Fähigkeit bereitstellt. Wo es leer ist, das Installationsverzeichnis~/.claude/skills/font-design. - Codex: der absolute Pfad, den Codex in seiner Liste der verfügbaren Fähigkeiten anzeigt. Verwende diesen Pfad, kein erratenes Installationsverzeichnis.
- Jeder andere Host: der absolute Pfad des Verzeichnisses, das die geladene
SKILL.mdenthält. Lies ihn von dort, wo der Host die Datei geladen hat; wähle nicht zwischen Installationsverzeichnissen danach aus, welches existiert.
Jeder Befehl in dieser Datei ist in der kurzen Form geschrieben, die vom Fähigkeitsverzeichnis aus eingegeben wird,
.venv/bin/python3 scripts/<tool>.py .... Um einen aus einem anderen Verzeichnis auszuführen, setze den absoluten Pfad des
Fähigkeitsverzeichnisses vor sowohl .venv/bin/python3 als auch scripts/, oder beginne den Bash-Aufruf mit
cd "<Fähigkeitsverzeichnis>" &&; gib die eigenen Dateien des Projekts (font.json, das Site-Stammverzeichnis) als absolute
Pfade an. Eine projekteigene Kopie der Skripte, tools/<Schrift>/scripts/, wird auf die gleiche Weise ausgeführt, mit dem Interpreter
der Fähigkeit: <Fähigkeitsverzeichnis>/.venv/bin/python3 tools/<Schrift>/scripts/....
2. Die neun Phasen
Jede Phase nennt ihre Referenzdatei, was sie hervorbringt und das Gate, an dem der Operator entscheidet. Übergehe kein Gate eigenständig.
Phase 1 – Prüfe zuerst die Site (references/site-audit.md)
Eine Schrift, die für Seiten gezeichnet wird, die sich bald ändern, wird für die falschen Seiten gezeichnet. Fotografiere die gebaute Site
mit .venv/bin/python3 scripts/shoot.py OUT --serve <static Verzeichnis> --pages index.html <page>.html --widths 500 1280 1600 --scales 1 2.
Chrome Headless layoutet bei 500 px Minimum, also fotografiere für die 360 px Ansicht scripts/narrow.html,
was shoot.py unter __fd/ ausliefert und was die scrollWidth der inneren Seite gegen ihre
clientWidth in einem Iframe meldet:
.venv/bin/python3 scripts/shoot.py OUT --serve <static Verzeichnis> --pages __fd/narrow.html --widths 500 --scales 1 --dump-dom --no-sentinel --query url=/<page>.html --query width=360.
Lies die ausgegebene .dom.html: Die Seite besteht nur, wenn <html> data-fd-overflow="false" und
data-fd-narrow-stage="fonts" trägt (die Messung nachdem die Webfonts geladen sind; eine "load"-Phasenmessung
wurde vor ihnen durchgeführt und zählt nicht). Führe den ästhetischen Durchlauf mit dem
frontend-design-Plugin durch, wenn installiert; ansonsten verwende die Kalibrierungsliste in site-audit.md. Liste
die „KI-Indizien“ auf (Labels, die die Überschrift darunter wiederholen, Box-Karten, die bei Hover schweben, Regeln als
Dekoration, zwei Navs oder zwei Datumsformate, wiederholter oder rätselhafter Text, Chrome lauter als Inhalt),
sage für jedes, was es für die Schrift ändert, und schlage vor, welche vor dem Zeichnen der Schrift behoben werden sollen. Notiere
die Prüfung mit templates/reviewer-brief-audit.md. Phase 1 prüft und schlägt vor; nichts wird behoben
vor dem Gate.
Gate: Der Operator wählt aus, welche Elemente vor der Schrift behoben werden und welche warten. Dann implementiere
die ausgewählten Korrekturen auf einem Branch, jede bewacht durch einen Test, der beim Scheitern beobachtet wird, und committe sie als eigenen
Commit vor Phase 2 (Bract: hop-safari 2daac34, vor 90a085c der Schrift): Sie sind Site-Design-Änderungen,
die der Operator an diesem Gate bewertet hat, und die Konzepte werden auf diesen Seiten bewertet. Die
Schriftänderung selbst beginnt nach ihnen und bleibt uncommittet bis Phase 9; „nichts committen“ in Phase
7 bedeutet die Schriftänderung.
Phase 2 – Richtlinien von der Site (references/guidelines.md)
Finde jedes Element, das die Display-Schrift setzt, bevor du analysierst. Gib beiden Werkzeugen --family <die aktuelle Display-Familie>
(mine-sizes.py <css> --family 'Bodoni Moda'; mine-charset.py --html <gebautes Seitenverzeichnis> --css <css> --family 'Bodoni Moda'):
Jede Regel, deren font-family sie zuerst nennt, gibt ihre Selektoren,
@media-Blöcke inbegriffen, und die Liste wird ausgegeben. Ein handgeschriebenes h1,h2,.plate-title auf der
Test-Site übersah .frontis-title, .wordmark und ein 15,2 px .num, was den Boden von 44,6
auf 49,3 Einheiten verschob. Die Grenze: Ein Selektor, der die Schrift von body erbt, wird nicht gefunden (eine Site,
deren Überschriften und Fließtext eine Schrift teilen), und eine Schrift, die durch die Kurzschreibweise font: oder eine
benutzerdefinierte Eigenschaft gesetzt wird, wird nicht gelesen; dann nenne die Selektoren von Hand aus den Vorlagen
und füge --selectors für jedes Element hinzu, das die Schriftregel übersieht. Führe
.venv/bin/python3 scripts/mine-sizes.py <css> --family <aktuelle Display-Schriftfamilie> --root 100 150 für die Größen
aus, denen die Schrift bei einer 16 px Basis und einer vergrößerten Basis des Lesers standhalten muss, und die Haarstrich-Untergrenze (ein
CSS-Px bei der kleinsten Größe ist 1000/Größe Einheiten; ein Haarstrich sollte bei etwa 0,75 px bleiben, --floor-px),
und .venv/bin/python3 scripts/mine-charset.py --html <gebautes Seitenverzeichnis> --css <css> --family <aktuelle Display-Schriftfamilie>
für den Zeichensatz des Textes, den diese Selektoren in den gebauten Seiten setzen, und seine Fallstricke (geschützte
Leerzeichen in Titeln, Apostrophe als ASCII ' getippt, #, +, *, akzentuierte Buchstaben und die Großbuchstaben, die
eine text-transform-Regel den Browser zeichnen lässt, auf dem Selektor, auf einem Nachfahren oder auf einer Klasse innerhalb des
Textes, was nur --css sehen kann). Was es nicht sieht, weshalb die Menge nicht exakt ist: Text, der in
der Schrift durch einen Inline-Stil, durch Skript oder durch einen Selektor gesetzt ist, den es nicht lesen kann (references/guidelines.md
Abschnitt 6 listet sie auf); nenne diese von Hand. --titles <Datei> liest einen Titel pro Zeile anstelle von
gebauten Seiten, und --json auf einer der Optionen gibt die maschinenlesbare Form. Schreibe die Richtlinien:
Größen, Boden, die zwei Achsen des Kontrasts mit der Brotschrift, Schriftschnitte, Großschreibung, Zeichensatz, Präzedenzfall-Lehren.
Erstelle jetzt requirements.json aus templates/requirements.example.json. Es ist die überprüfte
Erwartung, gegen die die Tests die Schrift vergleichen, und sie ändert sich nur mit dem Operator (Finden F002
in docs/plan.md). Woher jedes Feld kommt, und wann:
| Feld | Quelle | Wann |
|---|---|---|
required_characters, titles | mine-charset.py --json: required_characters wörtlich; die Titel aus seinem Bericht zum längsten Titel und die echten Titel der Site | jetzt |
cmap | der Wert der Vorlage: der Glyphensatz des Generators plus die Anführungszeichen- und Leerraumglyphen des Erbauers, was für jedes Projekt gleich ist; eine Glyphe, die in extra-glyphs.js hinzugefügt wird, wird auch hier hinzugefügt | jetzt, nur bearbeitet, wenn eine Glyphe hinzugefügt wird |
names | die Eröffnungsfragen (Abschnitt 1, Punkt 3): Besitzer, Lizenz, Lieferant | jetzt; wenn der Operator nicht geantwortet hat, bleibt das Feld als Platzhalter der Vorlage und Phase 7 kann nicht beginnen (font.json names wird aus denselben Antworten gefüllt) |
groups.*.axes, masters, instances, avar, interpolated_check | der Plan aus Phase 6 | Phase 6, bevor font.json existiert |
groups.*.hairline_floors | der erste export.js-Lauf von Phase 7 (minStrokeWidth pro Master, abgerundet), und jeder Master, der die kleinste Displaygröße bedient, muss bei oder über dem Ziel messen, das mine-sizes.py ausgegeben hat (1000 × 0.75 / kleinste px); ein gemessenes Minimum unter diesem Ziel ist ein Designbefund (thin verdicken, oder die kleinsten Elemente zur Brotschrift verschieben, Gate-Entscheidung 3), kein Boden, der notiert wird. Bracts 15,2 px Zahlen lasen 0,70 px gegenüber dem 0,75 Ziel und seine Aufzeichnung führt das als offenen Punkt, nicht als Bestehen. Die Zahlen der Vorlage sind die der fiktiven Beispielschrift | Phase 7, der erste Export |
groups.*.word_space, hand_kerns | derselbe erste Export (sein Wortabstand pro Master) und die handgesetzten Paare des Plans | Phase 7 |
size_budget_bytes, fold_units, gasp | die Eröffnungsfragen (Budget) und die Werte der Vorlage | jetzt |
names.fs_type, tables (code_page_range1, prep_hex, mac_names) | die Eröffnungsfragen (die Einbettungserlaubnis) und die Werte der Vorlage | jetzt |
groups.*.vertical_metrics (ascender, descender, line_gap) | die „vertical metrics written“-Selbstprüfzeile des ersten Baus, dann überprüft: Es ist der line-height: normal der Schrift, wo eine Plattform hhea oder typo liest (Win-Metriken sind nicht abgedeckt) | Phase 7, der erste Bau |
accepted_qa_findings ([{id, reason, codes?}]; codes begrenzt die akzeptierten Meldungscodes) | der erste Lauf des FontBakery-Gates, jeder Eintrag gelesen, bevor er akzeptiert wird; [] bis dahin | Phase 7 |
Es gibt keinen sizes-Schlüssel: Die Größen leben in den Richtlinien und in font.json review.sizes.
Gate: Richtlinien geschrieben und gezeigt, und drei Entscheidungen explizit erfragt, eine Frage
jeweils, und in den Richtlinien und requirements.json notiert, bevor ein Konzept gezeichnet wird:
- **Jedes Zeichen, das der Generator...