font-design は何をしますか?
バージョン 0.2.0 — 唯一の真実の情報源はリポジトリルートの VERSION ファイルです。この行、フロントマター、READMEバッジは tests/test_versions_and_skill.py によってチェックされます。作業を開始する前にこのバージョン番号を述べてください。これにより、オペレーターはどのコピーが応答しているかを認識できます。
このスキルは、Bract(hopsafari.com、2026-11-15)が作られた方法と同じように書体を作成します。以下の9つのフェーズを一度だけ完全に実行します。ジェネレーターと多くのルールは、以前の書体Driftwood(movingavg.com、2026-11-14)に由来します。Driftwoodはプロセスが文書化される前に、静的なユニオンパイプラインによって5つのCFFファイルにビルドされました。その教訓と後で発見された3つのバグがこのスキルを形成しましたが、Driftwoodはこれらのフェーズを通過していません。どちらもJohn Knoxのデザインです(NOTICE.md)。作業の流れは次のとおりです。サイトを監査し、ガイドラインを導出し、3ラウンドのコンセプトページを通してデザインを選択し、ビルド計画を立てて独立レビューを受け、自己チェックを伴ってビルドし、実ページでビルドされたフォントを何も問題が見つからなくなるまでレビューし、完成した変更を独立レビューに回し、出荷します。スキルは各ゲート間ではほとんど監視なしで実行され、すべてのゲートで停止します。
目次
- 始める前に
- 9つのフェーズ(各フェーズにゲートあり)
- 最小限の監視での作業
- 公開ブロッカー
- ツールの概要とそれぞれの役割
- リファレンスインデックス
1. 始める前に
- バージョンを述べ(上記)、変更を分類します。 サイト全体のディスプレイ書体は重要な変更です。公開ページに影響し、一度リンクされてキャッシュされると元に戻すのが困難です。完全な順序に従ってください。計画 → 独立レビュー → ビルド → 独立レビュー。すでにレビューされたコンセプト内のパラメータ調整は日常的な変更です。ビルド、テスト、1ラウンドのデザインドリル。
- ツールをチェックし、存在するものを述べます。 チェックを実行し、推測しないでください。
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またはOSデフォルトのscripts/shoot.pyが検索するパス); Impasseスキル(~/.claude/skills/impasse);frontend-designプラグイン; そしてAgentツールが提供する最も強力なモデル(このリポジトリの記録では「Fable」という名前。あなたの環境で最も強力なものを使用してください)。- このスキル内のすべてのPythonコマンドは、そのvenvのインタプリタで実行され、コマンドはそれを明示的に指定します。
.venv/bin/python3 scripts/<tool>.py ...と記述し、決して裸のpythonやpython3を使用しないでください。Homebrew Macでは、これらはfonttoolsを持たない別のインタプリタです。どのコマンドも、以前のBash呼び出しで設定された変数やディレクトリに依存してはいけません。ほとんどのホストでは、ある呼び出しが前の呼び出しを記憶しません。「スキルフォルダを見つける」では、ショートフォームを任意のディレクトリから実行可能なコマンドに変換する方法を説明します。 - 最初に
.venv/bin/python3 scripts/check-env.pyを実行します。 これにより、プラットフォーム、Python ≥ 3.10、固定バージョンの4つの要件、Node ≥ 20、Chromeとbashが存在するか欠落しているかがリストされ、欠落している各項目の正確な修正コマンドが出力され、1つでも欠落している場合は終了コード1で終了します。(venvが存在する前は、任意のPython 3で同じスクリプトを実行します。標準ライブラリのみを使用し、venvコマンドを出力します。)macOSとLinuxがサポートされています。ネイティブWindowsはサポートされていません(bashスクリプト、POSIX venvパス)。WindowsではWSL内でスキル全体を実行してください。 - マシンでスキルを初めて使用する前、およびスキルを更新するたびに、プロジェクトを開始する前に
bash scripts/smoke.shを実行します。 これにより、3つのフィクスチャがビルドされ、スイートとミューテーションが実行され、FontBakeryゲートが実行され(FontBakeryがインストールされていない場合はスキップされ、その旨が表示されます)、コンセプトページがビルドされます(--fullはブラウザステップと環境チェックを追加します)。 - 不足しているものがある場合は、続行する 前に
references/fallbacks.mdを読んでください。ゲートを黙ってスキップしたり、ビルダー自身のコンテキストをレビュアーにしたりしないでください。
- 開始質問を1つのメッセージで行い、回答を計画に逐語的に記録します。オペレーターの言葉による目標(この文はすべてのレビュアーに引用されます); どのサイトとどのページか; 隣に配置する本文書体; ブランドソース(マーク、色、素材、歴史); ウェイトとイタリックが必要かどうか; 名前の候補; 名前テーブルの所有者とライセンス(デフォルトなし — 毎回尋ねる)とフォントの埋め込み許可
names.fs_type(デフォルトなし: 4、プレビュー&印刷がプロプライエタリ書体の通常の設定で、0、インストール可能がオープンな書体の設定です。2、制限付きは一部のツールがフォントを拒否します。ブラウザはウェブフォントのこのフィールドを無視します); サイズ予算; コンセプトページをclaude.aiのアーティファクトとして公開してもよいかどうか; アーティファクトをImpasse(サードパーティプロバイダー)に送信することへの同意; 誰がいつデプロイするか。プロジェクトファイルが置かれる場所を決定します(慣例ではサイトリポジトリのtools/<face>/ですが、まだ何も作成しません。各ファイルは、その入力を生成するフェーズで作成されます —requirements.jsonはフェーズ2、concepts.jsはフェーズ3、font.jsonとscripts/のコピーは、フェーズ6の計画がマスターと軸を確定した後のフェーズ7で作成されます。プロジェクト中は、インストールされたスキルフォルダには何も書き込まれません。スクラッチファイル(計画のエクスポート、文字セットの事前チェック、測定値)は、プロジェクトの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/ の両方の前に置くか、Bash呼び出しを cd "<skill folder>" && で開始し、プロジェクト自身のファイル(font.json、サイトルート)は絶対パスで指定します。プロジェクトのスクリプトのコピー tools/<face>/scripts/ も同様に、スキルのインタプリタを使用して実行します: <skill folder>/.venv/bin/python3 tools/<face>/scripts/...。
2. 9つのフェーズ
各フェーズは、そのリファレンスファイル、生成するもの、およびオペレーターが決定するゲートを示します。自分だけでゲートを通過しないでください。
フェーズ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ヘッドレスは最低500pxでレイアウトするため、360pxの読み取りには 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の兆候」(見出しの下にあるラベルの繰り返し、ホバーで浮き上がるボックスカード、装飾としてのルール、2つのナビゲーションまたは2つの日付形式、繰り返されるまたは不可解なコピー、コンテンツよりも目立つクローム)をリストアップし、それぞれがフォントにとって何を変えるかを説明し、フォントが描かれる前にどれを修正するかを提案します。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.2pxの .num を見逃し、これによりフロアが44.6単位から49.3単位に移動しました。制限: body から書体を継承するセレクタは見つかりません(見出しと本文が1つのファミリを共有するサイト)。また、font: ショートハンドやカスタムプロパティを介して設定されたファミリは読み取られません。その場合は、テンプレートからセレクタを手動で指定し、ファミリルールが見逃す要素には --selectors を追加します。.venv/bin/python3 scripts/mine-sizes.py <css> --family <today's display family> --root 100 150 を実行して、16pxのルートと読者が拡大したルートで書体が耐えなければならないサイズ、およびヘアラインフロア(最小サイズでの1CSSピクセルは1000/サイズ単位。ヘアラインは約0.75pxにとどまるべきで、--floor-px)を取得します。また、.venv/bin/python3 scripts/mine-charset.py --html <built pages dir> --css <css> --family <today's display family> を実行して、ビルド済みページでそれらのセレクタが設定するテキストの文字セットとそのトラップ(タイトル内の改行しないスペース、ASCII ' として入力されたアポストロフィ、#、+、*、アクセント付き文字、および text-transform ルールによってブラウザが描画する大文字。これはセレクタ、その子孫、またはテキスト内のクラスに対して --css のみが認識できます)を取得します。認識できないためセットが正確ではないもの: インラインスタイル、スクリプト、または読み取れないセレクタによって書体で設定されたテキスト(references/guidelines.md のセクション6にリストされています)。これらは手動で指定します。--titles <file> は、ビルド済みページの代わりに行ごとに1つのタイトルを読み取り、--json はいずれかの形式で機械可読な出力を提供します。ガイドラインを記述します: サイズ、フロア、本文書体との2軸のコントラスト、ウェイト、ケース、文字セット、先行事例からの教訓。
templates/requirements.example.json から requirements.json を作成します。これはテストがフォントと比較するレビュー済みの期待値であり、オペレーターとのみ変更します(docs/plan.md で F002 を見つける)。各フィールドの出典と時期:
| フィールド | 出典 | 時期 |
|---|---|---|
required_characters、titles | mine-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.2pxの数字は0.75のターゲットに対して0.70pxと測定され、その記録は合格ではなく未解決項目としてそれを保持しています。テンプレートの数値は架空の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 |
requirements.json には sizes キーはありません。サイズはガイドラインと font.json の review.sizes に保存されます。
ゲート: ガイドラインが記述され表示され、3つの決定が明示的に(各項目1つの質問で)尋ねられ、ガイドラインと requirements.json に記録されてから、コンセプトが描画されます。
- 各文字(ジェネレーター…
[翻訳のため省略]