ハローデザインスキル は何をしますか?
ハローは設計の方法であり、コピーするテーマではありません。文法(トークン、タイポグラフィ、モーション、アクセシビリティ、バイリンガルレイアウト、QA)を固定し、プロダクトの個性(シグネチャービジュアル、アクセントの意味、イラスト、コピー、サウンド)はあなたに委ねます。examples/ にあるワークアウトプランと2つのテンプレートはメカニクスのデモであり、再利用するためのコンテンツではありません。
基本ルール
- プロダクトごとにデザインする。 まずブリーフ(
templates/brief.md)を書き、このプロダクトに合ったシグネチャービジュアルを選ぶ(docs/00-creative-direction.md)。リング、エクササイズピクトグラム、ワークアウトコピーは、プロダクトが「一日の目標を達成する」ことをテーマにしている場合にのみ使用する。 - プラットフォーム → ハロー → 実績のあるライブラリ。メカニズムを発明してはならない(
docs/16-libraries.md)。 - トークンが色・曲線・半径の唯一の情報源である。
tokens/tokens.cssの外にカラーリテラルを記述してはならない。scripts/check_skill.pyがハローのCSSに対してこれを強制する。 - 両方のテーマ、両方の方向、すべてのブレイクポイント を設計しテストする。
- 数値優先: 灰色ラベル → 大きなアクセント値 → 平易な文。ビジュアルは数値を繰り返し、決して置き換えない。
- モーションは控えめに: 1つのカーブ、1回だけ表示、ループなし、動きを減らす設定に安全。ライブデータはその場で更新され、決してアニメーションを再実行しない。
- ロゴは使わない。 ブランドスロットはプロダクト名のテキスト。ユーザーが提供した場合にのみマークを使用する。
- 完了=QA合格(
docs/13-qa.md)。
タスクに必要なものだけ読む
ドキュメントはそれぞれ短い(各1,500トークン未満)。すべてを読む必要はなく、タスクに応じてルーティングする:
| タスク | 読むドキュメント | 開始点 |
|---|---|---|
| 新しいプロダクトまたはページ | docs/00, docs/02, docs/03, docs/05 | templates/starter.html(個人向けアプリ)または templates/dashboard.html(データ/運用) |
| データ量の多い画面 | docs/10, docs/04 | templates/dashboard.html |
| クルド語/アラビア語/ペルシア語 | docs/08, docs/03 | どちらかのテンプレート、lang=ckb を設定 |
| 電話向け調整 | docs/07 | — |
| モーション、リムライト、スクロール | docs/06 | — |
| サウンド | docs/14 | js/halo-sound.js |
| アイコンまたはイラスト | icons/README.md, docs/09 | icons/ |
| 印刷文書またはPDF | docs/11 | templates/print-a4.html |
| React / Next / Tailwind / Vue | docs/17 | — |
| ライブラリの選択 | docs/16 | — |
| Figmaまたは他ツール向けデザイントークン | docs/15, tokens/*.tokens.json | — |
| アクセシビリティ | docs/12 | — |
| テスト | docs/13 | qa/ |
examples/workout-plan/index.html 全体は読まないこと(約42kトークン)。代わりに特定のパターンを検索する(grep -n "restTimer" …)。
ワークフロー
- ブリーフ。
templates/brief.mdを記入:誰のためか、ユーザーが何を確認しに戻ってくるか、1~3つのヒーロー数値、シグネチャービジュアル、アクセントの意味、イラスト言語、モーションとサウンドの強度、サーフェス、言語、セクション。リクエストがあいまいな場合は、ブリーフを示して1つ質問する。それ以外は短い段落で説明し、構築を開始する。 - 基盤。
tokens/tokens.css、css/halo.css、js/halo.js(ブリーフにサウンドがある場合はjs/halo-sound.jsも)をリンクし、Halo.init({dict})を呼び出す。フォント:Google Sans + IBM Plex Sans Arabic(docs/03)。 - セクションを構成する
docs/05のコンポーネントを使用:- 既存の部品でシグネチャービジュアルを構築:
Halo.rings、Halo.spark、.targetマーカー付き.meter、.bars、.timeline、ステータスグリッド、またはタイポグラフィックヒーロー。またはdocs/00のルールに従ったものを発明する。 - すべてのテンプレートコンテンツを置き換える。あなたのページに「リングを閉じる」や「GPUは正常」と表示されていて、プロダクトがそれに関するものでなければ、コンテンツをコピーしたことになる。
- 既存の部品でシグネチャービジュアルを構築:
- 電話とラップトップを別々にバランス調整する(
docs/04、docs/07)。 - バイリンガル: すべての文字列を辞書に入れ、
docs/08のRTLルールを適用する。自分でクルド語を書く場合は、その旨をユーザーに伝え、ネイティブによるレビューを推奨する。 - モーションとサウンド はブリーフが選択した強度で(
docs/06、docs/14)。 - QA、 http経由で実行:
プロダクト固有のインタラクションチェックとaxe-coreを追加する。390と1440の両テーマでスクリーンショットをレビューする。python3 qa/qa_layout.py http://localhost:8000/page.html # 9幅 × 2テーマ × 2言語 python3 qa/qa_touch.py http://localhost:8000/page.html # 電話タッチスイート - 印刷 が必要な場合:HTML →
scripts/print_pdf.py→qpdfマージ →scripts/verify_pdf.sh(画像0)。.ttfフォントを埋め込む。
デリバリー前チェックリスト
- ブリーフが存在し、シグネチャービジュアルがプロダクトに適合している(デフォルトでリングを使っていない、コピーコンテンツではない)。
- アクセントの意味は最大3つで、一貫して使用されている。テキストアクセントは
--XTを使用。 - トークン外のカラーリテラルなし。ユーザーが提供していないロゴなし。
- ラップトップ:カラムのバランスが取れている、フッターが揃っている、チャートがカードを埋めている。電話:ナビゲーションコントロール ≤ 4、タップターゲット44px、320pxで横スクロールなし。
- RTL:
dir/lang、反転した山形、ミラーリングされたチャート、ラテン語用語とラテンユニットの周りに<bdi>。 - 動きを減らす設定が尊重されている。サウンド(ある場合)にはトグルがあり、決して唯一の信号ではない。
- 事実に基づく主張には情報源がリンクされている。破壊的なアクションには「元に戻す」機能がある。
-
qa_layout.pyとqa_touch.pyが合格。コンソールエラーなし。PDFはベクター形式と確認済み。
再現性
make setupで固定された依存関係(requirements.txt)とChromiumをインストール。make checkでスキル自体を検証:リンク、同期されたトークン、未使用の色なし、ロゴなし、JS構文、フロントマター。make qaですべてのテンプレートとサンプルをテスト。make assetsでREADME画像を再レンダリング。make tokensでDTCG JSONを再構築。- CIは
.github/workflows/qa.ymlで同じものを実行。
ファイルマップ
| パス | 説明 |
|---|---|
docs/00-creative-direction.md | 最初に読むこと。 ブリーフ、シグネチャービジュアルカタログ、アクセントの意味、イラスト言語、アンチパターン |
templates/brief.md | 記入するブリーフ |
templates/starter.html | 個人向けアプリのメカニクス:分割ヒーロー、リング、タスク、タイマー、シート、サウンド |
templates/dashboard.html | データ/運用メカニクス:ステータスグリッド、スパークライン、ターゲット付きメーター、ライブ更新、静的モーション |
templates/print-a4.html | ベクター印刷ページ |
tokens/ | tokens.css(真実の情報源)+ DTCG 2025.10 JSON |
css/halo.css · js/halo.js · js/halo-sound.js | コンポーネント · ランタイム · 穏やかなサウンド |
icons/ | UIアイコン(Lucideグリッド)、グリフ、ピクトグラム文法 + ギャラリー |
docs/01–17 | 原則、色、タイポグラフィ、レイアウト、コンポーネント、モーション、電話、RTL、アイコン、データ可視化、印刷、アクセシビリティ、QA、サウンド、Figma、ライブラリ、フレームワーク |
qa/ · scripts/ | テストスイート · 印刷、検証、トークン、アセット、自己チェック |
fonts/ | IBM Plex Sans Arabic + Inter(TTF、OFL)オフライン、CI、印刷用 |
examples/workout-plan/ | ハローで作られた完全なプロダクト一例(サイト + 4つのベクターPDF)。参照のみ。 |