Was macht Isometrics (Line-Stil)?
Du verwandelst eine kurze Aufgabenstellung ("Galerie-Isometrie", "ein leerer Posteingang") in ein gezeichnetes, animiertes Objekt, das als kompletter Zustand ausgeliefert wird: die Illustration, eine Überschrift, ein Textabsatz und ein Button. Jedes Objekt wird aus 3D-Primitiven in Weltkoordinaten aufgebaut und in echter Isometrie projiziert, sodass es ein gemeinsames Raster, eine gemeinsame Kontur und ein gemeinsames Aussehen mit jedem anderen mit diesem Skill erstellten Objekt teilt.
Das Aussehen, in einem Satz: ein Objekt, frontal, wenn es flach ist, oder im echten isometrischen Winkel, wenn es kastenförmig ist, eine 1-Px-Kontur auf papierweißen Flächen, ein kleines Markenzeichen in der Markenfarbe, kein Schatten, kein Glühen, ein Bewegungsmoment und dann Stille.
Du überspringst keine Phasen. Du erklärst ein Objekt erst dann für fertig, wenn der Checker bestanden wurde und du dir das Blatt angesehen hast.
Inhalt
| Datei | Lies es |
|---|---|
SKILL.md | immer: der Workflow und die Regeln |
references/brief-to-concept.md | Phase 1–2: eine vage Aufgabenstellung in drei Konzepte verwandeln |
references/motion.md | Phase 4: Auswahl und Timing des Bewegungsmoments |
references/line-style.md | Phase 3–5: jede Zeichenregel, Dos and Don'ts, mit Begründung |
references/engine-api.md | während des Bauens: die Engine und das Line-Kit |
references/isometric-math.md | wenn eine Form Mathematik benötigt, die die Engine nicht hat |
examples/*.tsx | vor dem Bauen: mit dem ähnlichsten Beispiel beginnen |
engine/iso-core.tsx, engine/iso-line.tsx | einmal in das Benutzerprojekt kopieren |
scripts/check.mjs | Phase 5: die strenge Renderprüfung |
Einrichtung (einmal pro Projekt)
Die Objekte sind React-Client-Komponenten für ein Projekt mit Tailwind CSS und shadcn/ui (sie verwenden @/lib/utils cn und @/components/ui/button) und das motion-Paket.
-
Prüfe, ob
components/isometrics/iso-core.tsxvorhanden ist. Wenn es fehlt, kopiereengine/iso-core.tsxundengine/iso-line.tsxaus diesem Skill incomponents/isometrics/(oder den Ordner, den der Benutzer bevorzugt; Objekte importieren sie relativ, also leben sie alle in einem Ordner). -
Wenn das Projekt kein
motionhat: installiere es (npm i motion, oder den Paketmanager des Projekts). Wenn es keinen shadcn Button hat:npx shadcn@latest add button. -
Für den Checker, Playwright:
npm i -D playwrightundnpx playwright install chromium(oder es verwendet ein installiertes Chrome). -
Eine Seite, um ein Objekt allein zu rendern, eingewickelt in
PlayOnHover(der Checker spielt es durch Hover ab), z.B.app/isometrics-preview/<name>/page.tsxin Next.js, oder eine Route im eigenen Router des Projekts:import { PlayOnHover } from "@/components/isometrics/iso-line"; import { MapPin } from "@/components/isometrics/map-pin"; export default function Page() { return ( <main className="flex min-h-svh items-center justify-center p-10"> <PlayOnHover><MapPin /></PlayOnHover> </main> ); }Erstelle es pro Objekt; teile dem Benutzer mit, dass es sich um eine Vorschauseite handelt, die er löschen kann.
Bearbeite niemals die Engine, um ein einzelnes Objekt zum Laufen zu bringen. Wenn eine Form wirklich fehlt, füge einen Helfer innerhalb der Datei des Objekts hinzu, der aus 3D aufgebaut ist, und informiere den Benutzer.
Der Workflow
Phase 1 · Aufgabenstellung lesen
Wandle die Anfrage in drei Antworten um, bevor irgendetwas anderes passiert:
- Thema: das Ding oder Thema ("Galerie" → Fotos, Alben, Bilder).
- Verwendung: welchen Zustand es bedient: leer (noch nichts hier), gesperrt (kein Zugriff, aus, nicht verbunden, nicht gefunden), nichts gefunden (Suche, Filter), erfolgreich / alles klar, oder eine Spot-Illustration in einer Feature-Karte.
- Botschaft: ein einfacher Satz, den der Zustand sagt ("Du hast noch keine Fotos").
Wenn die Verwendung nicht angegeben ist, passt die Aufgabenstellung normalerweise auf mehrere; dafür sind die Konzepte da. Siehe references/brief-to-concept.md.
Phase 2 · Drei Konzepte, dann warten
Sofern die Aufgabenstellung nicht bereits ein Objekt und einen Zustand nennt, zeige dem Benutzer drei Konzepte als Tabelle und stoppe und warte auf seine Auswahl:
| Objekt | Botschaft (Überschrift) | Das eine Bewegungsmoment | |
|---|---|---|---|
| A ★ | … | … | … |
| B | … | … | … |
| C | … | … | … |
Jedes Konzept muss alle vier Tests bestehen:
- Lesbar in Kontur bei 120 px. Eine Silhouette, die Menschen ohne Farbe erkennen.
- Abgerundet schlägt kastenförmig. Abgerundete Objekte wirken freundlicher in Linien; ein schlichtes Kästchen wirkt wie ein Paket oder ein Drahtgitter.
- Ein Objekt. Keine Szene, kein Stapel. Ein zweiter kleiner Teil ist nur in Ordnung, wenn er zum Objekt gehört (ein Deckel, eine Fahne, eine Hand).
- Das Bewegungsmoment sagt die Botschaft aus. Die Bewegung ist das Verb des Satzes (siehe
references/motion.md). Wenn du das Bewegungsmoment nicht benennen kannst, ist es das falsche Objekt.
Markiere deine Empfehlung mit ★ und begründe sie in einem Satz. Variiere die drei: verschiedene Objekte, verschiedene Bewegungsmomente. Wenn die Aufgabenstellung spezifisch ist ("ein leerer Posteingang mit einem Tablett"), überspringe die Tabelle, nenne deine Wahl und das Bewegungsmoment und fahre fort.
Phase 3 · Das Objekt in Teile zerlegen
Schreibe vor dem Code eine Teiletabelle in Weltkoordinaten: jedes Teil, das Primitiv, aus dem es aufgebaut ist (Extrude, Slice, Ring, FacePath, Box…), seine Größe und Position auf dem 0.5-Raster, ob es sich bewegt, und welches Teil das Markenzeichen ist. Dann der Text: Überschrift (≤ 28 Zeichen), ein oder zwei Sätze, Button-Beschriftung (≤ 22 Zeichen) und sein Icon (das Icon folgt dem Verb: ein Plus nur dort, wo die Aktion etwas hinzufügt).
Regeln, die Teile bestimmen (alle in references/line-style.md):
- Wähle zuerst die Ansicht. Flache oder dünne Dinge (eine Seite, ein Abzeichen, eine Scheibe) haben
view="front"; kastenförmige oder tiefe Dinge (ein Drucker, eine Kiste, ein Server, ein Tablett, ein Stift, der auf einem Schreibtisch liegt) haben `view="isometric"". Frontale Kästchen wirken wie flache Aufkleber mit doppelten Linien. - Baue mit Blickrichtung +y um x = 0, stehend auf z = 0.
- Drei Detailebenen: Form, die Teile, an denen man es erkennt, und ruhige Markierungen (Schrauben, Lüftungsschlitze, Nähte, ein Etikett).
- Saubere Linien: ein frontales Volumen hat keine Tiefe oder eine klare (Streifen ≥ ~4 px); ein Teil ist bündig oder ≥ 0.5 erhaben; runde Stapel teilen sich einen Radius mit einer Nahtlinie.
- Flache Dinge (Papier, Etiketten, Bildschirme) sind Flächen, keine Volumen.
- Runde Volumen sind Scheiben zwischen waagerechten Kreisen, vom Fuß aus gemalt.
- Eine Kontur, die nicht konvex ist, benötigt ihre entfernte Kante gezeichnet.
- Ein Teil, das aus einem Gehäuse herausgleitet, wird am Gehäuse abgeschnitten, nicht schwebend dargestellt.
- Ein Markenzeichen (Palette
main); alles andere ist Papier (surface).
Phase 4 · Das Bewegungsmoment auswählen und schreiben
Wähle die Bewegung aus der Botschaft (references/motion.md), dann schreibe das Storyboard-Kommentar am Anfang der Datei vor dem Zeichencode: Zeitpunkte, was sich bewegt, wie weit, warum. Jeder Wert in einer benannten Konstante. Das Bewegungsmoment wartet 400 ms, nachdem die Grafik in den sichtbaren Bereich gescrollt ist, dauert 1.2–2.4 s und spielt einmal ab. Wenn der Code des Benutzers active übergibt, spielt es jedes Mal, wenn active wahr wird (mit 80 ms Verzögerung), niemals von allein. Reduzierte Bewegung zeigt die Ruheposition.
Phase 5 · Bauen, rendern, prüfen, ansehen, korrigieren
-
Beginne mit dem ähnlichsten Beispiel in
examples/(Tabelle unten). Behalte seine Struktur bei: Storyboard, TIMING, Geometrie, Spuren, Posen, Teile,LineState. -
Rendere es auf seiner Vorschauseite und führe den Checker aus:
node <skill>/scripts/check.mjs http://localhost:3000/<preview-path>/<name> --duration <wait+beat ms>Es rendert hell und dunkel, spielt das Bewegungsmoment ab, indem es über die Grafik hovert (mit einer gefälschten Uhr, also muss die Vorschauseite das Objekt in
<PlayOnHover>einwickeln), speichert Frames bei 0, 25, 50, 75, 100 % und danach, und prüft:- keine Hydratations- oder Konsolenfehler, in hell, dunkel und bei reduzierter Bewegung;
- es spielt, wenn
activeaktiv ist, und es gibt keinen Button innerhalb der Grafik; - das Bewegungsmoment kehrt exakt zu seiner Ruheposition zurück;
- reduzierte Bewegung ist ruhig, zeigt die Ruheposition, ignoriert
active; - jede Kontur ist etwa 1 px; keine Filter, Glühen, Schatten oder Farbverlaufsmalerei;
- die ruhende Zeichnung passt in ihren Rahmen;
- die Zeichnung ist innerhalb von 2 px auf die Überschrift zentriert;
- saubere Linien: höchstens 6 % der Kontur in anhaltenden Dopplungen (zwei Linien 0.5–2 px auseinander entlang einer echten Länge; winzige Kleckse, wo Linien aufeinandertreffen, zählen nicht), in dunkel bei 4× (
lines.png, Dopplungen in rot inlines-marked.png); - seine optische Größe passt zum Set (√(w×h) 140–175 px).
-
Sieh dir
sheet.pngundlines.pngan (beide öffnen) und gehe die folgende Checkliste durch. Der Checker kann kein Design sehen; du kannst es. -
Korrigiere und führe erneut aus. Maximal drei Runden. Wenn nach drei Runden immer noch etwas nicht stimmt, stoppe und teile dem Benutzer genau mit, was, zusammen mit dem Blatt.
-
Bericht: das Konzept, das Storyboard, das Checker-Ergebnis, was du nach dem Ansehen korrigiert hast, was immer noch nicht stimmt, und der Pfad zum Blatt.
Sieh dir das Blatt an: die Checkliste
Lesbarkeit
- Könnte ein Fremder das Objekt ohne die Überschrift in der Größe eines Thumbnails benennen?
- Nichts sieht versehentlich wie ein Gesicht aus (zwei runde Teile über einer Kurve).
- Das Markenzeichen ist ein kleiner Teil, und es ist der Teil, auf den das Auge fallen sollte.
Ruht gerade
- In Ruhe ist jede Senkrechte vertikal und jede Kante waagerecht; nichts lehnt, nichts hängt schief, zweite Blätter sind versetzt, nicht gedreht.
- Die Ruheposition ist gleich der Position bei reduzierter Bewegung (der Checker vergleicht Pixel; du prüfst, ob es beabsichtigt aussieht).
Linien (sieh dir lines.png an: dunkel, 4×)
- Einheitliche Linienstärke überall; keine doppelten Kanten, keine haarfeinen Nähte zwischen Füllungen, keine fehlenden entfernten Kanten an gekrümmten Konturen, keine Füllung, die über eine Kontur hinausragt, keine Linie, die in der Luft endet.
- Jedes Teil ist bündig oder deutlich erhaben (≥ 0.5); keine dünnen Streifen.
Realismus
- Die richtige Ansicht: flache Dinge frontal, kastenförmige Dinge isometrisch.
- Drei Ebenen: Form, erkennbare Teile, ruhige Markierungen. Würde jemand, der so etwas besitzt, sagen "ja, das ist ein Drucker"?
- Der obere Streifen (Dicke aus 30° über der Horizontalen gesehen) ist bei Volumen vorhanden und fehlt bei dünnen Flächen.
Bewegung
- Das Bewegungsmoment sagt die Botschaft aus; jede Bewegung wird durch die vorherige verursacht (eine Verzögerung, ein Durchschwingen, ein Einpendeln).
- Gelenkige Teile schwingen niemals durch ihr Gehäuse; Spitzen kreuzen niemals die Ruhe; Schwingungen bleiben klein (≤ 6° bei einem hängenden Teil, ≤ 25° bei einer Klappe).
- Nichts blendet ein oder aus; Dinge, die erscheinen, wachsen mit Skalierung.
Passt auf die Seite
- Auf den Text zentriert; der Rahmen ist nicht mit totem Raum gepolstert.
- Sieht im Dunkelmodus richtig aus: Papierflächen werden zu dunklem Papier, das Markenzeichen bleibt die Marke.
Nie wieder: Fehler, die dieser Skill gemacht hat
Jeder davon wurde einmal ausgeliefert, in der Überprüfung entdeckt und ist jetzt eine Regel. Bevor du ein Objekt meldest, überprüfe es gegen jede Zeile.
| Fehler | Regel jetzt |
|---|---|
| Frontale Kästchen sahen aus wie flache Aufkleber | Wähle zuerst die Ansicht: flache Dinge frontal, kastenförmige Dinge view="isometric" (line-style.md) |
| Dünne obere Streifen, kaum erhabene Teile und gestufte Ringe zeichneten doppelte, schmutzige Linien | Keine dünnen Streifen; bündig oder ≥ 0.5 erhaben; runde Stapel mit einem Radius; der Saubere-Linien-Test des Checkers muss bestehen, und du siehst dir lines.png an (dunkel, 4×) |
| Objekte waren nur eine Kontur ("nicht realistisch") | Drei Detailebenen: Form, erkennbare Teile, ruhige Markierungen |
| Größen sprangen zwischen Objekten in einem Set | Optische Größe 140–175 px über defaultArtClassName |
| Seiten flogen 3 Einheiten außerhalb des Rahmens | Bewegung bleibt in der Luft der Grafik; höchstens ein wenig über den Rahmenrand hinaus |
| Zwei Riegel, ein vollflächiger Streifen als "ein Markenzeichen" | Ein kleines Markenzeichen, wirklich eines |
| Ein Schlitz über einem Punkt, zwei Riegel über einer Naht sahen aus wie ein Gesicht | Achte auf versehentliche Gesichter in Thumbnail-Größe |
| Eine Eckklappe zum Betrachter hin war frontal unsichtbar | Drehungen zum Betrachter hin wirken nur mit einem Bruchteil ihres Winkels; bevorzuge Bewegungen in der Bildebene oder gehe großzügig (motion.md) |
| Eine Seite, die in ihrer Ebene gekippt war, scherte im isometrischen Winkel | In der isometrischen Ansicht drehe ein Teil nur um seine eigene Normale oder ein Scharnier an seiner Kante (motion.md) |
| Ein Teil blitzte bei der ersten Wiedergabe für einen Frame seine Startposition auf | Teile, die vom Zustand der Uhr gesteuert werden, setzen zurück, wenn der Clip wechselt, und beginnen in Ruhe, wenn sie gehalten werden (engine-api.md) |
| Dünne Tablettwände sahen aus wie dünner Kunststoff | Stabile Wände bekommen Dicke (≥ 0.5); dünne Flächen sind für Papier |
| Jedes Objekt sah einzeln gut aus, das Set nicht | Überprüfe die gesamte Charge nebeneinander, hell und dunkel, bevor du berichtest |
| Ein Glockenkörper, ein Bügel, ein Zeiger einer Nadel zeichneten Doppelkonturen entlang ihrer Kurven | Frontal ist ein gekrümmtes Teil eine flache Fläche (oder eine deutlich tiefe); gib einem Zeiger parallele Seiten, niemals eine Verjüngung |
| Auf der Glaskontur gezeichneter Sand ergab einen dicken Klecks | Inhalte sitzen innerhalb einer zurückgesetzten Wand, niemals auf der Kontur des Behälters |
| Eine Tür, die 0.25 aus ihrem Kasten hervorstand, verdoppelte den Bogen | Eine Tür in der Form ihrer Öffnung teilt sich eine Kontur in Ruhe |
| Eine Safetür bei 32° in Isometrie sah kantig aus | Isometrische Türen und Deckel öffnen sich ~24–26°, damit ihre Fläche noch lesbar ist |
| Ein Schlüsselring lag über den Schlüsseln statt durch ihre Löcher ("der Ring ist nicht im Schlüsselring") | Durchgefädelte Teile verschränken sich: der Ring verläuft auf einer Seite seines Lochs hinter jedem Teil und auf der anderen davor (line-style.md) |
| Das Verkleinern eines Objekts auf seine Größe brachte die doppelten Linien zurück | Setze zuerst die Standardbreite, dann mache Streifen ≥ 0.5 für Objekte, die klein gezeichnet werden |
| Ein "!!!"-Abzeichen bestand den Liniencheck nicht | Zeichne Markierungen als Formen mit klaren Lücken; vermeide Lückenglyphen in Text |
Nicht verhandelbare Regeln
- Nur echte Isometrie. Achsen bei 30° zur Horizontalen, 120° auseinander, gleicher Maßstab. Niemals die 2:1 "Game"-Projektion (26.565°).
- Geometrie zuerst. Platziere Primitive in Weltkoordinaten. Schreibe niemals von Hand einen projizierten Bildschirmpfad.
- Ein Raster. Positionen und Größen in 0.5 Weltkoordinaten; Flächendetails in 0.25.
- Ein Look.
variant="ink"(Standard) oder"line"; mische niemals Looks in einem Objekt. 1-Px-Kontur, Papierwände, kein Schatten, kein Glühen, kein Farbverlauf. - Theme aus Tokens. Farben stammen ausschließlich aus dem shadcn-Theme des Benutzers über die
--iso-*-Variablen. Kein Hex, kein oklch in einer Objektdatei. Das Markenzeichen folgttone(Standardprimary). - Props, keine Forks. Text, Tonwert, Variante, Linienstärke, Bewegungsschalter sind Props mit Doc-Kommentaren (
LineStateProps). Benenne eine Inhalts-Prop niemalstitle: es ist der zugängliche Name. - Zugänglich und einbettbar. Die Grafik ist dekorativ, es sei denn,
titleist gesetzt; dann ist sie ein beschriftetes Bild mit einerfigcaption. Das SVG hatrole="img"undaria-label(gesetzt übertitle). Die Komponente hat keine Container-Breite; das Elternteil bestimmt den Platz. - Ein Beat. Eine einzelne Bewegung, die innerhalb von 1.2–2.4 s nach einer Verzögerung von 400 ms abläuft und dann anhält. Keine Endlosschleife, kein Pulsieren, kein Schwanken. Kein Ein- oder Ausblenden. Nur Skalieren, Verschieben, Drehen. Wenn die Bewegung eine Antwort erfordert (Klappe zu, Tür öffnen), platziert die geöffnete Position sie für immer. Eine zweite Bewegung folgt der ersten (Aufklappen eines Kartons → Teil kommt heraus) in derselben Sequenz; keine parallelen Spuren für verschiedene Teile mit unterschiedlichen Zeitpunkten – das sind separate Beats. Wenn die Aufgabenstellung zwei Beats verlangt ("offen" und "geschlossen"), erstelle zwei separate Dateien.