Communitygithub.com

osslab-pku/osslab-pku.github.io

新增或更新 `_people/` 中的成員個人檔案及其照片。適用於成員加入實驗室、畢業、職稱或角色變更、新增個人網站,或個人照片遺失/損壞時。

osslab-pku.github.io 是什麼?

此技能為一個 Git 操作輔助工具,專門管理 PKU OSSLab 網站上的成員個人資料。它提供了一套完整的流程,用於在 `_people/` 目錄下新增或更新成員檔案(如 `runzhihe.md`),並同步處理 `assets/images/` 中的個人照片。技能能自動辨識 `type` 欄位(如 `advisor`、`phd`、`undergraduate` 等),決定成員在「成員」頁面上的歸類區塊。此外,此技能會自動檢查角色變更時需同步更新 `type` 與 `subtitle` 兩個欄位,避免卡片顯示錯誤。照片部分會驗證 URL 格式為絕對路徑,並檢查檔案大小寫是否正確(避免 404 錯誤),同時支援照片壓縮(600×600 約 30 KB)。當成員設有 `personal_website` 時,技能會自動將個人卡片改為外部連結。支援平台為基於 GitHub Pages 的 Jekyll 靜態網站。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

成員個人檔案

每位成員對應 _people/ 中的一個檔案,檔案名稱採全小寫且不含分隔符(例如 runzhihe.md)。請複製相鄰檔案中的格式。以下僅列出值得優先注意的陷阱。

type 決定成員出現在哪個區塊

有效值:advisor、phd、undergraduate、visiting、graduated。

postdoc 和 master 區塊存在於 _layouts/people-overview.html 中,但已被註解。如果某個成員的 type 設為這兩個值,檔案可以正常建置,但該成員永遠不會出現在任何頁面上。若需要啟用,請在同一變更中取消註解對應區塊,並在提交訊息中說明。

角色變更必定涉及兩個欄位

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

只修改 subtitle 會讓成員被歸到錯誤的標題下;只修改 type 則會使卡片上顯示過時的職稱。畢業也是同樣的格式:type: graduated 加上重新撰寫的 subtitle。

照片

image 為絕對 URL(例如 https://osslab-pku.github.io/assets/images/name.jpg),且檔案需放在 assets/images/ 中。

使用 ls 指令確認實際檔案名稱的大小寫。 若照片儲存為 liangliu.JPG 但引用為 .jpg,在 macOS 上能正常顯示,但在正式網站上會回傳 404。此問題已修正過兩次。新檔案建議統一使用小寫 .jpg,若無提供照片則使用 placeholder.png。

提交前請先壓縮照片——請參閱 AGENTS.md 中的「提交前壓縮圖片」。個人照片建議為 600×600 裁切,大小約 30 KB。

personal_website 會隱藏個人頁面

當此欄位被設定時,卡片會直接連結至該外部 URL,而非此處的個人頁面;因此該檔案的正文將無法被存取。僅在成員確實希望如此時才設定此欄位。

相關技能