Was macht sred-work-summary?
Durchsucht das letzte Jahr an Arbeit und erstellt ein Notion-Dokument, das relevante Links in Projekte gruppiert, die dann als SRED-Projekte dokumentiert werden können.
Funktionsweise
Der Skill analysiert Datenquellen wie GitHub Repositories, Jira Projekte oder CI/CD-Pipelines der letzten 12 Monate. Anhand heuristischer Muster werden Issues, Pull Requests, Deployments und andere Aktivitäten zu Projektclustern zusammengefasst. Diese Cluster werden als Blöcke in ein neues Notion-Dokument eingefügt, wobei jeder Block einen Projektnamen, eine Zusammenfassung und die gesammelten Links enthält.
Voraussetzungen
- Zugriff auf die entsprechenden Datenquellen (GitHub Token, Jira API Key etc.)
- Notion Integration API konfiguriert
- Die Datenquellen müssen über einen definierten Zeitraum (1 Jahr) verfügbar sein
Verwendung
# Beispielaufruf
sred-work-summary --source github --org myorg --token $GITHUB_TOKEN
import os
from sred_work_summary import generate_summary
summary = generate_summary(
source="github",
org="myorg",
token=os.environ["GITHUB_TOKEN"]
)
summary.to_notion()
Konfiguration
Umgebungsvariablen:
NOTION_API_KEY– Schlüssel für die Notion APIGITHUB_TOKEN– GitHub Personal Access Token (optional, falls GitHub als Quelle)JIRA_TOKEN– Jira API Token (optional, falls Jira als Quelle)
Ausgabe
Ein Notion-Dokument mit folgender Struktur:
- Überschrift: „SRED Jahreszusammenfassung [Jahr]“
- Tabelle der Projekte mit Status, Aufwand und verlinkten Ressourcen
- Jeder Projektblock enthält eine Liste der zugehörigen Links (Issues, PRs, Commits, Pages)
Fehlerbehandlung
- Falls keine Daten für den Zeitraum gefunden werden, wird eine leere Notion-Seite erstellt mit einem Hinweis.
- API-Rate-Limits werden automatisch mit Retry-Logik behandelt.
- Fehlschlagende Verbindungen werden mit aussagekräftigen Fehlermeldungen gemeldet.