Communitygithub.com

SkyNotSilent/xiaohongshu-tech-card-report

Codex-Fähigkeit zur Erstellung wöchentlicher GitHub-Trend-Karussellpakete für Xiaohongshu mit Live-Trending-Daten, SEO-optimierten Bildunterschriften, 3:4-Bildvalidierung und sauberen PNG-Zip-Dateien.

Was ist xiaohongshu-tech-card-report?

Diese Codex-Fähigkeit, SkyNotSilent/xiaohongshu-tech-card-report, automatisiert die Erstellung wöchentlicher GitHub-Trend-Berichte, die als Xiaohongshu-Karussell-Pakete veröffentlicht werden. Sie ruft Live-Trending-Daten von GitHub ab, generiert SEO-fertige Bildunterschriften in deutscher Sprache, validiert Bilder auf das korrekte 3:4-Seitenverhältnis und erstellt saubere PNG-Zip-Archive. Die Fähigkeit ist besonders nützlich für Entwickler, Content-Ersteller und Tech-Blogger, die schnell ansprechende visuelle Zusammenfassungen der angesagtesten GitHub-Repositories der Woche erstellen möchten. Sie arbeitet nahtlos mit Codex zusammen und kann über Befehle wie fetch-trending, validate-images und generate-zip gesteuert werden. Der Workflow umfasst das Abrufen der neuesten Trenddaten, das Erstellen von Bildkarten mit Titel, Beschreibung und Sternenanzahl, das Sicherstellen der korrekten Bildabmessungen und das Verpacken aller Elemente in ein ZIP-Archiv mit PNG-Dateien und einer JSON-Datei mit Metadaten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add SkyNotSilent/xiaohongshu-tech-card-report

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht xiaohongshu-tech-card-report?

Codex-Fähigkeit zur Erstellung wöchentlicher GitHub-Trend-Hot-Karussellpakete für Xiaohongshu mit Live-Trending-Daten, SEO-optimierten Bildunterschriften, 3:4-Bildvalidierung und sauberen PNG-Zip-Dateien.

Überblick

Diese Fähigkeit automatisiert die Erstellung wöchentlicher GitHub-Trend-Berichte, die als Xiaohongshu-Karussell-Pakete veröffentlicht werden. Sie ruft Live-Trending-Daten von GitHub ab, generiert SEO-fertige Bildunterschriften, validiert Bilder auf das korrekte 3:4-Seitenverhältnis und erstellt saubere PNG-Zip-Archive.

Verwendung

Voraussetzungen

  • Codex CLI installiert und konfiguriert
  • Python 3.8+ mit den folgenden Bibliotheken:
    • requests
    • Pillow
    • jinja2
    • Standardbibliotheken: json, zipfile, os, datetime, io

Installation

  1. Klonen Sie das Repository:

    git clone https://github.com/SkyNotSilent/xiaohongshu-tech-card-report.git
    cd xiaohongshu-tech-card-report
    
  2. Installieren Sie die Abhängigkeiten:

    pip install -r requirements.txt
    
  3. Richten Sie Codex ein, um diese Fähigkeit zu verwenden:

    codex --load-skill ./skill.md
    

Befehle

BefehlBeschreibung
fetch-trending [sprache]Ruft die aktuellen GitHub-Trending-Repositories ab (Standard: 'python')
validate-images [pfad]Überprüft Bilder auf das 3:4-Seitenverhältnis und gibt eine Zusammenfassung
generate-zip [ausgabe]Erstellt ein ZIP-Archiv mit generierten PNG-Karten und einer metadata.json
create-reportFührt den vollständigen Workflow aus: Abrufen, Generieren, Validieren, Packen

Workflow

  1. Trending-Daten abrufen: Der Befehl fetch-trending ruft die GitHub Trending API auf und ruft die Top-Repositories der Woche ab (z. B. Sterne, Forks, Beschreibung).

  2. Karten generieren: Verwenden Sie die abgerufenen Daten, um für jedes Repository eine Bildkarte zu erstellen. Jede Karte enthält:

    • Repository-Name und Beschreibung
    • Sternenanzahl und Sprache
    • Einheitliches 3:4-Seitenverhältnis (z. B. 1080x1440 px)
  3. Bilder validieren: Der Befehl validate-images prüft jedes generierte Bild auf das korrekte 3:4-Seitenverhältnis. Bei Abweichungen werden die Bilder automatisch zugeschnitten oder skaliert, um dies zu korrigieren.

  4. Paket generieren: Der Befehl generate-zip erstellt ein ZIP-Archiv mit:

    • Allen gültigen PNG-Karten (benannt nach repo_name.png)
    • Einer metadata.json mit SEO-fertigen Bildunterschriften (auf Deutsch), Erstellungsdatum und Repository-Details

Beispiel

# Vollständigen Bericht generieren
codex run-skill SkyNotSilent/xiaohongshu-tech-card-report create-report

Erwartete Ausgabe:

  • xiaohongshu_weekly_report_2025_W10.zip
    • metadata.json
    • pytorch.png
    • transformers.png
    • openai-gym.png
    • ...

Konfiguration

UmgebungsvariableBeschreibungStandardwert
OUTPUT_DIRVerzeichnis für generierte Dateien./output
IMAGE_WIDTHBreite der Karten in Pixeln1080
IMAGE_HEIGHTHöhe der Karten in Pixeln1440
TRENDING_LANGUAGEStandard-Programmiersprache für Trendingpython
MAX_REPOSMaximale Anzahl von Repositories pro Bericht10

Lizenz

MIT

Mitwirken

Beiträge sind willkommen! Bitte öffnen Sie ein Issue oder einen Pull Request für Vorschläge.

Fehlerbehebung

  • Problem: fetch-trending gibt einen leeren Datensatz zurück.

    • Lösung: Überprüfen Sie Ihre Internetverbindung und ob die GitHub Trending API erreichbar ist.
  • Problem: Bilder haben nicht das 3:4-Seitenverhältnis.

    • Lösung: Führen Sie validate-images mit der Option --auto-fix aus, um sie automatisch zuzuschneiden.
  • Problem: Das ZIP-Archiv ist beschädigt.

    • Lösung: Stellen Sie sicher, dass alle Dateien gültige PNGs sind und führen Sie generate-zip erneut aus.

Verwandte Skills