Landing-Review
Sie auditieren eine Landing Page und schreiben ein Urteil in landing/review.md. Die Seite kann aus der landing-skills-Pipeline oder von überall sonst kommen. Sie lesen den Quellcode, betrachten die gerenderte Seite in vier Breiten, testen Bewegungen und 3D, falls vorhanden, und beurteilen alles anhand einer Rubrik.
Seiten, die fertig aussehen, haben oft Fehler, nach denen niemand gesucht hat: Ein Formular, das jeden Lead verwirft, während es dem Besucher dankt; Spezifikationen und Versprechungen, die der Kunde nie gemacht hat; eine 3D-Seite, die leer wird, wenn WebGL nicht verfügbar ist; Seitenabstände, die durch eine andere Regel auf jeder Breite aufgehoben werden. Prüfer, die vier Breiten erfassen und zwei betrachten, übersehen, was nur bei einer auftritt. Ihre Aufgabe ist es, alles zu betrachten und nur das zu melden, was Sie bestätigt haben.
<skill-dir> unten bezeichnet das Verzeichnis, das diese SKILL.md enthält; die Skripte befinden sich in dessen scripts/-Ordner. Wenn die Fertigkeit aus einem Plugin geladen wurde, wurde Ihnen der Pfad dieser Datei beim Laden mitgeteilt; falls nicht, finden Sie ihn mit find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null. Führen Sie jeden Befehl aus dem zu prüfenden Projekt aus, wobei die Skripte mit ihrem vollständigen Pfad angegeben werden.
Eingaben
Sie benötigen die Seite und verwenden jeglichen vorhandenen Kontext.
- Die Seite. Ein Projektverzeichnis, eine einzelne HTML-Datei oder eine bereitgestellte URL. Finden Sie den Einstiegspunkt:
index.html,src/pages/index.astro,src/App.jsx,app/page.tsxoder was auch immer der Stack verwendet. Notieren Sie den Stack; er bestimmt, wie Sie die Seite für den visuellen Durchlauf bereitstellen. landing/brief.md: Produkt, Zielgruppe, Conversion-Aktion, die Fakten und Nachweise, die der Kunde geliefert hat, die bereitgestellten Assets, die Sprache. Dies ist Ihre Wahrheitsquelle dafür, was die Seite behaupten darf.landing/copy.md: Der genehmigte Text. Vergleichen Sie die Seite damit.landing/direction.mdundlanding/tokens.css: Die visuelle Ausrichtung mit ihren Gründen und die Tokens. Eine Wahl, die wie ein Standard aussieht, ist akzeptabel, wenn die Ausrichtung einen für den Kunden spezifischen Grund angibt.
Wenn Dateien fehlen:
- Kein Brief. Fragen Sie den Benutzer vier Dinge, bevor Sie Behauptungen beurteilen: Was das Produkt ist, für wen es ist, was die eine Conversion-Aktion ist und welche Fakten, Zahlen, Testimonials und Logos echt sind. Wenn Sie nicht fragen können, nehmen Sie die Fakten aus dem, was die Seite selbst über das Unternehmen sagt, und behandeln Sie jedes Testimonial, jeden Kundennamen, jedes Logo, jede Bewertung und jede Metrik als nicht verifiziert: Melden Sie jedes als Blocker mit dem Fix „Bestätigen Sie, dass dies echt und vom Kunden geliefert wurde, oder entfernen Sie es“. Nicht verifizierte Nachweise, die ausgeliefert werden, sind dasselbe Risiko wie erfundene Nachweise.
- Kein copy.md oder direction.md. Prüfen Sie den Text und die Optik anhand der Rubrik nach eigenem Ermessen. Sie verlieren die Fähigkeit zu sagen „dies weicht vom genehmigten Text ab“, sonst nichts. Fragen Sie nicht nach diesen Dateien.
- Kein
landing/-Ordner. Erstellen Sielanding/undlanding/shots/im Projekt; der Bericht und die Screenshots werden dort abgelegt. - Die Seite lässt sich nicht bauen oder bereitstellen. Melden Sie dies unter Rubrikzeile B15 mit dem Fehler. Wenn keine gerenderte Seite auf andere Weise (eine bereitgestellte URL, ein früherer Build) bezogen werden kann, kann der visuelle Durchlauf nicht ausgeführt werden, und das Urteil lautet
unvollständig(siehe Urteil).
Lesen Sie references/rubric.md, bevor Sie mit den Durchläufen beginnen. Sie enthält jede Prüfung mit der Beschreibung, wie ein Bestehen aussieht, und dem Schweregrad bei Fehlschlag. Lesen Sie references/report-format.md, bevor Sie landing/review.md schreiben. references/snippets.md enthält die Skripte, die die Durchläufe ausführen.
Ablauf
Führen Sie die Durchläufe in dieser Reihenfolge aus und schreiben Sie dann den Bericht:
- Statischer Durchlauf: Scannen Sie den Quellcode, lesen Sie ihn dann.
- Visueller Durchlauf: Rendern Sie die Seite und betrachten Sie sie in vier Breiten.
- Bewegungs- und 3D-Durchlauf: Nur wenn die Seite Bewegung oder eine 3D-Szene enthält.
- Gehen Sie die gesamte Rubrik in
references/rubric.mddurch, Bereich für Bereich: Text, Art Direction, Build, Bewegung, Startbereitschaft. Schreiben Sie eine Arbeits-Checkliste inlanding/review-checklist.mdmit einer Zeile für jede Zeilen-ID:failmit dem Ort,passmit Beleg odern/amit dem Grund. Ein Bestehen zählt nur, wenn sein Beleg die Ausgabe der eigenen „Prüfanleitung“ dieser Zeile ist: die Liste, wo eine Liste steht, die Anzahl, wo eine Anzahl steht, und jeder Abschnitt, Header und Footer eingeschlossen, wo alle Abschnitte abgedeckt sind. Eine Zeile, die aus dem Gedächtnis an die Seite angekreuzt wurde, ist nicht abgearbeitet. Lesen Sie Text und Art Direction bei einer kurzen statischen Seite genauso sorgfältig wie bei einer komplexen, und gehen Sie jede Zeile durch, selbst wenn ein Blocker bereits offensichtlich ist: Die Prüfung listet alles auf, was die nächste Runde beheben muss, nicht nur das, was das Urteil bestimmt. - Schreiben Sie
landing/review.md, wie inreferences/report-format.mdbeschrieben: Fehler in der Tabelle, Bestehen mit ihrem Beleg unter „Geprüft und in Ordnung“. Führen Sie dann die Selbstprüfung am Ende dieser Datei durch.
Machen Sie sich während der Arbeit Notizen: Für jeden Befund, wo Sie ihn gesehen haben (Datei und Zeile oder Breite und Abschnitt) und wie Sie ihn bestätigt haben.
Statischer Durchlauf
Richten Sie den Scanner auf die Quellpfade der Seite, nicht auf ein ganzes Repository:
node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json
Was er liest: Jede Datei, die Sie direkt benennen, unabhängig von ihrer Erweiterung. In einem Verzeichnis liest er .html, .htm, .css, .scss, .js, .jsx, .mjs, .ts, .tsx, .astro, .vue, .svelte, .md und .mdx Dateien, überspringt die Ordner node_modules, .git, dist, build, .next, .astro, .output, .vercel und .wrangler und überspringt jede Datei über 1 MB. Jede Zeile wird gegen 25 Regeln geprüft. Ein Befund wird als datei:zeile [regel-id] nachricht gefolgt von einer fix: Zeile ausgegeben. Exit-Code 1 bedeutet, dass etwas gefunden wurde, 0 bedeutet, dass nichts gefunden wurde, 2 bedeutet einen falschen Pfad oder eine falsche Verwendung. --self-test prüft den Scanner selbst.
Da er Markdown liest, meldet er auch Phrasen, die in Notizen, Berichten, dem Brief und früheren Prüfungen zitiert werden. Ignorieren Sie jeden Befund in einer Datei, die kein Seitenquelltext ist: landing/*.md, READMEs, Notizen, frühere review.md-Dateien.
Behandeln Sie jeden Befund als Aufforderung zum Hinsehen, niemals als Urteil. Öffnen Sie die Zeile, sehen Sie, was sie tatsächlich enthält und was die Seite damit macht, und entscheiden Sie erst dann. Beschreiben Sie, worauf die Regel zutraf: Ein Palettentreffer bei einer Tag-Farbe ist kein Befund über den Seitenhintergrund. Beispiele dafür, was das Hinsehen entscheidet:
dead-anchorbei einem Logo-Link ist ein geringfügiger Build-Fehler. Beim Haupt-Call-to-Action bedeutet es, dass die Conversion nicht funktioniert: ein Blocker.overused-fontbedeutet, dass eine gängige Schriftart die Hierarchie anführt. Es ist nur dann ein Befund, wenndirection.mdkeinen Grund angibt und die Schriftart nicht mit einer unverwechselbaren Display- oder Monospace-Schriftart kombiniert wird.palette-cream-terracottawird bei zwei exakten Hex-Werten ausgelöst. Creme allein ist nie ein Indiz; das Bündel aus Creme, Terrakotta-Akzent und einer modischen Serife ist es.
Ein sauberer Scan beweist nichts. Erfundene Behauptungen, eine Seite, die ohne JavaScript leer ist, ein überdimensioniertes Bündel und ein Call-to-Action, der auf eine gültige ID innerhalb der Seite verlinkt, aber nie zu einem Kauf führt, hinterlassen alle kein Muster im Quellcode. Die meisten Fehler sind Abwesenheiten, Anzahlen, Widersprüche, Komposition und defektes Verhalten, die ein zeilenweiser Regex nicht sehen kann. Eine Seite kann sauber scannen und in jedem anderen Durchlauf fehlschlagen.
Lesen Sie also nach dem Scan den Quellcode selbst. Die Prüfungen, die durch Lesen durchgeführt werden, sind in references/rubric.md mit „source“ gekennzeichnet. Diejenigen, die am meisten abfangen:
- Der
<head>: title,lang, Meta-Beschreibung, Favicon, Open Graph Tags. - Jedes Formular: Wohin es sendet, was der Handler mit den Daten macht und ob die Erfolgsmeldung auf den Server wartet.
- Jeder Call-to-Action
href: Wohin er tatsächlich führt. - Schriftarten: Wird jede
font-familydurch ein@font-face, einen Stylesheet-Link oder einen Framework-Schriftimport geladen, oder handelt es sich nur um einen System-Stack? - Jede Behauptung, Zahl, Name, Spezifikation und jedes Versprechen auf der Seite, geprüft gegen den Brief. Jedes Asset, das der Brief als geliefert angibt, geprüft gegen das, was die Seite zeigt.
- CSS, das sich selbst aufhebt, z. B. eine Container-Klasse, deren
padding-Kurzschreibweise spezifischer ist als die Abschnittsregel und stillschweigend den vertikalen Abstand des Abschnitts auf Null setzt. Bestätigen Sie im Browser, indem Sie das berechnete Padding lesen. prefers-reduced-motion: Vorhanden oder nicht und was es tut.- Der Body des erstellten HTMLs: Wenn es ein leeres `<div id=