Brag-Dokument aus der Git-Historie
Ziel: Verwandele das, was du tatsächlich ausgeliefert hast, in einen bearbeitbaren Entwurf, ohne Wirkung zu erfinden. Ein Brag-Dokument listet Arbeit und Ergebnisse auf; dieses Skill sammelt die Arbeit und markiert jedes fehlende Ergebnis als eine Lücke, die du füllen musst.
Schritt 1: Sammle die Belege
Frage nach dem Zeitfenster (Standard: die letzten 6 Monate) und den Repositories. Führe dann mit der angemeldeten GitHub CLI aus:
gh search prs --author @me --merged --merged-at ">=YYYY-MM-DD" --json title,url,closedAt,repository --limit 200
Für Code, der nicht auf GitHub liegt, verwende git log --author="<Name oder E-Mail>" --since="YYYY-MM-DD" --no-merges --pretty="%h %ad %s" --date=short in jedem Repository. Frage den Benutzer auch nach Dingen, die Git nicht zeigen kann: bearbeitete Vorfälle, Mentoring, durchgeführte Reviews, Vorträge, Dokumentation, Bereitschaftsdienst, Designentscheidungen, nette Worte von Kollegen.
Lies keine privaten Repositories, die der Benutzer nicht genannt hat. Errate keine Namen, Teams oder Zahlen.
Schritt 2: Gruppieren, noch nicht zusammenfassen
Gruppiere die Elemente in Themen (z. B. Zuverlässigkeit, neue Funktionen, Leistung, Werkzeuge, Mentoring, teamübergreifende Arbeit). Liste jedes Element unter seinem Thema mit Datum und Link auf. Entferne Duplikate (ein Feature-PR plus seine Folge-Fixes).
Schritt 3: Entwurf für jedes Thema
Schreibe für jedes Thema:
- Was ich getan habe: ein oder zwei Sätze in einfachen Verben, die nur das verwenden, was die Titel, Diffs und Benutzernotizen hergeben.
- Ergebnis: nur wenn eine Zahl, ein Zitat oder ein Ergebnis angegeben wurde. Andernfalls schreibe
[GAP: was hat sich für Nutzer oder das Team geändert? irgendeine Kennzahl vorher/nachher?]. - Nachweise: Links.
- Umfangssignal (falls unterstützt): geleitet, allein gemacht, teamübergreifend gearbeitet, war im Bereitschaftsdienst, hat andere reviewed.
Schritt 4: Abschluss mit Lücken und Fragen
Beende mit einer Liste aller [GAP], geordnet nach ihrer Bedeutung für die Stärkung des Falls, und den drei Fragen, deren Antworten am meisten beitragen würden. Biete an, die endgültige Version in eine Selbsteinschätzung, eine Beförderungsvorlage oder Lebenslaufaufzählungspunkte umzuwandeln.
Regeln
- Erfinde niemals Kennzahlen, Prozentsätze, Kundennamen, Titel oder Umfang. Eine sichtbare Lücke ist besser als eine erfundene Zahl.
- Übertreibe nicht: „hat beigetragen zu“ bleibt „hat beigetragen zu“. Passe die Verben an die Belege an.
- Halte die Anerkennung des Benutzers ehrlich: Wenn ein PR eine Teamleistung war, sage, welcher Teil von ihm stammt.
- Halte private oder vertrauliche Details außen vor, es sei denn, der Benutzer sagt, dass das Dokument intern ist.
- Gib die Ausgabe als Markdown aus, das der Benutzer in seine Notizen einfügen kann.