Seitenvisuals
Die Aufgabe ist nicht "hübsche Bilder machen". Die Aufgabe ist, die Conversion zu unterstützen, ohne visuell über das verkaufte Produkt zu täuschen.
Wenn das Produkt, die Verpackung, die Benutzeroberfläche oder die Materialien Präzision erfordern, leite entsprechend weiter.
Erforderliche Eingaben
workspace/pages/[page-name]/strategy.jsonworkspace/brand/profile.mdworkspace/brand/palette.jsonworkspace/pages/[page-name]/copy.md- Vom Bediener bereitgestellte Produktreferenzen, Verpackungsreferenzen, Screenshots oder Bild-Assets
Anbieterrichtlinie
Verwende die Marken-Artefakte der Page Factory als maßgebliche Quelle.
workspace/brand/extract.mdundworkspace/brand/profile.mddefinieren das kanonische Markenverständnis- Das Marken-Onboarding des Anbieters ist unterstützender Kontext für die Bildgenerierung, kein Ersatz für Extraktion oder Profilerstellung
- Bevorzugte Anbieterreihenfolge: Bloom erster Durchlauf, Nano Banana Fallback, dann manuelle/Bediener-Assets, wenn die Bildtreue entscheidend für das Vertrauen ist
Die Anbieterauswahl ist obligatorisch.
Wenn Bloom für den Durchlauf konfiguriert oder erwartet wird, musst du zuerst Bloom überprüfen. Ersetze nicht stillschweigend die Cowork-native Bildgenerierung, generische integrierte Bildwerkzeuge oder Ad-hoc-Bildanweisungen, wenn Bloom der vorgesehene Anbieter ist.
Wenn Bloom nicht konfiguriert, blockiert oder nicht erreichbar ist:
- sage das explizit
- frage den Bediener, ob er:
- Bloom bereitstellen/konfigurieren möchte
- den Nano Banana Fallback verwenden möchte
- manuelle/Bediener-Assets bereitstellen möchte
- fahre nicht stillschweigend mit einem schwächeren Anbieter bei einem vertrauenskritischen Durchlauf fort
Wenn Nano Banana der Fallback-Pfad ist, bestätige, dass der Bediener den erforderlichen Adapter/Befehl oder den API-gestützten Workflow bereitgestellt hat. Gehe nicht davon aus, dass Nano Banana nur existiert, weil der Name in der Dokumentation auftaucht.
Bloom-spezifische Anleitung
Wenn Bloom verfügbar ist:
- überprüfe, ob die Marke bereits in Bloom existiert
- falls nicht, onboarde die Marke von der Quell-URL
- wenn der Bloom-Markenkontext schwach oder unvollständig ist, fülle ihn mit den extrahierten Markenfakten, dem Profil und der Palette des Repos
- lade Produkt-, Verpackungs- oder UI-Referenzen hoch, bevor du exakte Produktaufnahmen generierst
- verwende Bloom-Bearbeitungen/-Größenänderungen, wenn die Basiskomposition stark ist und die Änderungsanforderung eng begrenzt ist
Fallback zu Nano Banana, wenn:
- Bloom nicht verfügbar oder nicht konfiguriert ist
- das Bloom-Onboarding wiederholt fehlschlägt
- Bloom nicht genügend Credits hat
- ein erforderliches Bild nach angemessenen Wiederholungen die visuelle QA-Rubrik nicht besteht
Bevor du zu Nano Banana wechselst, erkläre explizit, warum Bloom nicht verwendet wurde:
- nicht verfügbar
- nicht konfiguriert
- durch Laufzeit blockiert
- QA-Fehler nach Wiederholungen
- nicht genügend Credits
Anbieter-Hilfsprogramm
Verwende den bildanbieterspezifischen Einstiegspunkt des Skills, um die eigentliche Bildgenerierung mit Anbieter-Fallback durchzuführen:
bash skills/page-visuals/scripts/image-provider.sh \
--page-name [page-name] \
--shot-id [shot-id] \
--prompt "[prompt]" \
--preservation-class [exact_product|branded_environment|concept_support]
Verwende skills/page-visuals/scripts/ als primäre Schnittstelle für Cowork oder jede Laufzeit, die nur den Skill-Ordner hochlädt.
Die scripts-Kopien im Repo-Root sind lokale Entwicklungshelfer, keine Verpackungsanforderung.
Erhaltungsklassen
Jede geplante Visualisierung muss vor der Anweisung klassifiziert werden.
1. Exakte Produkterhaltung
Verwende, wenn die Form, Materialien, Verpackung, Benutzeroberfläche oder das Industriedesign des Produkts für Vertrauen oder Verständnis wichtig sind.
Anforderungen:
- Silhouette erhalten
- Proportionen erhalten
- Materialoptik erhalten
- Verpackung, wo relevant, erhalten
- UI/Bildschirminhalt, wo relevant, erhalten
- Referenzen verwenden, wann immer verfügbar
2. Markengeprägte Umgebungserhaltung
Verwende, wenn das Produkt in einem markenspezifischen Kontext platziert werden kann, aber keine perfekte Objekttreue erfordert.
Anforderungen:
- Palette und Zielgruppenwelt abgleichen
- Markenstimmung und Kategorierealismus beibehalten
- Stockfoto-Inszenierung vermeiden
3. Konzeptunterstützendes Bild
Verwende, wenn das Bild erklärend, atmosphärisch oder unterstützend ist und kein vertrauenskritischer Produktnachweis.
Anforderungen:
- den Mechanismus oder den Abschnittszweck unterstützen
- dem Text untergeordnet bleiben
- keine erfundenen Produktdetails einführen
Shot-Priorisierungshierarchie
Generiere in dieser Reihenfolge:
- Proof / Mechanismus-Bild
- Produktklarheits-Bild
- Lifestyle-Aspirations-Bild
- Dekoratives Unterstützungs-Bild
Wenn Zeit oder Budget begrenzt sind, streiche zuerst Nummer 4.
Erforderliche Shot-Plan-Ausgabe
Schreibe workspace/pages/[page-name]/visuals/index.md mit:
# Visualplan: [page-name]
Generiert:
| Shot | Abschnitt | Erhaltungsklasse | Zweck | Erforderliche Referenzen | Status |
|---|---|---|---|---|---|
| hero-1 | hero | exact product / branded environment / concept support | | | planned |
Wenn Bilder tatsächlich generiert werden, erweitere den Plan nach Möglichkeit um Anbieter-Metadaten:
## Anbieterdurchläufe
| Shot | Anbieter | Markenkontextquelle | Quellbild-IDs / Referenzen | Ergebnis |
|---|---|---|---|---|
| hero-1 | bloom | Repo-Profil + Bloom-Onboarding | bloom:img_123, lokale Produktreferenz | approved |
Schreibe auch workspace/pages/[page-name]/visuals/manifest.json mit maschinenlesbaren Feldern für:
- verwendeter Anbieter
- Fallback-Anbieter und Fallback-Grund, falls zutreffend
- Bloom-Marken-ID und Bild-IDs, falls zutreffend
- verwendete Quellreferenzen für den Shot
- lokaler Ausgabepfad
- Status und Notizen
Anweisungsregeln
Füge immer ein:
- beabsichtigten Abschnitt und Zweck
- Erhaltungsklasse
- Kompositionsanforderung
- Palettenrichtung
- Stimmung / Beleuchtung
- Treuebeschränkungen
- explizite Ausschlüsse
Für exakte Produkterhaltung
Die Anweisung muss angeben:
- Objektsilhouette und Proportionen erhalten
- Materialoberfläche erhalten
- Verpackung/UI nur aus Referenz erhalten
- keine erfundenen Texte oder veränderten Markenzeichen
- Referenzen vor der Generierung anhängen oder hochladen, wann immer der Anbieter dies unterstützt
Für markengeprägte Umgebung
Die Anweisung muss angeben:
- Zielgruppenkontext
- authentischer Nutzungsmoment
- Palettenintegration durch Umgebung, Requisiten, Garderobe oder Beleuchtung
- keine standardisierten Stockfoto-Posen
Für Konzeptunterstützung
Die Anweisung muss angeben:
- Abschnittszweck
- Minimalismus / Abstraktionsgrad
- keine erfundenen, behauptungstragenden Details
Screenshot / UI-Handhabung
Wenn die Strategie Screenshot-Handhabung als erforderlich markiert:
- Screenshots oder UI-Referenzen erhalten
- keine frei erfundene UI-Präzision
- wenn keine echten UI-Assets existieren, Flagge setzen und den Shot-Plan zurückstufen
Visuelle QA-Rubrik
Jedes generierte Bild muss bewertet werden:
| Dimension | Punktzahl /10 | Bestehensschwelle |
|---|---|---|
| Abschnitts-Passung | 8 | |
| Palettentreue | 8 | |
| Silhouetten-/Geometrieeue | 8 wenn zutreffend | |
| Materialtreue | 8 wenn zutreffend | |
| Verpackungs-/UI-Treue | 8 wenn zutreffend | |
| Kompositionsklarheit | 8 | |
| Artefaktfreiheit | 9 | |
| Text-Artefaktfreiheit | 10 |
Ablehnen und neu generieren, wenn eine erforderliche Dimension fehlschlägt.
Fehlerlogik
Wenn die exakte Produkttreue wiederholt fehlschlägt:
- verwende keine lockeren Markenstimmungs-Anweisungen mehr
- erfordere engere Referenzen
- stufe auf erhaltene Fotografie oder vom Bediener bereitgestelltes Asset zurück, falls verfügbar
- täusche niemals Exaktheit vor, nur weil das Modell Schwierigkeiten hat
Wenn Bloom der erste Durchlaufanbieter ist und wiederholt fehlschlägt:
- versuche eine anbietereigene Bearbeitung/Größenänderung vor der vollständigen Neugenerierung, wenn das Problem die Komposition oder der Zuschnitt und nicht die Kernqualität ist
- wenn Bloom die QA immer noch nicht besteht, wechsle zu Nano Banana
- wenn beide Anbieter fehlschlagen und der Shot vertrauenskritisch ist, fordere echte Bediener-Assets an
Lasse nicht zu, dass Cowork Bloom stillschweigend durch sein eigenes Standard-Bildverhalten ersetzt. Wenn die Laufzeit nicht auf Bloom zugreifen kann, halte an und sage das.
Evaluierungsreferenz
Für Bewertungskriterien und Bestehensschwellen siehe skills/page-qa/references/eval-rubrik.md.
Übergabe
Nachdem die Bilder genehmigt wurden, führe page-build aus.