Communitygithub.com

osslab-pku/osslab-pku.github.io

在 `_people/` 中添加或更新实验室成员的个人资料及其照片。适用于成员加入、毕业、职位变更、添加个人网站,或头像缺失/损坏时使用。

osslab-pku.github.io 是什么?

该技能专为 OSSLab-PKU 实验室网站管理设计,用于在 `_people/` 目录下维护每个成员的 Markdown 个人资料文件,并同步更新 `assets/images/` 中的照片。它支持多种成员类型(如顾问、博士生、本科生等),并能通过简单的字段修改实现角色变更(如从本科生变为博士生),同时自动调整成员在网站上的分类位置。技能还重点处理了照片管理的常见陷阱:要求使用绝对 URL、注意文件名大小写(避免线上 404 错误)、建议压缩至约 30KB 并保持 600×600 尺寸。此外,`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 中但被注释掉了。使用这两种类型的个人资料可以正常构建但永远不会显示在任何地方。如果你需要启用它们,请在同一更改中取消注释对应的块并加以说明。

角色变更始终需要修改两个字段

-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 而不是成员在站内的详情页,因此文件正文变得无法访问。仅在成员本人有此要求时才设置此字段。

相关技能