Portfolio Showcase Generator
Ein umfassendes Skill zur Umwandlung technischer Projekte in professionelle Portfolio-Stücke, optimiert für verschiedene Zielgruppen (Personalverantwortliche, Einstellungsmanager, Architekten, technische Leiter).
Kernfunktionen
- Code-Analyse – Analyse der GitHub-Repository-Struktur, des Tech-Stacks, der Architekturmuster
- Zielgruppenanpassung – Generierung von Inhalten für Führungskräfte, Architekten und technische Teams
- Architekturvisualisierung – Erstellung von System-, Datenfluss- und Bereitstellungsdiagrammen
- Impact-Quantifizierung – Extraktion und Präsentation von Geschäftskennzahlen und technischen Errungenschaften
- Multi-Format-Ausgabe – Executive Summaries, technische Tiefenbohrungen, Interview-Geschichten, GitHub-Pages
Wann dieses Skill verwenden
Verwenden Sie dieses Skill, wenn der Benutzer Folgendes möchte:
- Ein technisches Projekt in Portfolio-Materialien umwandeln
- Überzeugende Fallstudien aus seiner Arbeit erstellen
- Vorbereitungsmaterialien für Vorstellungsgespräche generieren (STAR-Format-Geschichten)
- Eine professionelle GitHub-Pages-Showcase-Seite aufbauen
- Geschäftsauswirkungen aus technischen Errungenschaften extrahieren
- Zielgruppenspezifische Projektzusammenfassungen erstellen
Eingabeformate
Das Skill akzeptiert mehrere Eingabeformate:
1. GitHub-Repository
- Repository-URL oder lokaler Pfad
- Analysiert: Dateistruktur, Code-Muster, Tech-Stack, Abhängigkeiten, Dokumentation
- Extrahiert: Architekturmuster (DDD, Microservices usw.), Frameworks, Cloud-Dienste
2. Projektkontext (beliebige Kombination)
- Rohe Notizen/Aufzählungen – Kurze Erfassungen von Errungenschaften und Details
- Technische Spezifikationen – Architekturdokumente, Design-Dokumente
- Gesprächsform – Der Benutzer beschreibt das Projekt natürlich
- Vorhandene Dokumentation – README-Dateien, Wikis, ADRs
3. Geschäftskontext
- Projektziele und -vorgaben
- Gelöste Probleme
- Stakeholder und Benutzer
- Zeitplan und Teamgröße
- Einschränkungen und Herausforderungen
Ausgabegenerierung
1. Executive Summary (für Einstellungsmanager/Personalverantwortliche)
Zweck: Kurzer, wirkungsvoller Überblick mit Fokus auf Geschäftswert und Ergebnisse.
Struktur:
- Projektübersicht (2-3 Sätze): Was es ist, warum es wichtig ist
- Wichtigste Errungenschaften (3-5 Aufzählungspunkte): Quantifizierte Geschäftsauswirkung
- Technische Highlights (kurz): Bemerkenswerte Technologien/Ansätze
- Zeitplan & Umfang: Dauer, Teamgröße, Rolle
- Impact-Metriken: Leistungssteigerungen, Kosteneinsparungen, Nutzerkennzahlen
Ton: Professionell, selbstbewusst, ergebnisorientiert. Jargon minimieren. Mit Ergebnissen beginnen.
Länge: 150-250 Wörter (30-60 Sekunden Lesedauer)
2. Technische Tiefenbohrung (für Architekten/Technische Leiter)
Zweck: Architektonisches Denken, technische Tiefe und technisches Urteilsvermögen demonstrieren.
Struktur:
- Kontext & Einschränkungen: Anforderungen, Einschränkungen, bestehende Systeme
- Architekturentscheidungen: Wichtige Design-Entscheidungen mit Begründung
- Technische Implementierung:
- Systemarchitektur
- Tech-Stack und warum
- Angewandte Muster (DDD, CQRS, Event Sourcing usw.)
- Integrationspunkte
- Herausforderungen & Lösungen: Technische Probleme und wie Sie sie gelöst haben
- Skalierung & Leistung: Metriken, Optimierungsstrategien
- Sicherheit & Qualität: Tests, Beobachtbarkeit, Sicherheitsmaßnahmen
- Kompromisse: Wofür optimiert wurde, was geopfert wurde, warum
Ton: Technisch, aber zugänglich. Begründungen erklären, nicht nur Entscheidungen nennen. Urteilsvermögen zeigen.
Länge: 800-1500 Wörter (4-6 Minuten Lesedauer)
3. Architekturdiagramme (Mermaid)
Generieren Sie relevante Diagramme basierend auf dem Projekttyp:
Systemarchitektur-Diagramm:
graph TB
Client[Clientanwendung]
API[API-Gateway]
Service1[Dienstname]
Service2[Dienstname]
DB[(Datenbank)]
Cache[(Cache)]
Client --> API
API --> Service1
API --> Service2
Service1 --> DB
Service1 --> Cache
Datenflussdiagramm:
flowchart LR
Source[Datenquelle] --> Ingestion[Erfassungsebene]
Ingestion --> Processing[Verarbeitung]
Processing --> Storage[(Speicher)]
Storage --> API[API-Ebene]
API --> Consumer[Verbraucher]
Bereitstellungsdiagramm:
graph TB
subgraph Azure
subgraph VNet
AppService[App Service]
Function[Azure Functions]
end
DB[(SQL-Datenbank)]
Storage[(Blob-Speicher)]
end
AppService --> DB
Function --> Storage
Richtlinien:
- Verwenden Sie den passenden Diagrammtyp für den Inhalt
- Halten Sie Diagramme fokussiert (maximal 5-12 Knoten)
- Verwenden Sie klare, beschreibende Beschriftungen
- Fügen Sie ggf. eine Legende für Farben/Formen hinzu
- Generieren Sie bei komplexen Projekten mehrere Diagramme
4. Metriken & Impact-Analyse
Extrahieren und präsentieren Sie quantifizierbare Errungenschaften:
Technische Metriken:
- Leistungsverbesserungen (Antwortzeit, Durchsatz usw.)
- Skalierbarkeitserfolge (unterstützte Benutzer, Transaktionen/Sekunde)
- Codequalität (Testabdeckung, Fehlerreduzierung)
- Zuverlässigkeit (Verfügbarkeit, MTTR, Fehlerraten)
- Sicherheitsverbesserungen (behobene Schwachstellen, Compliance)
Geschäftsmetriken:
- Kosteneinsparungen (Infrastruktur, Entwicklungszeit)
- Umsatzauswirkungen (neue Fähigkeiten, Markterweiterung)
- Effizienzgewinne (Automatisierung, reduzierte manuelle Arbeit)
- Benutzerzufriedenheit (NPS, Akzeptanzraten)
- Time-to-Market (Liefergeschwindigkeit, Release-Häufigkeit)
Format: Präsentieren Sie konkrete Zahlen mit Kontext:
- „API-Antwortzeit um 60 % reduziert (450 ms → 180 ms)“
- „Cloud-Kosten durch Ressourcenoptimierung um 24.000 $/Jahr gesenkt“
- „10-fache Skalierung von 1.000 auf 10.000 gleichzeitige Benutzer ermöglicht“
5. Vorbereitung auf Vorstellungsgespräche (STAR-Format)
Generieren Sie 2-4 überzeugende Geschichten im STAR-Format:
Struktur:
- Situation: Kontext, Problem, Einschränkungen (2-3 Sätze)
- Aufgabe: Ihre spezifische Verantwortung (1-2 Sätze)
- Handlung: Was Sie getan haben, technische Entscheidungen, Implementierung (3-5 Sätze)
- Ergebnis: Ergebnisse, Metriken, Auswirkungen (2-3 Sätze)
Länge: Jede Geschichte sollte bei mündlicher Präsentation 90-120 Sekunden dauern
Fokus: Unterschiedliche Geschichten sollten hervorheben:
- Technische Problemlösung
- Architektonische Entscheidungsfindung
- Führung/Einflussnahme
- Umgang mit Einschränkungen/Kompromissen
6. GitHub Pages Site
Generieren Sie eine vollständige statische Seitenstruktur:
Startseite (index.html):
- Hero-Bereich mit Projektname und Slogan
- Kurzübersicht (Tech-Stack, Zeitplan, Impact-Metriken)
- Navigation zu den Abschnitten
- Screenshot/Demo (falls verfügbar)
Architektur-Seite (architecture.html):
- Systemübersicht
- Architekturdiagramme (eingebettetes Mermaid)
- Tech-Stack-Details
- Design-Entscheidungen
Impact-Seite (impact.html):
- Geschäftsergebnisse
- Technische Errungenschaften
- Metrikvisualisierung
- Vorher-Nachher-Vergleiche
Demo-Seite (demo.html – falls zutreffend):
- Interaktive Demo oder Rundgang
- Screenshots mit Anmerkungen
- Nutzungsszenarien
- Videoeinbettung (falls verfügbar)
Gestaltung:
- Sauberes, professionelles Design
- Für Mobilgeräte optimiert
- Schnell ladend (minimale Abhängigkeiten)
- Barrierefrei (WCAG-konform)
- Optional: Verwendung von GitHub’s Primer CSS oder Tailwind CDN
Workflow
Schritt 1: Eingabe sammeln
-
Nach der Projektquelle fragen:
- GitHub-Repo-URL/Pfad
- Vorhandene Dokumentation
- Projektskizzen
-
Kontext verstehen:
- Welches Problem wurde gelöst?
- Für wen war es?
- Was war Ihre Rolle?
- Was machte es herausfordernd?
- Was waren die Ergebnisse?
-
Ausgaben klären:
- Welche Ergebnisse werden benötigt?
- Gibt es spezifische Anforderungen (Länge, Schwerpunkte)?
- Details zur Zielgruppe?
Schritt 2: Analyse (falls GitHub-Repo bereitgestellt)
Verwendung von Bash-/View-Tools zur Analyse des Repositorys:
# Repository-Struktur analysieren
find /path/to/repo -type f -name "*.cs" -o -name "*.csproj" | head -20
find /path/to/repo -type f -name "*.yml" -o -name "*.yaml"
# Nach Architekturdokumenten suchen
find /path/to/repo -type f -name "*.md" | grep -i "architecture\|design\|adr"
# Abhängigkeiten analysieren
cat /path/to/repo/*.csproj
cat /path/to/repo/package.json
cat /path/to/repo/requirements.txt
# Nach Konfiguration suchen
find /path/to/repo -name "appsettings*.json" -o -name "*.config"
Extrahieren Sie:
- Tech-Stack: Sprachen, Frameworks, Datenbanken, Cloud-Dienste
- Muster: DDD, Microservices, Event-Driven, CQRS usw.
- Architektur: Monolith, Microservices, Serverless usw.
- Infrastruktur: Cloud-Anbieter, Bereitstellungsstrategie
- Qualitätspraktiken: Tests, CI/CD, Monitoring
Schritt 3: Inhalte generieren
Generieren Sie jede angeforderte Ausgabeart gemäß den obigen Strukturen.
Schlüsselprinzipien:
- Zielgruppenorientiert: Tiefe und Jargon an die Zielgruppe anpassen
- Evidenzbasiert: Behauptungen nach Möglichkeit mit Code/Dokumenten belegen
- Quantifizieren: Immer Zahlen und Metriken einbeziehen
- Geschichtengetrieben: Betonung von Herausforderungen → Lösungen → Auswirkungen
- Ehrlich: Einschränkungen und Kompromisse anerkennen
Schritt 4: Artefakte erstellen
Für Dokumente (Zusammenfassungen, Tiefenbohrungen):
- Markdown-Format verwenden
- Klare Abschnitte mit Überschriften einfügen
- Code-Snippets (wo relevant) hinzufügen
- Diagramme einbetten
Für GitHub Pages:
- Vollständige HTML-Dateien generieren
- Inline-CSS oder CDN-Referenz einfügen
- Mobile Reaktionsfähigkeit sicherstellen
- Meta-Tags für SEO hinzufügen
Für Diagramme:
- Mermaid Chart Tool zum Rendern verwenden
- Sowohl Mermaid-Quelle als auch gerendertes Bild bereitstellen
- Sicherstellen, dass Diagramme selbsterklärend sind
Schritt 5: Ergebnisse paketieren
Organisieren Sie die Ergebnisse nach den Bedürfnissen des Benutzers:
Für Bewerbungen:
- Executive Summary (kopierfertig)
- 2-3 STAR-Geschichten
- Liste der wichtigsten Metriken
Für Portfolio-Seite:
- Vollständige GitHub Pages-Struktur
- Alle Assets organisiert
- Bereitstellungsanweisungen
Für Vorstellungsgespräche:
- STAR-Geschichten (ausgedruckt/PDF)
- Architekturdiagramm (als Referenz für Whiteboard-Übungen)
- Metrik-Spickzettel
Besondere Überlegungen
.NET/Azure-Projekte
- Hervorheben: DDD-Muster, SOLID-Prinzipien, Async/Await-Muster
- Betonen: Zero Trust, InfoSec-Compliance, Enterprise-Muster
- Tech-Stack: .NET-Version, verwendete Azure-Dienste, Designmuster
Machine Learning/Computer Vision-Projekte
- Fokus: Problemdefinition, Modellauswahl-Begründung, Leistungsmetriken
- Hervorheben: Trainingsansatz, Datenpipeline, Inferenzoptimierung
- Metriken: Genauigkeit, Präzision, Recall, F1, Inferenzlatenz
Integrationsprojekte
- Betonen: API-Design, Fehlerbehandlung, Datenkonsistenz
- Hervorheben: Drittanbieter-Integrationen, Ratenbegrenzung, Resilienzmuster
- Metriken: Zuverlässigkeit (Verfügbarkeit), Datengenauigkeit, Durchsatz
Enterprise-/Großprojekte
- Kontext: Skalierung, Compliance-Anforderungen, Legacy-Einschränkungen
- Hervorheben: Migrationsstrategien, Rückwärtskompatibilität, Risikominderung
- Metriken: Skalierungszahlen, Leistung unter Last, Kostenoptimierung
Ausgabeformat
Bei der Generierung mehrerer Ausgaben wie folgt organisieren:
# Portfolio Showcase: [Projektname]
## Kurzübersicht
- **Tech-Stack**: [Liste]
- **Dauer**: [Zeitplan]
- **Rolle**: [Ihre Rolle]
- **Impact**: [Top 1-2 Metriken]
## Generierte Ausgaben
### 1. Executive Summary
[Inhalt]
### 2. Technische Tiefenbohrung
[Inhalt]
### 3. STAR-Geschichten
#### Geschichte 1: [Titel]
[Inhalt]
#### Geschichte 2: [Titel]
[Inhalt]
### 4. Architekturdiagramme
[Diagramme mit Erklärungen]
### 5. Metrik-Dashboard
[Formatierte Metriken]
### 6. GitHub Pages-Dateien
[Dateistruktur und Inhalt]
Qualitäts-Checkliste
Vor der Auslieferung sicherstellen:
- Alle Metriken sind spezifisch und quantifiziert
- Technische Begriffe werden für die Zielgruppe erklärt oder begründet
- Diagramme sind klar und ordnungsgemäß beschriftet
- STAR-Geschichten sind vollständig (alle 4 Elemente)
- Executive Summary besteht den „Elevator-Pitch“-Test
- Technische Tiefenbohrung zeigt architektonisches Denken
- GitHub Pages sind mobil reaktionsfähig und barrierefrei
- Keine grammatikalischen Fehler oder Tippfehler
- Konsistente Terminologie durchgängig
- Errungenschaften werden als Impact dargestellt, nicht als Aufgaben
Beispiel-Prompts
Einfach: „Erstelle eine Portfolio-Showcase für mein DocFlow-Projekt auf GitHub“
Ausführlich: „Ich habe ein Flugstatus-Dashboard mit .NET 8, DDD und Azure gebaut. Es war die erste App, die in unserer Zero-Test-Umgebung bereitgestellt wurde. Ich brauche eine Executive Summary für Personalverantwortliche und eine technische Tiefenbohrung für das Vorstellungsgespräch, plus Architekturdiagramme.“
Gesprächsform: „Ich möchte mein KI-Dokumentenscanner-Projekt präsentieren. Es verwendet Computer Vision, um Daten aus Whiteboards zu extrahieren, und integriert sich in mehrere Systeme. Können Sie mir helfen, Materialien für meine Portfolio-Seite zu erstellen?“
Tipps für Benutzer
Für die besten Ergebnisse:
- Nach Möglichkeit GitHub-Zugriff bereitstellen (reichhaltigste Informationsquelle)
- Das „Warum“ hinter dem Projekt teilen (Geschäftskontext ist wichtig)
- Alle Metriken einbeziehen, die Sie verfolgt haben (auch informelle)
- Herausforderungen erwähnen, die Sie gemeistert haben (diese ergeben großartige Geschichten)
- Ihre Zielgruppe angeben (die technische Tiefe variiert stark)
- Notieren, worauf Sie stolz waren oder was Sie gelernt haben (authentische Details kommen gut an)
Häufige Fehler, die vermieden werden sollten:
- Zu bescheiden sein (das Portfolio ist nicht der Ort für Bescheidenheit)
- Aufgaben statt Errungenschaften auflisten („API gebaut“ vs. „API entworfen, die die Latenz um 40 % reduziert hat“)
- Jargon ohne Kontext für nicht-technische Zielgruppen verwenden
- Quantifizierung des Impacts vergessen
- Es wie einen Teambericht klingen lassen, statt Ihren eigenen Beitrag hervorzuheben