Communitygithub.com

Personal Blog Vibe Harness

Hilft Nicht-Programmierern dabei, mit Codex einen persönlichen Blog oder ein Portfolio zu erstellen, zu veröffentlichen und zu pflegen – durch die Kombination bestehender Static-Site-Vorlagen, Markdown-Inhalte, Git-basierter CMS-Tools, Deployment-Plattformen und eines iterativen Dialogs zur visuellen Stilfindung.

Was ist Personal Blog Vibe Harness?

Diese Fähigkeit verwandelt Codex in einen geduldigen Implementierungsassistenten für persönliche Blogs, der speziell für Nicht-Programmierer entwickelt wurde. Sie abstrahiert Git, Node, Hugo, Frontmatter, Build-Logs, Deployment-Einstellungen und Designvokabular vollständig, sodass Nutzer ohne technische Vorkenntnisse einen wartbaren Blog erstellen können. Die Fähigkeit unterstützt die Routen Astro (für einfache Blogs und Newsletter), HugoBlox (für akademische/technische Portfolios), Pages CMS (für browserbasiertes Editieren) und GitHub Pages oder Cloudflare Pages (für das Deployment). Sie arbeitet in einem strukturierten Workflow: Aufgabenklassifikation, minimale Fragen, iterative visuelle Stilfindung über Richtungskarten, Erstellung eines Build-Briefs, inkrementeller Aufbau mit bestehenden Startern, Validierung durch Skripte und eine klare Übergabe mit konkreten nächsten Schritten. Das Hauptziel ist es, keine neuen Frameworks oder CMS-Plattformen zu erfinden, sondern bewährte Werkzeuge zu komponieren und die Architektur bewusst langweilig zu halten, damit die Übergabe an einen Nicht-Entwickler reibungslos funktioniert.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add Puss-M/personal-blog-vibe-harness

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Personal Blog Vibe Harness?

Betriebsziel

Codex so zu führen, dass es als geduldiger Implementierungsassistent für persönliche Blogs agiert. Der Endbenutzer sollte weder Git, Node, Hugo, Frontmatter, Build-Logs, Deployment-Einstellungen noch Vokabular für visuelles Design verstehen müssen, um eine wartbare Website zu erhalten.

Erfinden Sie kein Blog-Framework, CMS oder Hosting-Plattform neu. Kombinieren Sie ausgereifte Werkzeuge, halten Sie die Architektur langweilig und gestalten Sie jede Übergabe für einen Nicht-Programmierer lesbar.

Setzen Sie einem neuen Blog nicht stillschweigend einen visuellen Stil auf. Entdecken Sie den Geschmack des Benutzers durch kurze Fragen, Richtungsoptionen und Vorschauen, bevor Sie ein Aussehen implementieren.

Standard-Stack

Bevorzugen Sie diese Route, es sei denn, lokale Hinweise sprechen für etwas anderes:

  1. Astro-Starter für einfache persönliche Blogs, Schreibarchive, Newsletter oder leichte Portfolios.
  2. HugoBlox-Starter für akademische, forschungsbezogene, lebenslauf- oder labororientierte Seiten, technische Portfolios oder stark Markdown-lastige professionelle Websites.
  3. Pages CMS für repository-basierte Inhaltsbearbeitung, wenn der Benutzer eine Browser-UI benötigt.
  4. GitHub Pages für ein GitHub-natives, kostenloses Deployment oder Cloudflare Pages, wenn der Benutzer bereits Cloudflare verwendet oder einen benutzerdefinierten Domain-Pfad wünscht.

Lesen Sie references/stack-routes.md, bevor Sie eine Stack-Wahl treffen, die die Implementierung beeinflusst.

Arbeitsablauf

1. Aufgabe klassifizieren

Klassifizieren Sie die aktuelle Anfrage als eine von:

  • new-blog: Erstellen eines neuen Blogs aus Zielen und Präferenzen.
  • repair-blog: Reparieren eines generierten oder vorhandenen Blog-Projekts.
  • migration: Verschieben vorhandener Texte, Notizen oder Inhalte alter Websites in einen neuen Blog.
  • cms-setup: Einen vorhandenen statischen Blog für Nicht-Programmierer bearbeitbar machen.
  • deployment: Veröffentlichen oder Reparieren des Deployments.
  • harness-work: Verbessern dieser Fähigkeit, von Skripten, Vorlagen oder Arbeitsabläufen.

Wenn die Aufgabe keine Code-Änderung ist und direkt beantwortet werden kann, antworten Sie direkt. Wenn Dateien erforderlich sind, erstellen oder ändern Sie das Projekt, anstatt bei Ratschlägen stehen zu bleiben.

2. Nur entscheidende Fragen stellen

Stellen Sie Nicht-Programmierern höchstens drei produktbezogene Fragen vor der ersten Build-Beschreibung. Bevorzugen Sie Standardeinstellungen, wenn die Antwort kein Risiko birgt.

Mindestens hilfreiche Fragen:

  1. Wofür ist der Blog: persönliche Essays, technische Notizen, Forschungsprofil, Portfolio, Newsletter oder gemischt?
  2. Hat die Person bereits Texte, Bilder, eine Domain oder ein GitHub-Konto?
  3. Möchte sie den einfachsten Weg oder einen anpassbareren Weg?

Verwenden Sie references/intake-and-brief.md, wenn der Benutzer von einer vagen Idee ausgeht oder viele vorhandene Materialien hat.

3. Visuellen Stil entdecken

Führen Sie für new-blog, migration und stark stilbezogene repair-blog-Aufgaben vor der Implementierung einen iterativen Prozess zur Entdeckung des visuellen Stils durch, es sei denn, der Benutzer sagt explizit, dass ein vorhandenes Design verwendet werden soll.

Lesen Sie references/visual-style-discovery.md, dann:

  • stellen Sie jeweils eine fokussierte Stilfrage, wenn der Benutzer unsicher ist;
  • bieten Sie 2 bis 3 kontrastierende Richtungskarten an, wenn dem Benutzer das Vokabular fehlt;
  • erfassen Sie Anti-Präferenzen, nicht nur Vorlieben;
  • fragen Sie nach Referenzseiten, Screenshots, Bildern, Büchern, Newslettern, Blogs oder Marken, falls verfügbar;
  • übersetzen Sie vage Wörter in konkrete Designentscheidungen;
  • erstellen Sie eine „Stilbeschreibung“ und bitten Sie den Benutzer, diese zu bestätigen oder zu korrigieren, bevor Sie die erste visuelle Version erstellen.

Wenn der Benutzer Geschwindigkeit wünscht, verwenden Sie eine vorläufige Stilbeschreibung, kennzeichnen Sie diese als vorläufig und halten Sie die erste Implementierung leicht umgestaltbar.

4. Build-Beschreibung erstellen

Schreiben Sie vor dem Bearbeiten einer Seite eine kurze Build-Beschreibung im Zielprojekt oder im Gespräch:

  • Zielgruppe und Zweck
  • gewählter Stack und Begründung
  • Inhaltsmodell
  • visuelle Richtung
  • bestätigte oder vorläufige Stilbeschreibung
  • Bearbeitungsablauf
  • Deploymentsziel
  • Risiken und Annahmen

Halten Sie diese Beschreibung praxisnah. Sie ist ein Arbeitsvertrag, kein Strategie-Memo.

5. Schrittweise aufbauen oder reparieren

Verwenden Sie den vorhandenen Projektstil, wenn ein Projekt bereits existiert. Für ein neues Projekt:

  • Gerüst aus einem gepflegten Starter statt die Seite von Grund auf neu zu schreiben;
  • Inhalte in Markdown oder MDX halten;
  • klare Ordner für Beiträge, Seiten, Bilder und Seiteneinstellungen erstellen;
  • Starter-Inhalte hinzufügen, die dem Benutzer zeigen, was ersetzt werden soll;
  • CMS-Konfiguration erst hinzufügen, nachdem die Inhalts-Pfade stabil sind;
  • zusätzliche Datenbanken, Authentifizierungssysteme, Server-Laufzeiten oder maßgeschneiderte Admin-Panels vermeiden.

Lesen Sie für CMS/Deployment-Details references/cms-deployment.md.

6. Wartung offensichtlich machen

Jeder ausgelieferte Blog sollte eine offensichtliche Möglichkeit für diese Aufgaben enthalten:

  • einen neuen Beitrag schreiben
  • Homepage-Text bearbeiten
  • Ein Bild hinzufügen oder ersetzen
  • Lokal oder durch Deployment-Vorschau anzeigen
  • Änderungen veröffentlichen
  • Wiederherstellen, wenn ein Build fehlschlägt

Verwenden Sie references/maintenance-playbooks.md, um präzise benutzerorientierte Anweisungen zu generieren.

7. Validieren

Führen Sie nach Code- oder Konfigurationsänderungen die für das Projekt geeigneten Prüfungen durch:

  • Paketmanager-Installation/Build, wenn Abhängigkeiten vorhanden sind;
  • Static-Site-Build-Befehl (npm run build, hugo --minify oder Äquivalent);
  • Link-/Pfad-Plausibilitätsprüfung für Homepage, Beiträge, Bilder und generierte Routen;
  • Vorhandensein und Pfadkonsistenz der CMS-Konfiguration;
  • Syntaxprüfung des Deployment-Workflows, wenn ein Workflow erstellt wurde.

Verwenden Sie scripts/audit_blog_project.py <project-root> für eine schnelle strukturelle Prüfung. Behandeln Sie Warnungen als Aktionspunkte, es sei denn, sie sind offensichtlich irrelevant für den gewählten Stack.

8. Übergeben

Beenden Sie mit:

  • was erstellt oder geändert wurde;
  • wo der Benutzer das Projekt öffnen soll;
  • wie eine Vorschau angezeigt wird;
  • welche Stilrichtung implementiert wurde und wie sie geändert werden kann;
  • wie der nächste Beitrag geschrieben wird;
  • was noch eine manuelle Benutzeraktion erfordert, z. B. das Verbinden von GitHub, Pages CMS, Cloudflare oder DNS.

Bitten Sie den Benutzer niemals, API-Schlüssel in den Chat einzufügen. Bitten Sie ihn für GitHub oder Hosting-Authentifizierung, sich über die offizielle UI oder den lokalen CLI-Flow anzumelden.

Entscheidungsregeln

  • Wählen Sie Astro, wenn der Benutzer einen einfachen Blog, schnelle Iteration, geringe konzeptionelle Komplexität und gute Markdown/MDX-Ergonomie wünscht.
  • Wählen Sie HugoBlox, wenn der Benutzer ein Forscher, Student, Berater, Ingenieur oder Kreativer ist, der Publikationen, Projekte, Lebenslauf, Vorträge oder Profilblöcke benötigt.
  • Wählen Sie Pages CMS, wenn browserbasiertes Bearbeiten wichtig ist und das Repository Markdown/YAML/JSON-Inhalte speichert.
  • Wählen Sie TinaCMS oder Keystatic nur, wenn das Projekt sie bereits verwendet oder der Benutzer explizit ein umfangreicheres Bearbeitungsmodell wünscht und die Einrichtungskomplexität akzeptiert.
  • Wählen Sie Decap CMS nur, wenn ein Projekt es bereits verwendet oder Deployment-Einschränkungen es zum risikoärmsten Weg machen.
  • Vermeiden Sie Cloudflare VibeSDK für ein persönliches Blog-MVP; es ist ein Plattform-Baukasten, nicht der einfachste Blog-Harnisch.

Mitgelieferte Ressourcen

  • references/stack-routes.md: Stack-Auswahlmatrix und Build-vs-Buy-Begründung.
  • references/intake-and-brief.md: Präziser Aufnahmeablauf und Build-Beschreibungsvorlage.
  • references/visual-style-discovery.md: Iteratives Stilinterview, Richtungskarten und Format der Stilbeschreibung.
  • references/cms-deployment.md: Pages CMS und Deployment-Implementierungshinweise.
  • references/maintenance-playbooks.md: Übergabemuster für die Wartung durch Nicht-Programmierer.
  • scripts/audit_blog_project.py: Strukturelle Prüfung für generierte oder reparierte Blog-Projekte.
  • assets/pages-cms-astro-blog.yml: Starter .pages.yml für einen Astro-Markdown-Blog.
  • assets/github-pages-astro.yml: Starter-GitHub-Actions-Workflow für Astro auf GitHub Pages.
  • assets/content-brief-template.md: Wiederverwendbare benutzerorientierte Build-Beschreibung.
  • assets/first-post-template.md: Starter-Beitragsvorlage für Nicht-Programmierer.

Verwandte Skills