Leitfaden-Rückblick
Erstellt Social-Media-Inhalte aus CHANGELOG.md-Einträgen. Standardmäßig werden 8 Ausgaben produziert (4 Formate × 2 Sprachen).
Verwendungszeitpunkte
- Nach der Ausführung von
/release, um Release-Ankündigungen zu erstellen - Wöchentlich, um mehrere Releases zusammenzufassen
- Vor dem Posten auf LinkedIn, Twitter/X, Newsletter oder Slack
Verwendung
/guide-recap latest # Neueste veröffentlichte Version
/guide-recap v3.20.5 # Bestimmte Version
/guide-recap week # Aktuelle Woche (Montag bis heute)
/guide-recap week 2026-01-27 # Bestimmte Woche (Montag bis Sonntag)
Flags
| Flag | Wirkung | Standard |
|---|---|---|
--interactive | Geführter Modus: Winkel, Zielgruppe, Highlight wählen | Aus (automatischer Entwurf) |
--format=X | Einzelnes Format: linkedin, twitter, newsletter, slack | Alle 4 Formate |
--lang=X | Einzelne Sprache: fr, en | Beide FR + EN |
--save | Ausgabe in claudedocs/social-posts/ speichern | Nur Anzeige |
--force | Auch bei ausschließlich Wartungseinträgen generieren | Einträge mit niedrigem Wert überspringen |
Arbeitsablauf (7 Schritte)
Schritt 1: Eingabe parsen
$ARGUMENTS parsen, um den Modus zu bestimmen:
| Eingabe | Modus | Ziel |
|---|---|---|
latest | Einzelne Version | Erste ## [X.Y.Z] nach [Unreleased] |
vX.Y.Z oder X.Y.Z | Einzelne Version | Exakte Versionsübereinstimmung |
week | Wochenbereich | Montag der aktuellen Woche -> heute |
week YYYY-MM-DD | Wochenbereich | Dieser Montag -> folgender Sonntag |
Wenn kein Argument oder ungültiges Argument: Verwendung anzeigen und beenden.
Schritt 2: CHANGELOG-Einträge extrahieren
CHANGELOG.md aus dem Projektstammverzeichnis lesen.
Einzelne Version:
- Zeile mit
## [{version}]finden - Gesamten Inhalt bis zur nächsten
## [-Zeile extrahieren - Abschnitte
### Added,### Changed,### Fixedparsen
Wochenbereich:
- Alle
## [X.Y.Z] - YYYY-MM-DD-Einträge sammeln, deren Datum im Bereich liegt - Alle Abschnitte aller passenden Versionen parsen
Fehler: Version nicht gefunden -> Letzte 5 Versionen auflisten, latest vorschlagen.
Fehler: Woche hat keine Einträge -> Datum des letzten Releases anzeigen, diese Version vorschlagen.
Schritt 3: Einträge kategorisieren
Für jeden übergeordneten Eintrag (erste Ebene unter ###) eine Kategorie zuweisen:
| Kategorie | Gewicht | Erkennung |
|---|---|---|
NEW_CONTENT | 3 | Neue Dateien, neue Abschnitte, neue Diagramme, neue Quizfragen |
GROWTH_METRIC | 2 | Zeilenanzahl-Wachstum, Änderungen der Elementanzahl |
RESEARCH | 1 | Ressourcenbewertungen, Integration externer Quellen |
FIX | 1 | Unter ### Fixed, Korrekturen |
MAINTENANCE | 0 | README-Aktualisierungen, Badge-Synchronisationen, Landing-Synchronisationen, Zählungsaktualisierungen |
Siehe references/changelog-parsing-rules.md für detaillierte Klassifikationsregeln.
Schritt 4: In Nutzerwert umwandeln
Abbildungen aus references/content-transformation.md anwenden:
- Technische Sprache -> Nutzer Nutzen
- Konkrete Zahlen extrahieren
- Genannte Quellen kreditieren
- Zusammenhängende Einträge gruppieren
Gegen die DO/DON'T-Checkliste aus references/tone-guidelines.md validieren.
Schritt 4b: Interaktiver Modus (nur --interactive)
Wenn das --interactive-Flag gesetzt ist, zwischen Schritt 4 und 5 einfügen:
-
Kandidaten-Highlights mit Punktzahlen anzeigen:
Highlights (nach Punktzahl): [14] 4 neue ASCII-Diagramme (16 -> 20) [NEW_CONTENT] [ 9] 30 neue Quizfragen (227 -> 257) [NEW_CONTENT] [ 6] Docker-Sandbox-Isolationsleitfaden [NEW_CONTENT] [ 1] README aktualisiert [MAINTENANCE] -
Winkel abfragen:
- Auto (höchste Punktzahl = Aufhänger)
- Benutzer wählt bestimmten Eintrag als Aufhänger
- Benutzerdefinierter Winkel (Benutzer gibt Thema vor)
-
Zielgruppe abfragen:
devs(technische Tiefe)tech-leads(Wirkungsfokus)general(zugängliche Sprache)all(Standard, ausgewogen)
-
Primäres Highlight abfragen:
- Auto (höchste Punktzahl)
- Benutzer wählt aus der Liste
-
Auswahl bestätigen und mit Schritt 5 fortfahren.
Schritt 5: Bewerten und auswählen
Punktzahl für jeden Eintrag berechnen:
score = (category_weight * 3)
+ (has_number * 2)
+ (named_source * 1)
+ (new_file * 1)
+ (min(impact_files, 3))
+ (breaking * 2)
Die 3-4 Einträge mit der höchsten Punktzahl auswählen. Höchste Punktzahl = Aufhänger-Zeile.
Wenn alle Punktzahlen < 3: Ausgabe „Für diese Version wird kein Social-Media-Inhalt empfohlen. Verwenden Sie --force, um trotzdem zu generieren.“ und beenden (außer --force).
Schritt 6: Inhalt generieren
Für jedes angeforderte Format (Standard: alle 4) und jede Sprache (Standard: beide):
- Die entsprechende Vorlage aus
assets/lesen - Vorlagenfelder mit bewerteten und umgewandelten Einträgen füllen
- Qualitätscheckliste aus tone-guidelines.md anwenden
Links:
| Format | Link-Ziel |
|---|---|
| Landing-Seiten-URL | |
| GitHub-Repo-URL | |
| Newsletter | Beide (Landing + GitHub) |
| Slack | GitHub-Repo-URL |
URLs:
- Landing:
https://florianbruniaux.github.io/Codex-ultimate-guide-landing/ - GitHub:
https://github.com/FlorianBruniaux/Codex-ultimate-guide
Schritt 7: Ausgabe
Jeden generierten Beitrag in einem Code-Block mit Label für Format und Sprache anzeigen:
## LinkedIn (FR)
```text
[Inhalt]
LinkedIn (EN)
[Inhalt]
Twitter/X (FR)
[Inhalt]
...
Wenn das `--save`-Flag gesetzt ist: Alle Ausgaben in `claudedocs/social-posts/YYYY-MM-DD-vX.Y.Z.md` (für Version) oder `claudedocs/social-posts/YYYY-MM-DD-week.md` (für Woche) schreiben. Verzeichnis `claudedocs/social-posts/` erstellen, falls es nicht existiert.
## Fehlerbehandlung
| Fehler | Reaktion |
|--------|----------|
| Kein Argument | Verwendungsblock anzeigen |
| Ungültiges Argument | Verwendungsblock mit Beispielen anzeigen |
| Version nicht gefunden | 5 aktuellste Versionen auflisten, `latest` vorschlagen |
| Woche hat keine Einträge | Datum des letzten Releases anzeigen, Version vorschlagen |
| Alle Einträge MAINTENANCE (Punktzahl 0) | „Kein Social-Media-Inhalt empfohlen. Verwenden Sie `--force`, um zu überschreiben.“ |
| CHANGELOG.md nicht gefunden | „CHANGELOG.md im Projektstammverzeichnis nicht gefunden.“ |
## Referenzdateien
- `references/tone-guidelines.md` - DO/DON'T-Regeln, Emoji-Budget, Sprachregister
- `references/changelog-parsing-rules.md` - CHANGELOG-Format, Extraktion, Bewertungsalgorithmus
- `references/content-transformation.md` - Technisch -> Nutzerwert-Abbildungen (30+)
- `assets/linkedin-template.md` - ~1300 Zeichen, Aufhänger + Aufzählungspunkte + CTA + Hashtags
- `assets/twitter-template.md` - 280 Zeichen einzeln oder 2-3 Tweet-Thread
- `assets/newsletter-template.md` - ~500 Wörter, strukturierte Abschnitte
- `assets/slack-template.md` - Kompakt, emoji-reich, Slack-Formatierung
- `examples/version-output.md` - Vollständiges Beispiel für v3.20.5
- `examples/week-output.md` - Vollständiges Beispiel für Woche 2026-01-27
## Tipps
- Führen Sie `/guide-recap latest` direkt nach `/release` aus, um Social-Media-Beiträge vorzubereiten
- Verwenden Sie `--interactive` die ersten Male, um die Bewertung zu verstehen
- Verwenden Sie `--format=linkedin --lang=fr`, wenn Sie nur eine bestimmte Ausgabe benötigen
- `--save`-Ausgaben werden durch die `claudedocs/`-Konvention mittels gitignore ausgeschlossen
- Prüfen und personalisieren Sie vor dem Posten (dies sind Entwürfe, keine endgültigen Texte)