Compétence de design Halo
Halo est une manière de concevoir, pas un thème à copier. Il fixe la grammaire (tokens, typographie, motion, accessibilité, mise en page bilingue, QA) et vous laisse le caractère du produit : son visuel signature, les significations des accents, les illustrations, le texte et le son. Le plan d'entraînement dans examples/ et les deux modèles sont des démonstrations des mécanismes, pas un contenu à réutiliser.
Règles de base
- Concevoir par produit. Rédigez le brief d'abord (
templates/brief.md) et choisissez un visuel signature qui correspond à ce produit (docs/00-creative-direction.md). Les anneaux, les pictogrammes d'exercice et le texte d'entraînement sont inappropriés sauf si le produit concerne la fermeture d'objectifs quotidiens. - Plateforme → Halo → bibliothèque éprouvée. N'inventez jamais de mécanismes (
docs/16-libraries.md). - Les tokens sont la seule source de couleur, de courbe et de rayon. Pas de littéraux de couleur en dehors de
tokens/tokens.css;scripts/check_skill.pyapplique cette règle pour le CSS de Halo. - Les deux thèmes, les deux directions, chaque point de rupture sont conçus et testés.
- Les nombres d'abord : étiquette grise → grande valeur d'accent → phrase simple. Les visuels répètent le nombre, ne le remplacent jamais.
- Le mouvement est léger : une courbe, révéler une fois, rien ne boucle, sûr pour la réduction de mouvement. Les mises à jour de données en direct se font sur place et ne se réaniment jamais.
- Pas de logos. L'emplacement de la marque est le nom du produit en texte. Utilisez une marque uniquement si l'utilisateur en fournit une.
- Fini signifie QA passé (
docs/13-qa.md).
Lisez uniquement ce dont la tâche a besoin
Les documents sont courts (moins de 1 500 tokens chacun). Ne lisez pas tout ; acheminez par tâche :
| Tâche | Lire | Commencer par |
|---|---|---|
| Tout nouveau produit ou page | docs/00, docs/02, docs/03, docs/05 | templates/starter.html (application personnelle) ou templates/dashboard.html (données / opérations) |
| Écran dense en données | docs/10, docs/04 | templates/dashboard.html |
| Kurde / Arabe / Persan | docs/08, docs/03 | l'un ou l'autre modèle avec lang=ckb |
| Ajustement mobile | docs/07 | — |
| Mouvement, lumière de bord, défilement | docs/06 | — |
| Son | docs/14 | js/halo-sound.js |
| Icônes ou illustrations | icons/README.md, docs/09 | icons/ |
| Document imprimé ou PDF | docs/11 | templates/print-a4.html |
| React / Next / Tailwind / Vue | docs/17 | — |
| Choix d'une bibliothèque | docs/16 | — |
| Figma ou tokens de design pour d'autres outils | docs/15, tokens/*.tokens.json | — |
| Accessibilité | docs/12 | — |
| Tests | docs/13 | qa/ |
Ne lisez jamais examples/workout-plan/index.html en entier (environ 42k tokens). Recherchez-y un motif spécifique à la place (grep -n "restTimer" …).
Flux de travail
- Brief. Remplissez
templates/brief.md: pour qui c'est, ce qu'ils reviennent vérifier, les 1 à 3 nombres héros, le visuel signature, les significations des accents, le langage d'illustration, l'intensité du mouvement et du son, les surfaces, les langues et les sections. Si la demande est ambiguë, montrez le brief et posez une question ; sinon, énoncez-le dans un court paragraphe et construisez. - Fondation. Liez
tokens/tokens.css,css/halo.css,js/halo.js(plusjs/halo-sound.jsuniquement si le brief inclut du son), et appelezHalo.init({dict}). Polices : Google Sans + IBM Plex Sans Arabic (docs/03). - Composez les sections à partir des composants dans
docs/05:- Construisez le visuel signature avec des pièces existantes :
Halo.rings,Halo.spark,.meteravec un marqueur.target,.bars,.timeline, la grille de statut, ou un héros typographique. Ou inventez-en un qui suit les règles dansdocs/00. - Remplacez tout le contenu du modèle. Si votre page dit "Fermez les anneaux" ou "GPUs en bonne santé" et que le produit n'est pas à propos de cela, vous avez copié.
- Construisez le visuel signature avec des pièces existantes :
- Équilibrez le téléphone et l'ordinateur portable séparément (
docs/04,docs/07). - Bilingue : chaque chaîne va dans le dictionnaire, avec les règles RTL de
docs/08. Si vous écrivez vous-même du kurde, informez l'utilisateur et recommandez une relecture native. - Mouvement et son à l'intensité choisie par le brief (
docs/06,docs/14). - QA, servi via http :
Ajoutez les propres vérifications d'interaction du produit et axe-core. Examinez les captures d'écran à 390 et 1440 dans les deux thèmes.python3 qa/qa_layout.py http://localhost:8000/page.html # 9 largeurs × 2 thèmes × 2 langues python3 qa/qa_touch.py http://localhost:8000/page.html # suite tactile téléphone - Impression si nécessaire : HTML →
scripts/print_pdf.py→ fusionqpdf→scripts/verify_pdf.sh(0 images). Incorporez les polices.ttf.
Liste de vérification avant livraison
- Un brief existe, et le visuel signature correspond au produit (pas des anneaux par défaut, pas de contenu copié).
- Au plus trois significations d'accent, utilisées de manière cohérente ; les accents de texte utilisent
--XT. - Pas de littéraux de couleur en dehors des tokens ; pas de logo non fourni par l'utilisateur.
- Ordinateur portable : colonnes équilibrées, pieds de page alignés, les graphiques remplissent leurs cartes. Téléphone : ≤ 4 contrôles de navigation, cibles de 44 px, pas de défilement latéral à 320.
- RTL :
dir/lang, chevrons inversés, graphiques en miroir,<bdi>autour des termes latins et des unités latines. - Mouvement réduit honoré ; son (le cas échéant) a un interrupteur et n'est jamais le seul signal.
- Sources liées pour les affirmations factuelles ; Annuler pour les actions destructrices.
-
qa_layout.pyetqa_touch.pyréussissent ; aucune erreur de console ; PDF vérifiés vectoriels.
Reproductibilité
make setupinstalle les dépendances épinglées (requirements.txt) et Chromium.make checkvalide la compétence elle-même : liens, tokens synchronisés, pas de couleurs parasites, pas de logos, syntaxe JS, en-tête.make qateste chaque modèle et l'exemple ;make assetsregénère les images du README ;make tokensreconstruit le JSON DTCG.- CI exécute la même chose dans
.github/workflows/qa.yml.
Plan de fichiers
| Chemin | Quoi |
|---|---|
docs/00-creative-direction.md | Lisez d'abord. Brief, catalogue de visuels signatures, significations des accents, langage d'illustration, anti-patrons |
templates/brief.md | Le brief à remplir |
templates/starter.html | Mécanismes d'application personnelle : héros divisé, anneaux, tâches, minuteur, feuille, son |
templates/dashboard.html | Mécanismes de données/opérations : grille de statut, sparklines, jauges avec cibles, mises à jour en direct, mouvement immobile |
templates/print-a4.html | Page d'impression vectorielle |
tokens/ | tokens.css (source de vérité) + DTCG 2025.10 JSON |
css/halo.css · js/halo.js · js/halo-sound.js | Composants · exécution · son calme |
icons/ | Icônes UI (grille Lucide), glyphes, grammaire des pictogrammes + galerie |
docs/01–17 | Principes, couleur, typographie, mise en page, composants, mouvement, téléphone, RTL, icônes, visualisation de données, impression, accessibilité, QA, son, Figma, bibliothèques, frameworks |
qa/ · scripts/ | Suites de tests · impression, vérification, tokens, assets, auto-vérification |
fonts/ | IBM Plex Sans Arabic + Inter (TTF, OFL) pour hors ligne, CI et impression |
examples/workout-plan/ | Un produit complet réalisé avec Halo (site + 4 PDF vectoriels). Référence uniquement. |