Communitygithub.com

tangshengming/persönliche_website

Erstellt eine erste persönliche Website aus einem Lebenslauf oder Profil, indem strukturierte Inhalte extrahiert, überprüfbare Markdown-Quelldateien geschrieben, Entscheidungen zu Privatsphäre/Zielgruppe/Design getroffen, die Seitenstruktur entworfen, eine Astro-Website eingerichtet und lokal geprüft wird.

Was ist persönliche_website?

Diese Fähigkeit reproduziert einen sorgfältigen Workflow von Lebenslauf zu Website. Der Kernprozess besteht darin, zuerst überprüfbares Quellmaterial zu erstellen, bevor Seiten generiert werden: den Lebenslauf in Markdown extrahieren, entscheiden, was öffentlich ist, und dann die Website aus strukturierten Inhalten aufbauen. Sie ist ideal für Entwickler, die auf Aufforderungen wie „Website erstellen“, „persönliche Website aus Lebenslauf bauen“ oder „PDF/LaTeX-Lebenslauf in Portfolio-Seite konvertieren“ reagieren möchten. Der Workflow umfasst das Lesen des Lebenslaufs aus PDF, LaTeX oder DOCX, die Extraktion in eine überprüfbare Markdown-Datei, die Bestätigung von Privatsphäre-Einstellungen mit dem Benutzer, das Erstellen eines Website-Strukturentwurfs, das Einrichten einer Astro-Website und die lokale Überprüfung. Das Tool unterstützt mehrere Quellformate, bewahrt die Privatsphäre durch Standardeinstellungen (z. B. Ausblenden sensibler Daten) und erzeugt eine funktionierende Astro-Website mit klaren Hinweisen auf ausstehende Aufgaben. Es ist für Claude Code, Cursor oder Codex konzipiert und stellt sicher, dass keine sensiblen Details versehentlich veröffentlicht werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangshengming/personal_website/tree/HEAD/.codex/skills/generate-website

In Ihrer bevorzugten KI fragen

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

Dokumentation

Website generieren

Überblick

Verwenden Sie diese Fähigkeit, um einen sorgfältigen Workflow von Lebenslauf zu Website zu reproduzieren. Das Kernprinzip besteht darin, zuerst überprüfbares Quellmaterial zu erstellen, bevor Seiten generiert werden: Den Lebenslauf in Markdown extrahieren, dann entscheiden, was öffentlich ist, und schließlich die Website aus strukturierten Inhalten aufbauen.

Workflow

1. Arbeitsbereich prüfen

Überprüfen Sie die aktuellen Projektdateien vor der Bearbeitung:

  • Workflow-/Statusdateien wie WEBSITE_WORKFLOW.md, PROJECT_STATUS.md oder ähnliche finden.
  • Die Lebenslauf-/Profil-Quelldatei finden: meist .pdf, .tex, .docx oder eine Text-/Markdown-CV.
  • Prüfen, ob bereits eine Website existiert: package.json, astro.config.*, src/, public/, dist/.
  • Git-Status bei Bedarf leicht mit git status --short prüfen.

Nicht von einem leeren Projekt ausgehen.

2. Lebenslauf lesen und prüfen

Wenn die Quelle ein PDF ist:

  • Die PDF-Fähigkeit verwenden.
  • Text mit pdfplumber oder einem anderen zuverlässigen PDF-Textwerkzeug extrahieren.
  • Seiten nach Möglichkeit als Bilder rendern und visuell prüfen, damit Layout und Abschnittsgrenzen nicht falsch interpretiert werden.
  • Mit Abstands-/Symbolartefakten bei der PDF-Text-Extraktion rechnen; diese im strukturierten Ausgabe manuell bereinigen.

Wenn die Quelle LaTeX ist:

  • Die .tex-Quelldatei direkt lesen.
  • Abschnittsbefehle, Makros und Listen als Struktur behandeln.
  • Keine lokale LaTeX-Kompilierung erforderlich, es sei denn, der Benutzer wünscht eine PDF-Neuerstellung.

Wenn die Quelle .docx ist:

  • Die Dokumentfähigkeit verwenden, um Struktur und Inhalt zu extrahieren.

3. In überprüfbares Markdown extrahieren

Eine Markdown-Quelldatei erstellen, bevor Website-Seiten gebaut werden. Bevorzugt:

content/cv_extracted.md

Strukturierte Abschnitte einschließen wie:

  • Identität
  • Öffentliche Kontaktdaten
  • Private oder versteckte Kontaktdaten/Details
  • Profil
  • Sprachen
  • Technische Expertise
  • Berufliche Fähigkeiten
  • Berufserfahrung
  • Ausbildung
  • Veröffentlichungen
  • Projekte
  • Website-Präsentationspotential für jedes Projekt

Diese Datei sachlich halten. Sie ist das Quellmaterial, kein endgültiger Marketingtext.

4. Entscheidungen zu öffentlich/privat erfragen oder bestätigen

Bevor persönliche Details auf einer öffentlichen Website platziert werden, bestätigen:

  • Öffentliche E-Mail-Adresse
  • Ob Telefonnummer angezeigt werden soll
  • Ob Geburtsdatum angezeigt werden soll
  • Ob vollständige Adresse angezeigt werden soll
  • Ob Wohnsitz-/Aufenthaltsgenehmigungs-/Visums-/Führerscheindetails angezeigt werden sollen
  • Welche Links öffentlich oder versteckt sind: GitHub, LinkedIn, Google Scholar, ORCID, ResearchGate usw.
  • Bevorzugte Zielgruppe: Industrie, akademisch, gemischt, Kunden, Personalvermittler, Mitarbeiter
  • Visuelle Präferenz: minimalistisch, akademisch, ausdrucksstarkes technisches Portfolio usw.

Standardmäßige Datenschutzhaltung:

  • Geburtsdatum, Telefonnummer, vollständige Adresse, Aufenthaltsgenehmigung, Führerschein und ähnliche sensible Details ausblenden, es sei denn, der Benutzer möchte sie explizit öffentlich.
  • Öffentliche E-Mail-Adresse, Stadt/Land und ausgewählte berufliche Links bevorzugen.

5. Website-Struktur entwerfen

Einen Strukturentwurf erstellen, bevor die Website eingerichtet oder Seiten stark bearbeitet werden. Bevorzugt:

WEBSITE_STRUCTURE_DRAFT.md

Einschließen:

  • Designrichtung
  • Zielgruppe
  • Navigation
  • Seitenliste
  • Seitenzweck
  • Vorgeschlagene Inhalte pro Seite
  • Offene Fragen oder Entscheidungen
  • Technische Empfehlung

Eine gute erste Struktur:

  • Startseite
  • Über mich
  • Lebenslauf
  • Projekte
  • Kontakt

Bei forschungsstarken Profilen Platz für spätere akademische Webpräsentationsseiten lassen.

6. Website einrichten

Standardmäßig Astro für eine inhaltsreiche persönliche Website verwenden, es sei denn, der Benutzer wünscht einen anderen Stack.

Vorgeschlagene Struktur:

src/
  pages/
    index.astro
    about.astro
    cv.astro
    projects.astro
    contact.astro
  content/
    profile.ts
    projects.ts
  layouts/
    BaseLayout.astro
  styles/
    global.css
public/

Website-Inhalte aus strukturierten Quelldateien aufbauen, nicht durch Verteilen von hartcodiertem CV-Text überall.

Empfohlene Inhaltsdateien:

  • src/content/profile.ts für Identität, Profil, Expertise, Erfahrung, Ausbildung, Veröffentlichungen.
  • src/content/projects.ts für Projekteinträge und spätere Präsentationsnotizen.

Öffentliche Assets in public/ kopieren:

  • CV-PDF, falls der Benutzer einen herunterladbaren CV wünscht.
  • Porträtbild, falls verfügbar und genehmigt.
  • Projektbilder oder Abbildungen später.

7. Erste Version gestalten

Für eine erste persönliche Website:

  • Den ersten Bildschirm zur tatsächlichen Identität/Profil machen, nicht zu einer Marketing-Landingpage.
  • Reale visuelle Assets verwenden, wo verfügbar.
  • Kontaktdaten datenschutzbewusst halten.
  • Seiten aufbauen, die schnell durchsucht werden können, aber später erweitert werden können.
  • Für Industriezielgruppen technische Nützlichkeit, F&E-Workflows, technische Tiefe und übertragbare Fähigkeiten betonen.
  • Für akademische Zielgruppen Forschungsfragen, Methoden, Veröffentlichungen und Präsentationsfluss betonen.

Überanpassung der ersten Version vermeiden. Klare Orte für spätere Projektpräsentationsseiten lassen.

8. Lokal überprüfen

Ausführen:

npm.cmd install
npm.cmd run build
npm.cmd run dev

Unter Windows/PowerShell npm.cmd bevorzugen, falls npm durch die Skriptausführungsrichtlinie blockiert ist.

Falls Astro-Telemetrie versucht, außerhalb des Arbeitsbereichs zu schreiben, Skripte in package.json setzen wie:

"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"

Überprüfen:

  • Build erfolgreich ist.
  • Lokale Routen 200 zurückgeben.
  • Öffentliche Assets geladen werden.
  • Keine sensiblen Details versehentlich angezeigt werden.
  • Visuelle Browser-QA nach Möglichkeit durchgeführt wird, oder der Benutzer manuell prüft.

9. Status- und Readme-Dateien aktualisieren

Eine Status-/Dashboard-Datei aktualisieren, falls das Projekt eine verwendet, z. B.:

PROJECT_STATUS.md

Nützliche Hilfsdateien:

  • readme_website.txt: wie man die Website bearbeitet, vorschaut, baut und committet.
  • readme_git.txt: Git-Einrichtung und häufige Befehle.
  • WEBSITE_WORKFLOW.md: Langzeit-Workflow.

Status knapp halten. Keine unnötigen Git-Details hinzufügen, es sei denn, der Benutzer fragt danach.

Ausgabeerwartungen

Am Ende eines ersten Durchlaufs sollte das Projekt Folgendes haben:

  • Extrahiertes CV-Quell-Markdown.
  • Website-Strukturentwurf.
  • Eine funktionierende Astro-Website.
  • Inhalt von Seiten-/Layout-Code getrennt.
  • Einen erfolgreichen Build.
  • Eine lokale Vorschau-URL.
  • Klare Notizen, was noch aussteht.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills