Communitygithub.com

haxzie/prequel

Recherchiere ein Blog-Thema, bevor jemand darüber schreibt. Verwende dies immer, wenn jemand aufgefordert wird, ein Thema für den Prequel-Blog zu recherchieren, herauszufinden, was Leute über ein Bildschirmaufnahme-Tool oder ein Problem sagen, Quellen zu sammeln, Blickwinkel zu finden, zu prüfen, was ein Wettbewerber heute verlangt, oder wenn gesagt wird „recherchiere und schreibe“ (führe dies zuerst aus, dann übergib an guide-posts oder comparison-posts). Deckt die Themenlandkarte, die Firecrawl-Suchströme, wo Prequels eigene Fakten herkommen, was ein brauchbares Zitat ist, und die Form des Briefings, das die Schreibfähigkeiten erwarten.

Was ist prequel?

Diese Skill ist für die gründliche Recherche von Blog-Themen konzipiert und konzentriert sich auf die Erstellung überprüfbarer Briefings für den Prequel-Blog. Sie stellt sicher, dass jede Behauptung, von Preisen bis zu Benutzerbeschwerden, eine nachprüfbare Quelle hat. Der Skill definiert klar die Phasen der Recherche: Er beginnt mit einer Themenlandkarte zur Bestätigung der Post-Kategorie, bezieht dann Prequels eigene Fakten aus dem Repository (wie Spezifikationen und Preisgestaltung) und führt anschließend fünf spezifische Suchströme mit Firecrawl durch. Diese Ströme umfassen Wettbewerbsinformationen, Benutzerbeschwerden von Reddit/HN, bestehende Blog-Inhalte, macOS-Fakten von Apple und relevante Statistiken. Alle Quellen müssen strengen Kriterien entsprechen, wie Live-Zugänglichkeit und Datierung. Das Endergebnis ist ein strukturiertes Briefing, das an die nächste Schreib-Skill übergeben wird.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/haxzie/prequel/tree/HEAD/.claude/skills/blog-research

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Blog-Recherche

Ein Briefing ist der Unterschied zwischen einem Beitrag, der Behauptungen aufstellt, und einem Beitrag, der Behauptungen aufstellt, die jemand überprüfen kann. Jeder Preis, jede zitierte Beschwerde und jedes „die meisten Tools stoppen bei 60 fps“ im Blog ist eine Behauptung über das Produkt eines anderen, und eine falsche Behauptung diskreditiert alle richtigen auf der Seite. Diese Skill erstellt die überprüfte Liste, von der der Autor ausgeht, und nichts weiter: Sie schreibt den Beitrag nicht.

Die Prequel-Fakten stammen nicht aus dem Web. Sie stammen aus dem Repository, und der erste Abschnitt unten sagt, wo. Die Suche nach „Prequel screen recorder“ findet eine veraltete Bewertung oder ein anderes Produkt mit demselben Namen.

Wo die Dinge hinkommen

PfadWas es ist
.context/research/<slug>.mdDas Briefing. Gitignoriert; Gerüst, nicht ausgeliefert.
apps/web/src/content/competitors.tsÜberprüfte Preise und Funktionen für die sechs mit Seiten
.claude/skills/comparison-posts/assets/quotes.jsonAlle bereits erfassten Reddit-Zitate
apps/web/src/content/posts.tsWas der Blog bereits abdeckt

Das Briefing wird nicht committed, weil der Beitrag seine eigenen Belege trägt: Preise in der Tabelle mit Prüfdatum, Reddit-Threads, die im Zitat verlinkt sind, und alles, was den Beitrag überdauern muss, wird in competitors.ts oder quotes.json verschoben. Ein committedes Briefing wird beim ersten Mal, wenn sich ein Preis ändert und niemand es aktualisiert, veraltet, und dann ist es eine zweite Wahrheitsquelle, die mit der Seite nicht übereinstimmt.

Phase 1: Die Themenlandkarte

Bevor du etwas suchst, schreibe auf, was der Beitrag ist, und bestätige es. Drei Zeilen in der Antwort:

  • Die Suche, die er beantwortet. „Bildschirmaufnahme Mac kein Wasserzeichen“, „Wie man Systemaudio auf dem Mac aufnimmt“. Der Beitrag ist für diese Suchanfrage gebaut, und sie bestimmt den Slug, die Definitionsfrage und die FAQ.

  • Das Genre. Eine Übersicht geht zu [[comparison-posts]]; ein „Beste -Alternativen“-Beitrag zu [[alternatives-posts]]; ein How-to, Erklärstück oder Säulenbeitrag zu [[guide-posts]]. Sie benötigen unterschiedliche Recherchen: Eine Übersicht braucht Preise für zehn Tools, eine Anleitung braucht die macOS-Fakten und die Beschwerden.

  • Die Definitionsfrage. Jeder Beitrag eröffnet einen ## Was ist <Ding>?-Abschnitt, und die Frage muss im gesamten Blog einzigartig sein. Durchsuche die bestehenden Beiträge mit grep, bevor du eine vorschlägst:

    grep -h "^## Was ist\|^## Wie " apps/web/src/content/blog/*.mdx
    

Dann die Säule, unter der er steht, aus posts.ts. Heute gibt es drei: screen-recording-on-mac, product-demo-videos, screen-recording-for-youtube. Ein Beitrag ohne Säule ist eine Säule, und das ist eine Entscheidung des Benutzers, nicht des Briefings.

Präsentiere dies und warte. Recherche zum falschen Genre ist eine verschwendete Stunde.

Phase 2: Prequels eigene Fakten aus dem Repository

Lies diese vor dem Web, damit das Briefing Wettbewerber mit dem kontrastiert, was Prequel tatsächlich ausliefert, und nicht mit dem, woran sich eine Suchmaschine erinnert:

FaktQuelle
Auflösung, fps, Codecs, AusgabeSPECS in apps/web/src/components/landing/LandingBody.tsx
Was der automatische Erstdurchlauf machtALREADY_DONE in derselben Datei. Nichts anderes ist automatisch.
Preis, Testdauerapps/web/src/lib/pricing.ts, niemals eine Zahl aus dem Gedächtnis
Produktantwortenapps/web/src/lib/faq.ts
Funktionszeilen und was wir behauptenFEATURE_ROWS in competitors.ts
AnforderungenApple Silicon, macOS 14 oder neuer, Bildschirmaufnahme-Berechtigung

Zwei Regeln aus [[no-dead-air-claim]] und [[site-copy]] gelten für das Briefing genauso wie für den Beitrag. Prequel schneidet, trimmt oder entfernt keine Stille; das Schneiden ist ein manueller Durchgang auf der Zeitachse. Und nichts kommt in das Briefing als Prequel-Schwäche: Wo ein Rivale wirklich in etwas besser ist, hält das Briefing es fest, damit der Autor weiß, das Thema nicht anzusprechen, gekennzeichnet als nicht schreiben.

Phase 3: Die Suchströme

Firecrawl ist das Suchtool. firecrawl_search gibt Titel, Ausschnitte und URLs zurück; firecrawl_scrape ruft eine Seite als Markdown ab; firecrawl_map listet die Seiten einer Site auf, wenn ein Anbieter die Preise drei Klicks tief versteckt. Führe die Ströme aus, die das Genre benötigt, parallel als Unter-Agenten, wenn mehr als drei Tools abzudecken sind, ansonsten inline.

Strom 1, Anbieter-Fakten. Für jedes Tool, das der Beitrag nennt: die Preisgestaltungsseite des Anbieters selbst, gescrapt und gelesen. Erfasse jede Stufe mit ihrem Abrechnungszeitraum, denn eine monatliche Zahl ohne die jährliche ist der schädlichste Fehler, den ein Vergleich machen kann, und er ist mit einem Klick überprüfbar. Erfasse das Datum. Wenn die Seite JS-rendered ist und firecrawl_scrape eine Hülle zurückgibt, sage dies und rufe sie mit headless Chrome ab ([[headless-chrome-screenshots]] im Gedächtnis). Für die sechs in competitors.ts, vergleiche mit dem, was dort ist, und melde Abweichungen; die Korrektur ist eine Bearbeitung dieser Datei, nicht eine Zahl im Briefing.

Die Fakten, die für diesen Blog pro Tool wichtig sind, weil sie diejenigen sind, bei denen Prequel gewinnt: höchste Auflösung und Bildrate pro Tarif, Wasserzeichen auf der kostenlosen Stufe oder Testversion, Obergrenze der Aufnahmelänge, ob Rendering lokal oder hochgeladen wird, einmalige Lizenz oder Abonnement, ob die Kamera eine separate Spur ist, die nach der Aufnahme neu positioniert werden kann.

Strom 2, worüber sich Leute beschweren. Reddit über firecrawl_search mit includeDomains: ["reddit.com"], plus Hacker News, G2 (die Zwei- und Drei-Sterne-Bewertungen, wo die spezifischen Beschwerden sind) und X. Für einen Alternativen-Beitrag, erfasse genug von jedem, um eine Karte zu zeichnen: Titel wörtlich, Subreddit oder Handle, Autor, Alter, Punktzahl, Kommentaranzahl, erster Absatz. [[alternatives-posts]] rendert diese. firecrawl_scrape lehnt reddit.com rundweg ab, daher kommen nur der Titel, der Ausschnitt und die URL eines Threads zurück, und das reicht für ein Zitat. Abfragen, die funktionieren: "<Tool> Preis" reddit, "<Tool> Alternativen", "<Tool> Wasserzeichen", "<Tool> langsam", Systemaudio Mac aufnehmen reddit.

Bevorzuge eine echte Beschwerde gegenüber einem Launch-Post. Einige Loom-Threads in der Suche sind Gründer, die ihre eigene Alternative mit einem Titel ankündigen, der wie eine Beschwerde klingt. Überprüfe zuerst quotes.json: Ein dort bereits erfasster Thread hat einen Screenshot in public/blog/quotes/ und benötigt keine neue Arbeit.

Strom 3, was der Blog bereits sagt. Lese posts.ts und das vorhandene MDX zu diesem Thema. Das Briefing listet die Beiträge auf, auf die der neue verlinken sollte (fünf oder mehr, mit dem Ankertext), die Säule und jeden Satz in einem bestehenden Beitrag, den der neue widersprechen würde. Zwei Beiträge, die sich über Looms kostenlose Stufe uneinig sind, sind schlimmer, als wenn nur einer falsch liegt.

Strom 4, die macOS-Fakten. Für eine Anleitung, was QuickTime und Cmd+Shift+5 auf dem aktuellen macOS können und nicht können, von Apples eigenen Support-Seiten, mit der URL. Diese ändern sich mit jedem Release und der Blog stellt sie als Fakten dar.

Strom 5, Zahlen. Jede Statistik, auf die sich der Beitrag stützen könnte (Anschauzeit bei ausgeschaltetem Ton, Abschlussraten von Demo-Videos), zurückverfolgt zu ihrer Primärquelle, datiert und verworfen, wenn sie älter als drei Jahre ist oder wenn die Spur an einem anderen Blog endet. Eine Zahl, die der Autor nicht verlinken kann, ist eine Zahl, die der Autor nicht verwenden kann.

Was eine Quelle erfüllen muss

  • Live und lädt den Inhalt, den das Briefing angibt. firecrawl_scrape sie; ein 200, der „Der Zugriff ist vorübergehend eingeschränkt“ ausliefert, ist keine Quelle. G2, Capterra und Trustpilot antworten alle auf diese Weise auf einen headless Fetch und sind hier nicht verwendbar.
  • Anbieterseite vor Bewertungsseite. Detailseite vor Zusammenfassung. Sie widersprechen sich öfter, als man erwarten würde.
  • Datiert. Preise, Statistiken und macOS-Verhalten tragen alle das Prüfdatum.
  • Ein Reddit- oder HN-Zitat ist die Thread-URL plus der Subreddit oder der Handle. Eine Paraphrase ohne Link ist kein Zitat, und ein Screenshot ist auch keins.
  • Nichts, was der Beitrag verlinken wird. Der Blog verlinkt nur Zitathosts: reddit.com, news.ycombinator.com, x.com, g2.com und github.com oder producthunt.com für eine Größenordnung. Anbieter-URLs kommen zur Überprüfung ins Briefing und nirgendwo sonst hin.

Phase 4: Das Briefing

# Research brief: <Arbeitstitel>

Suchanfrage: <die Abfrage>
Genre: Anleitung | Übersicht | Vergleich | Säule
Definitionsfrage: ## Was ist <Ding>?     (bestätigt einzigartig)
Säule: <slug> | none (dies ist eine Säule)

## Verwendete Prequel-Fakten
<Bullets, jede mit der Datei, aus der sie stammt>

## Nicht schreiben
<Jeder Punkt, an dem ein Rivale Prequel übertrifft, damit der Autor das Thema vermeidet>

## Tools
### <Tool>
Preis: <jede Stufe und jeder Abrechnungszeitraum>. Geprüft <Datum>. <Anbieter-URL>
Fakten: <Auflösung, fps, Wasserzeichen, Längenbegrenzung, lokal oder Upload, Lizenz>
Prequel gewinnt bei: <der eine Kontrast, den dieser Abschnitt transportieren soll>
Beschwerden: <Thread-Titel> (r/<Sub>) <URL>    <- in quotes.json? ja/nein

## macOS-Fakten
<Bullets, jede mit Apples URL und dem Datum>

## Zahlen
<Statistik> <Primärquellen-URL> <Veröffentlichungsdatum>

## Vorhandene Beiträge zum Verlinken
/blog/<slug>  "<Ankertext>"  (warum es passt)

## Widersprüche
<Alles, was ein bestehender Beitrag sagt, dem dieser widersprechen würde>

## FAQ-Kandidaten
<Frage, wie jemand sie in ein Suchfeld eingibt> (von: Thread-URL oder PAA)

## Blickwinkel
<Drei bis fünf, aus den Lücken zwischen dem, was Leute fragen, und dem, was existiert>

Schreibe es nach .context/research/<slug>.md und ende mit der einen Frage, die der Autor beantwortet haben muss: welche Skill es als nächstes übernimmt, [[guide-posts]] oder [[comparison-posts]], und ob die Blickwinkelliste zuerst gekürzt werden muss.

Verwandte Skills