Ein Anim erstellen
Ein Anim ist eine Datei, <kebab-name>@<major>.<minor>.yaml, mit genau vier Schlüsseln: t (das Literal c), j (ein ES-Modul), s (CSS), h (HTML/SVG). Ein Host-Player führt es mit einer globalen G-API aus, die die Silben, Wörter, Zeilen, Abschnitte und Beats des Lieds bereitstellt. Ihre Aufgabe: Verwandeln Sie eine Beschreibung in eine solche Datei, die unter Suchen/Pausieren/Größenänderung/Thema korrekt, lesbar und schön ist. Pfade unten sind relativ zu diesem skill/-Verzeichnis.
Die wichtigsten Regeln
- Ein Frame ist eine reine Funktion der Wiedergabezeit.
render(t)muss das gleiche Bild zeichnen, egal ob die Wiedergabeterreicht hat oder der Benutzer dorthin gesprungen ist. KeinMath.random,Date.now, akkumulierte Integration oder ein „Was war im letzten Frame“-Zustand, den ein Sprung überspringen würde. Leiten Sie alles aus den Lieddaten, dem Seed undtab. - Zwei Hälften. Eine exportierte, DOM-freie reine Hälfte (
buildPlan,frameAt, Hilfsfunktionen; unit-testbar) oberhalb eines Banner-Kommentars, dann eine dünne Browser-Hälfte (export default function (G, shadowRoot, config)), die nur verdrahtet und zeichnet. Sieheguides/architecture.md. - Registrieren in
default, Lieddaten inINITlesen.G.on/G.off/G.onFramenur innerhalb vondefault.G.map/forEach/lookup/iterator/relayouterst, nachdemINITausgelöst wurde (einINIT-Handler oder spätere Callbacks wierender), niemals indefaultselbst. Abonnieren SieG.on(G.TYPE.TICK, render)für die Wiedergabe;G.onFrame({ render, reset })deckt SEEK/PLAY/PAUSE/RESIZE und UNINIT ab. - Aufräumen mit
G.dispose/G.listen. Ein vondefaultzurückgegebener Wert wird ignoriert. Geben Sie WebGL (forceContextLoss), Listener, Timer, Kamera frei. - Farben leben in CSS, nicht in
c.v. Helle Werte auf:host, dunkle Überschreibungen in[data-bs-theme=dark] { }; Canvas liest sie mit der g-libcssColorszurück. Beide Themen müssen bewusst gestaltet sein. - Nie selbst implementieren, was g-lib bereits bietet (clamp, lerp, Easing, deterministischer RNG, Canvas-Fitting, Federn, Textlayout, Pools …). Importieren Sie über den exakten Tag-Pin; prüfen Sie
pitfalls/dont-hand-roll.mdundspec/g-lib.md, bevor Sie eigene Helfer schreiben. - Lesbarkeit vor Effekt. Die aktive Silbe ist in Hell und Dunkel, auf dem Telefon und Laptop, für lange Zeilen, CJK, RTL und Myanmar lesbar. Große Blitze bleiben unter 3 Hz (
guides/accessibility.md). - Wenig typisierte Optionen.
cundcSchemasind einfache Literale; jede Option bewirkt etwas Sichtbares.
Arbeitsablauf (mit den Repo-Tools)
- Brief. Schreiben Sie den Design-Brief aus
guides/design-brief.md: ein starkes, physikalisches Bild; der Mechanismus; welche Ereignisse was antreiben (die Sync-Map); Struktur (Strophe/Refrain/Beat); Lesbarkeitsplan; Optionen; Fallstricke. Wählen Sie das Backend mit seiner Auswahltabelle. Lehnen Sie Ideen ab, die nicht lesbar bleiben können. - Gerüst.
npm run new -- <name> --backend canvas2d|svg|dom|three(oder kopieren Sietemplates/<backend>.yamlvon Hand und ersetzen Sie__NAME__). - Einmal lesen:
spec/module-format.md,pitfalls/general.md, den Abschnitt Ihres Backends inpitfalls/backends.md,pitfalls/dont-hand-roll.md. Öffnen Sie alles andere nur über die Routing-Tabelle unten. - Implementieren Sie zuerst die reine Hälfte (Zeit zu Zustand), dann die dünne Browser-Hälfte.
- Validieren.
npm run validate -- anims/<file>.yaml. Beheben Sie jeden Fehler; begründen Sie jede Warnung im Docblock oder beheben Sie sie. - Prüfen.
npm run check -- anims/<file>.yamllädt 13 randständige Lieder kopflos, bewertet die Konformitätstabelle und schreibt PNGs nachout/<name>/. Öffnen Sie die PNGs (Telefon/Laptop, hell/dunkel). Eine grüne Tabelle über einem hässlichen oder unleserlichen Frame ist ein Fehlschlag. Ein WARN in einer Zeile zur Sprung-Reinheit bedeutet, dass das Bild von der Historie abhängt: Beheben Sie es oder begründen Sie es im Docblock (eine bewusste Simulation). - Vorschau (optional).
npm run preview -- anims/<file>.yamlzum Abspielen, Spulen, Thema wechseln und Optionen anpassen. - Überprüfen Sie gegen
guides/quality-rubric.md(20 Fragen), liefern Sie dann die eine YAML-Datei und einen kurzen Bericht (Dateiname, finale Prüftabelle, Entscheidungen, die der Brief offen ließ, was Sie bewusst nicht getan haben). Liefern Sieout/oder das Testgestell nicht aus.
Arbeitsablauf ohne Tools (Chat-Modelle, keine Shell)
Überspringen Sie die Schritte 2, 5-7. Beginnen Sie mit dem passenden Template-Text, schreiben Sie den Design-Brief in Ihrer Überlegung, gehen Sie dann pitfalls/general.md, den Backend-Abschnitt und die 20-Fragen-Rubrik Zeile für Zeile gegen Ihren eigenen Code durch, bevor Sie antworten. Geben Sie nur die YAML-Datei in einem umschlossenen Block aus, und erwähnen Sie, welche Rubrikpunkte Sie ohne Ausführung nicht überprüfen konnten (Sprung-Reinheit, Themenwechsel, Größenänderung).
Routing-Tabelle: Ein Dokument nur öffnen, wenn sein Auslöser zutrifft
| Wenn Sie im Begriff sind … | Lesen Sie … |
|---|---|
| zu entscheiden, was gebaut wird; ein Backend zu wählen | guides/design-brief.md |
| die Datei zu strukturieren; Phasen zu benennen; den Docblock zu schreiben | guides/architecture.md |
einen G.*-Aufruf, ein Ereignis-Option oder eine ID-Bereich zu verwenden | spec/events.md, spec/event-shapes.md, spec/g.d.ts |
| Optionen, Farben, Theming hinzuzufügen | spec/config.md |
| Zeit-Dienstprogramme, Textmessung, Canvas-Helfer, Lebenszyklus zu verwenden | spec/utilities.md |
| Zeilen in Anzeigezeilen zu teilen, Text umzubrechen | spec/relayout.md, guides/patterns-text.md |
| Aktionen an Silben/Zeilen/Beats auszulösen; Vorerzeugung; Pause; Federn | guides/patterns-timing.md |
| Text anzupassen, hervorzuheben oder zu gestalten; nicht-lateinische Schriften | guides/patterns-text.md |
| Rendering-Code zu schreiben (DOM, SVG, Canvas, three, Simulation, Ebenen) | guides/patterns-render.md, pitfalls/backends.md |
| Kamera, Gelände, Schwärme, Packen, prozedurale 3D | guides/techniques.md, pitfalls/techniques.md |
| ein Foto oder eine Kamera zu verwenden | spec/image-input.md |
| ein Spiel zu bauen (autoPlay false, Punktzahl, Zustände) | guides/games.md |
| einen g-lib-Helfer zu verwenden | spec/g-lib.md |
| unsicher bezüglich Blitzen, Bewegung, Kontrast zu sein | guides/accessibility.md |
| fertig zu werden | guides/quality-rubric.md |
Minimale Form (dies nicht ausliefern; mit einer Vorlage beginnen)
"t": |-
c
"j": |
import { hash01 } from 'https://cdn.jsdelivr.net/gh/prjctg/[email protected]/index.js';
/* [email protected]: <eine Zeile>
* 1. <nummerierte Design-Aussage: der Mechanismus und die verlockende falsche Antwort, die er ablehnt> */
export function frameAt(plan, t) { /* rein */ }
/* Browser-Hälfte. Alles oberhalb dieser Zeile ist absichtlich DOM-frei. */
export default function (G, shadowRoot, config) {
const cfg = G.cfg(config, { channel: G.cfg.int(0) });
let ready = false;
const render = (t) => { if (!ready) return; /* frameAt(plan, t) zeichnen */ };
G.on(G.TYPE.INIT, () => { ready = true; /* G.map(...) ist hier gültig */ });
G.on(G.TYPE.TICK, render);
G.onFrame({ render, reset() { ready = false; } });
}
export const c = { v: { fadeMs: 150 }, m: [{ s: 'fadeMs', t: 'fadeMs' }] };
export const cSchema = [{ i: 'fadeMs', n: 'Verblassen (ms)', t: 'int', mn: 0, mx: 2000 }];
"s": |
:host { display: block; --ink: var(--inkColor, #111); }
[data-bs-theme=dark] { --ink: var(--inkColor, #eee); }
"h": |
<canvas id="c"></canvas>
j, s, h enthalten Rohtext (niemals in Backticks oder Anführungszeichen). t verwendet |-. Der Dateiname trägt die Version; bearbeiten Sie niemals eine veröffentlichte Version an Ort und Stelle.