Construction de page
La qualité de construction vient après la fidélité stratégique, pas avant.
Cette étape assemble la page tout en préservant ce qui compte pour la confiance et la conversion.
Entrées requises
workspace/pages/[nom-page]/strategy.jsonworkspace/brand/profile.mdworkspace/brand/palette.jsonworkspace/pages/[nom-page]/copy.mdworkspace/pages/[nom-page]/visuals/references/anti-slop.md(fourni avec cette compétence)
Si la stratégie est manquante, arrêtez-vous.
Si workspace/pages/[nom-page]/visuals/manifest.json existe, utilisez-le comme source visuelle canonique lisible par machine.
N'ignorez pas les métadonnées du fournisseur lorsqu'elles affectent la confiance, la fidélité ou l'historique de repli.
Hiérarchie de préservation
Appliquez dans cet ordre :
- préserver les conventions de catégorie critiques pour la confiance
- préserver les besoins de communication du mécanisme
- préserver l'identité visuelle de la marque
- améliorer le rythme de mise en page et la qualité de l'interaction
- appliquer des améliorations de goût anti-slop uniquement là où elles ne déforment pas 1 à 4
L'anti-slop est un filtre de qualité, pas une licence de refonte.
Liste de vérification pré-construction
Avant de générer le HTML, confirmez :
- type de page confirmé
- mécanisme de conversion confirmé
- inventaire des preuves chargé
- signaux de confiance sélectionnés
- manifeste visuel résolu en chemins d'image prêts pour la construction
- conventions de catégorie requises préservées
- destination du CTA connue
- choix de mise en page justifié en une ligne
Si l'un d'eux est faux, arrêtez-vous ou rétrogradez.
Logique de routage
Route produit physique
Utilisez lorsque le type de page de la stratégie est axé sur le produit.
Au-dessus de la ligne de flottaison doit inclure :
- visuel clair du produit ou du mécanisme
- titre de l'offre
- CTA
- signal de confiance
Route SaaS / application
Au-dessus de la ligne de flottaison doit inclure :
- capture d'écran ou traitement d'interface utilisateur préservé si requis
- titre de résultat
- signal de confiance
- CTA
Route de capture de leads
Au-dessus de la ligne de flottaison doit inclure soit :
- formulaire + réducteur de friction ou
- CTA clair vers une destination connue
Route d'autorité / service
Doit inclure :
- signal d'autorité au-dessus de la ligne de flottaison
- section de preuve tôt
- traitement des objections autour de la confiance et de l'adéquation
Route réglementée
Doit inclure :
- certitude rétrogradée lorsque la preuve est partielle
- drapeau de révision de conformité dans les métadonnées
Règles de conception
- fichier HTML unique
- responsive aux points de rupture minimum 768px et 1024px
- HTML sémantique
- états de focus visibles
- texte alternatif sur toutes les images
- aucune attribution de constructeur sauf demande explicite
- aucun motif de goût importé qui écrase les signaux de confiance source
Utilisation de l'anti-slop
Chargez references/anti-slop.md et appliquez-le après la hiérarchie de préservation, pas avant.
Table de QA post-construction
Écrivez ceci dans workspace/pages/[nom-page]/qa.md et résumez-le dans meta.json :
| Vérification | Réussi ? | Notes |
|---|---|---|
| mécanisme visible au-dessus de la ligne de flottaison | ||
| preuve primaire visible au-dessus de la ligne de flottaison | ||
| CTA au-dessus de la ligne de flottaison | ||
| signal de confiance au-dessus de la ligne de flottaison | ||
| aucune preuve inventée | ||
| aucun motif slop interdit | ||
| effondrement mobile vérifié | ||
| contraste vérifié | ||
| texte alternatif présent | ||
| convention de catégorie préservée |
Contrat de métadonnées
meta.json doit inclure :
- marque
- page
- type_de_page
- type_de_mécanisme
- route_de_modèle
- destination_du_CTA
- éléments_de_preuve avec résumé de provenance
- présence_de_réduction_de_risque
- drapeaux_de_conformité
- drapeaux_de_révision
- éléments_préservés
- écarts_par_rapport_à_la_source
- images_utilisées
- sections_présentes
- confiance_de_construction
Lorsqu'un manifeste visuel existe, incluez également :
image_heropolitique_du_fournisseur_d_imageimages_utiliséesen tant qu'objets structurés, pas seulement des noms de fichiers nus- contexte du fournisseur et de repli lorsqu'il est pertinent pour la révision ou la QA
Assistant de construction
Utilisez scripts/resolve-visual-assets.py --page-name [nom-page] pour convertir visuals/manifest.json
en métadonnées d'image prêtes pour la construction pour le HTML et meta.json.
Utilisez ensuite scripts/prepare-build-meta.py --page-name [nom-page] --resolved-assets [fichier]
pour fusionner ces actifs résolus dans meta.json avec des champs de sélection déterministes :
image_heroimage_mécanismeimage_mode_de_vieimage_ogemplacements_image.heroemplacements_image.mécanismeemplacements_image.mode_de_vieemplacements_image.og
Utilisez ensuite skills/page-build/scripts/html-image-context.py --meta workspace/pages/[nom-page]/meta.json
pour générer des valeurs littérales prêtes pour le HTML telles que :
hero_img_srchero_img_altmechanism_img_srcmechanism_img_altlifestyle_img_srclifestyle_img_altog_image_path
Constructeur exécutable minimal :
skills/page-build/scripts/build-page.py --page-name [nom-page]Il consommestrategy.json,meta.jsonethtml-image-context.jsonet écrit un véritable squeletteindex.html.
Utilisez les scripts locaux de la compétence comme interface principale pour Cowork ou tout runtime d'agent qui ne télécharge que le dossier de la compétence.
Les copies /scripts à la racine du dépôt sont des commodités de développement local, pas une exigence d'empaquetage.
Référence d'évaluation
Pour les critères de notation et les seuils de réussite, voir skills/page-qa/references/eval-rubric.md.
Pour les motifs anti-slop, voir references/anti-slop.md (fourni avec cette compétence).
Logique d'arrêt / de continuation
Arrêtez-vous si :
- la destination du CTA est inconnue pour une page d'action de lead
- la page dépend d'une preuve qui est manquante
- les signaux de confiance requis ne peuvent pas être étayés
Continuez avec rétrogradation si :
- les actifs visuels sont partiels mais la mise en page de support neutre fonctionne toujours
- la preuve est légère mais la page est recadrée vers des affirmations plus douces
Sortie
Écrivez :
workspace/pages/[nom-page]/index.htmlworkspace/pages/[nom-page]/meta.jsonworkspace/pages/[nom-page]/qa.md
Une construction sans sortie de QA est incomplète.