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:
- Astro-Starter für einfache persönliche Blogs, Schreibarchive, Newsletter oder leichte Portfolios.
- HugoBlox-Starter für akademische, forschungsbezogene, lebenslauf- oder labororientierte Seiten, technische Portfolios oder stark Markdown-lastige professionelle Websites.
- Pages CMS für repository-basierte Inhaltsbearbeitung, wenn der Benutzer eine Browser-UI benötigt.
- 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:
- Wofür ist der Blog: persönliche Essays, technische Notizen, Forschungsprofil, Portfolio, Newsletter oder gemischt?
- Hat die Person bereits Texte, Bilder, eine Domain oder ein GitHub-Konto?
- 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 --minifyoder Ä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.ymlfü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.