Produkt-Kit
Jedes Video eines Produkts greift auf dasselbe Kit zurück, daher wird das Kit einmal extrahiert, einmal genehmigt und wiederverwendet. In der Produktion, aus der diese Skills stammen, war die stückweise Erstellung teuer: Eine Icon-Schriftart wurde ohne Nachfrage heruntergeladen, dann mit Genehmigung, dann dreimal verbreitert, und zwischendurch entnahm ein Subagent zwei Glyphen aus einer Schriftart in einem Browser-Erweiterungsordner; derselbe Demo-Kunde hatte in zwei Videos zwei verschiedene Nachnamen, weil eine Liste von zu vetoenden Namen nie beantwortet wurde; und ein umbenanntes Produkt behielt seinen alten Namen auf dem Bildschirm, bis ein Prüfer es bemerkte.
Bevor du beginnst
- Quellen sind fixiert (
sources.lock,sources/<rolle>/). Falls nicht, führe zuerst source-recon aus: Jede Kit-Datei zitiert den fixierten Commit. - Frage einmalig nach jedem Download, den das Kit benötigt (Schriftart-Pakete, Icon-Pakete, die nicht im Repo sind), in einer einzigen Liste mit Angabe von Was, Woher und ungefährer Größe. Nichts wird ohne dieses Ja heruntergeladen, und niemals aus einem Browser-Profil oder Erweiterungsordner.
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
K="$PVS_HOME/skills/product-kit/scripts"
1. Tokens
Führe den Resolver von ui-spec-from-code für das Theme des Produkts aus und schreibe die Render-Fakten,
die er beschreibt (Runtime-Rem, Theme-Selektor, tatsächlich geladene Schriftarten) nach kit/render-facts.md:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/ui-spec-from-code/scripts/resolve_tokens.py" <product_dir> \
[--theme-selector "<dunkler Selektor>"]
Setze brand.accent in product.yaml aus dem Token, das das Produkt für seine Primärfarbe verwendet, und zitiere es.
2. Schriftarten
Finde heraus, welche Schriftarten die App wirklich lädt (Link-Tags, @font-face, Schriftart-Pakete in der Lockdatei),
nicht nur die aus CSS-Namen. Nimm die Dateien aus dem Repo oder aus dem installierten Paket (z.B.
ein @fontsource/<family>-Paket in node_modules); eine Schriftart, die nur auf einem Web-Font-Dienst
existiert, benötigt die Zustimmung des Benutzers zum Herunterladen. Erstelle dann einen Subset:
"$PVS_HOME/bin/pvs-py" "$K/subset_fonts.py" <product_dir> <font files...> \
[--text-file videos/*/audio/lines.tsv] [--license OFL-1.1] [--source <Quellenangabe>]
Es schreibt kit/fonts/<family>-<weight>.woff2, erstellt kit/fonts/fonts.css neu (font-display
block, damit ein Render nie zuerst einen Fallback malt), kopiert den Lizenztext, den es neben der
Schriftart oder in ihrem Paket findet (die OFL verlangt, dass der Text mit der Schriftart reist), und zeichnet Quelle,
Lizenz und Lizenzdatei in kit/fonts/fonts.md auf. Eine Schriftart mit einer „unbekannten“ Lizenz oder einer
„fehlenden“ Lizenzdatei ist nicht fertig: Finde sie oder frage nach. Setze
brand.font in product.yaml. Für eine Icon-Schriftart, die über Ligaturen funktioniert, übergib --all-features und
die Ligaturnamen als --text, und überprüfe, dass jeder Name als Glyphe und nicht als Buchstaben gerendert wird.
3. Icons
Hole die Liste der Icons aus der Icon-Extraktion von ui-spec-from-code (oder den Spezifikationen), gruppiert nach Paket. Kopiere sie aus den eigenen Paketen des Produkts:
"$PVS_HOME/bin/pvs-py" "$K/collect_icons.py" <product_dir> --package <verzeichnis mit svg-dateien> \
--names calendar,check,plus [--variant outline/24] [--prefix bx-] [--clean]
Es kopiert jedes SVG nach kit/icons/<set>-<name>.svg und fügt eine Zeile in kit/icons/icons.md hinzu
(Datei, Name, Set, Quellenangabe, Lizenz). Es schlägt bei einem fehlenden oder mehrdeutigen Namen fehl, anstatt
ein ähnlich aussehendes Icon zu wählen, denn ein beinahe passendes Icon war der Grund, warum ein Prüfer einen ganzen ersten Schnitt ablehnte.
Icons, die nur als Icon-Schriftart existieren: Erstelle einen Subset der Schriftart (Abschnitt 2) und nimm die Codepoints aus dem
eigenen CSS der Bibliothek; der Build muss bei einem unbekannten Namen fehlschlagen.
4. Logos
Nur aus den Assets des Repos (oder einem vom Benutzer übergebenen Brand-Paket): Niemals neu gezeichnet, nachgezeichnet oder von einer Website übernommen. Liste die Kandidaten auf, betrachte sie, kopiere dann die drei Varianten:
"$PVS_HOME/bin/pvs-py" "$K/collect_logos.py" <product_dir> # Kandidaten in sources/
"$PVS_HOME/bin/pvs-py" "$K/collect_logos.py" <product_dir> --light frontend/assets/logo.svg \
--dark frontend/assets/logo-white.svg --tile frontend/public/icon-512.png [--root <brand ordner>]
Es schreibt kit/logos/logo-light.* (für helle Hintergründe), logo-dark.* (für dunkle
Hintergründe) und app-tile.* (das quadratische Icon), SVG, wenn das Produkt eines hat, mit einer zitierten Zeile
jeweils in kit/logos/logos.md; es lehnt URLs ab. Setze dann brand.logo_light, brand.logo_dark
und brand.app_tile in product.yaml auf die Pfade, die es ausgibt. Wähle die Variante nach Hintergrund in
jedem Video: Ein helles Zeichen auf einer weißen Seite verschwindet, was in der Quellproduktion passiert ist.
5. Besetzung
Demodaten sind ab dem ersten Frame fiktiv und in jedem Video gleich. Lese
references/cast-and-names.md für die reservierten Nummernbereiche und Domains. Schlage eine vollständige Besetzung
in einer einzigen geschlossenen Frage vor, mit deinem Vorschlag als empfohlenem Standard:
Demo-Besetzung für jedes Acme Tasks Video (empfohlen: so verwenden): Northwind Bakery, Portland OR (northwind.example); Inhaberin Maya Lindqvist, [email protected]; Kunde Omar Haddad, +1 503 555 0172. Verwenden, oder welche Namen ändern?
Vollständige Namen, ein Nachname pro Person, für immer behalten; Nummern im Bereich 555-0100 bis 555-0199; E-Mails und
Websites auf reservierten Domains. Prüfer legen ein Veto gegen Namen aus Geschmacksgründen ein (ein blander Name wurde in der Quellproduktion
abgelehnt), also frage, bevor etwas animiert wird. Wenn der Prüfer nicht antwortet, sage, dass du den
Vorschlag einfrierst, und friere ihn ein: Stille darf nicht zwei Versionen einer Person hinterlassen. Schreibe es
als cast: in product.yaml und überprüfe es:
"$PVS_HOME/bin/pvs-py" "$K/check_cast.py" <product_dir>
Es schlägt fehl bei einem fehlenden Nachnamen, einem Vornamen mit zwei Nachnamen, einer nicht-555- oder nicht-fiktiven Telefonnummer und einer E-Mail oder Website auf einer echt aussehenden Domain.
6. Namen, Aussprachen, verbotene Begriffe
Frage den Benutzer, schreibe dann in product.yaml:
names: Kanonischer Name zu den Legacy-Strings, die niemals erscheinen dürfen (alte Produktnamen, die die Live-UI oder der Code möglicherweise noch anzeigt). Jedes Video verwendet den kanonischen Namen, auch wenn die echte UI hinterherhinkt, und grep findet die Legacy-Namen vor einem Render.pronounce: Markenwörter zur Schreibweise, die die Sprach-Engine richtig ausspricht (ein erfundener Produktname, der als ein anderes Wort gelesen wurde, wurde in der Quellproduktion mit dem Ohr erkannt).banned_terms: Wettbewerber, Drittanbieter, die das Team vom Bildschirm fernhält, echte Kunden, interne Codenamen.never_sayundpositioning: Die einzeilige Identität und die Formulierungen, die sie niemals annehmen darf.
7. Schreibgeschützte Tools
Fülle Abschnitt 10 von kit/RULES.md, „Schreibgeschützte Tools“ (die Vorlage enthält einen
Platzhalter), mit den API- oder MCP-Tools des Produkts, die Agenten aufrufen dürfen
(Dokumentationen, Kataloge, Vorlagen), und sage, dass alles andere tabu ist. Eine Verbindung mit Schreibzugriff
bleibt durch diese Regel schreibgeschützt; empfiehl einen auf schreibgeschützt beschränkten Zugang, denn in der
Quellproduktion wurde Schreibschutz nur durch Anweisung erzwungen.
8. Bericht
Zeige dem Benutzer das Kit-Inventar (Token-Anzahl und -Flags, Schriftarten mit Lizenzen, Icons nach Set, Logos, Besetzung), was noch Genehmigung benötigt, und die product.yaml-Schlüssel, die du geändert hast.