Communitygithub.com

osslab-pku/osslab-pku.github.io

Mitgliedsprofil in `_people/` und dessen Foto hinzufügen oder aktualisieren. Verwenden, wenn jemand dem Labor beitritt, es verlässt, die Rolle oder den Titel wechselt, eine persönliche Website hinzufügt oder wenn ein Profilfoto fehlt oder defekt ist.

Was ist osslab-pku.github.io?

Diese Skill ermöglicht die Verwaltung der Mitgliederprofile im Open-Source-Softwarelabor der Peking-Universität (PKU). Sie definiert die Struktur von Profildateien in `_people/`, die nach dem Muster `vornamenachname.md` benannt sind, und erklärt, wie das Feld `type` (z. B. `advisor`, `phd`, `graduated`) die Position des Mitglieds auf der Laborseite bestimmt. Die Skill behandelt auch kritische Details wie korrekte Groß-/Kleinschreibung von Fotodateien (da falsche Großschreibung zu 404-Fehlern führen kann), die Komprimierung von Bildern vor dem Commit und die Verwendung von `personal_website`, um den internen Profillink zu überschreiben. Sie wird in Entwicklungsumgebungen wie Claude Code, Cursor oder Codex verwendet, um Änderungen an den Labor-Mitgliederdaten konsistent und fehlerfrei zu halten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/osslab-pku/osslab-pku.github.io/tree/HEAD/.agents/skills/manage-people

In Ihrer bevorzugten KI fragen

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

Dokumentation

Mitgliederprofile

Eine Datei pro Person in _people/, benannt in Kleinbuchstaben ohne Trennzeichen (runzhihe.md). Kopiere die Form aus einer benachbarten Datei. Nur die folgenden Fallstricke sind es wert, zuerst gelesen zu werden.

type bestimmt, in welchem Abschnitt sie erscheinen

Arbeitswerte: advisor, phd, undergraduate, visiting, graduated.

postdoc und master Blöcke existieren in _layouts/people-overview.html, sind jedoch auskommentiert. Ein Profil mit einem dieser Typen wird zwar korrekt erstellt, erscheint aber nie auf der Seite. Wenn du eines benötigst, kommentiere den entsprechenden Block im selben Änderungsvorgang aus und erwähne dies.

Rollenwechsel bestehen immer aus zwei Feldern

-subtitle: Undergraduate (to be a Ph.D. Student)
+subtitle: 1st Year Ph.D. Student
-type: undergraduate
+type: phd

Nur das subtitle-Feld zu ändern, sortiert die Person unter der falschen Überschrift ein; nur den type zu ändern, hinterlässt einen veralteten Titel auf der Karte. Ein Abschluss (Graduierung) folgt dem gleichen Muster: type: graduated plus ein neu geschriebenes subtitle.

Fotos

image ist eine absolute URL (https://osslab-pku.github.io/assets/images/name.jpg), wobei die Datei in assets/images/ liegt.

Überprüfe die tatsächliche Groß-/Kleinschreibung des Dateinamens mit ls. Ein als liangliu.JPG gespeichertes Foto, das als .jpg referenziert wird, funktioniert unter macOS, verursacht aber auf der Live-Seite einen 404-Fehler. Dies wurde bereits zweimal behoben. Bevorzuge für neue Dateien Kleinbuchstaben in .jpg und verwende placeholder.png, wenn kein Foto bereitgestellt wurde.

Komprimiere vor dem Commit – siehe "Compress images before committing" in AGENTS.md. Profilfotos sollten 600×600 im Cover-Format sein, etwa 30 KB groß.

personal_website versteckt die Profilseite

Wenn gesetzt, verlinkt die Karte nach außen auf diese URL anstatt auf die Seite dieser Person hier, sodass der Inhalt der Datei nicht mehr erreichbar ist. Setze dies nur, wenn die Person das auch wünscht.

Verwandte Skills