添加实验室成员 是做什么的?
本技能将引导您完成向网站添加新实验室成员的过程,包括格式处理、简介撰写和图片处理。
何时使用此技能
在以下情况下使用此技能:
- "添加一位新实验室成员"
- "为 [姓名] 创建个人资料"
- "将 [姓名] 添加到团队页面"
- "更新 [姓名] 的职位"
- "将 [姓名] 标记为校友"
- 任何涉及添加或更新团队成员资料的请求
交互式工作流程
步骤 1:收集基本信息
向用户询问关键信息:
必填项:
- 全名
- 职位 (pi, postdoc, staff, phd, ms, ra, programmer, undergrad, highschool)
可选项(如果未提供,我们将进行调研):
- 电子邮件地址
- GitHub 用户名
- LinkedIn 个人资料
- 个人网站
- 当前机构/项目(如果是学生)
如果初始请求中未提供这些信息,请使用 AskUserQuestion 收集。
步骤 2:网页调研
通过网络调研收集背景信息:
-
搜索 LinkedIn 获取教育背景和工作经历
- 查询:"[全名] LinkedIn [已知机构]"
- 提取:学位、机构、先前职位
-
搜索 GitHub 获取用户名和项目
- 查询:"[全名] GitHub [已知邮箱域名]"
- 提取:用户名、知名仓库
-
搜索机构页面 获取简介信息
- 查询:"[全名] [机构] 神经科学/生物学/计算机科学"
- 提取:研究兴趣、当前工作
-
搜索出版物(如果适用,针对博士/博士后)
- 查询:"[全名] [机构] 出版物"
- 提取:研究领域
向用户呈现结果:
- 展示找到的信息
- 请用户确认准确性
- 对不清楚的内容请求澄清
- 请求任何缺失的关键信息
步骤 3:草拟简介
根据收集到的信息和角色对应的模板:
-
根据角色确定简介长度:
- PI:250-300 词(详细)
- 博士生/博士后/员工:100-150 词
- 硕士生/研究助理/程序员:80-120 词
- 本科生:80-100 词
- 校友:50-250 词(根据任期和成就)
-
遵循 templates/ 目录中的简介模板:
- 使用第三人称
- 专业、学术口吻
- 包含:教育背景、加入日期、研究重点/当前工作
- 如果适用,提及合作导师
- 如果相关,突出先前经验
- 如果显著,注明奖项/奖学金
-
向用户呈现草稿:
- 展示草拟的简介
- 询问是否希望进行任何编辑
- 根据反馈进行修改
步骤 4:处理头像
-
向用户索要图片:
- "您有 [姓名] 的头像吗?"
- 如果有:"请提供图片文件的路径"
- 如果没有:"我们可以暂时使用占位符,稍后再添加"
-
如果提供了图片,进行验证和优化:
- 使用
file或sips检查文件大小和尺寸 - 目标规格:100-250 KB,合理接近正方形
- 如果太大(>500 KB)或宽高比不合适:
- 提议使用 scripts/optimize-image.sh 进行调整/优化
- 如果可用,使用
sips(macOS)或convert(ImageMagick)
- 使用
-
生成图片文件名:
- 格式:
名-姓.jpg - 确保没有空格或特殊字符
- 使用正确的名称复制到
images/目录
- 格式:
步骤 5:生成成员文件
-
创建文件名:
_members/名-姓.md -
构建 YAML frontmatter:
--- name: [全名] image: images/[名-姓].jpg role: [职位] description: [来自 roles.yaml 的职位显示文本] links: email: [如果提供了电子邮件] github: [如果找到/提供了用户名] linkedin: [如果找到/提供了个人资料] home-page: [如果提供了 URL] ---- 仅包含可用的链接
- 删除空的链接字段
-
添加简介文本(来自步骤 3)
-
将文件写入
_members/名-姓.md
步骤 6:处理校友(如果适用)
如果职位是 alumni 或用户表示此人即将离开:
-
询问校友详细信息:
- 他们离开的年份
- 在实验室期间的职位(如果与当前不同)
- "下一个"职位(他们将前往何处)
-
更新 team/index.md:
- 读取当前的校友部分
- 按时间顺序添加条目(最近的在最前):
- 年份: [**姓名**](/members/名-姓.html) (职位描述). **下一个:** [下一个职位] - 保持格式正确
步骤 7:验证
运行验证检查:
- 成员文件存在于
_members/名-姓.md - YAML frontmatter 有效
- 角色有效(对照 roles.yaml 检查)
- 图片文件存在(或已注明为占位符)
- 简介长度适合该角色
- 简介使用第三人称
- 链接格式正确
- 如果是校友:已更新 team/index.md
步骤 8:呈现摘要
向用户展示已创建的内容:
✓ 已为 [姓名] 创建成员资料
✓ 文件: _members/名-姓.md
✓ 职位: [职位显示文本]
✓ 图片: images/名-姓.jpg [或 "占位符 - 稍后添加"]
✓ 链接: [包含的链接列表]
[✓ 已更新校友列表] [如果适用]
简介预览:
[简介的前 100 个字符]...
是否需要我展示完整的文件内容?
步骤 9:可选提交
询问用户是否希望提交更改:
- 如果是:创建带有适当消息的 Git 提交
- 如果否:保留为未暂存的更改,供人工审查
简介撰写指南
语调和口吻
- 始终用第三人称:"Jane 是一名博士生..."(而不是 "我是...")
- 专业且学术:正式但不死板
- 基于事实、突出成就:专注于资历和工作
- 当前工作用现在时:"正在研究"、"开发"、"探索"
- 背景信息用过去时:"获得了"、"曾工作于"、"加入了"
必要元素
所有成员都应包含:
- 当前职位和机构
- 加入时间(月和年)
- 教育背景(学位、专业、机构)
- 当前研究/工作重点
按角色划分的其他元素:
PI:
- 博士院校和导师(带超链接)
- 研究理念和方法
- 显著出版物或媒体报道
- 先前职位
- 重要奖项和荣誉
博士生/博士后:
- 本科和/或硕士院校
- 具体研究兴趣
- 如果适用,合作导师
- 如果显著,先前研究经验
员工/程序员:
- 先前工作经验(行业或学术)
- 技术专长和重点领域
- 正在进行的项目
- 如果适用,联合任命
学生(硕士/本科生):
- 专业和年级
- 研究兴趣
- 如果适用,先前的实习或研究
- 如果显著,奖项/奖学金
校友:
- 基于其角色的以上所有内容
- 导师(特别是对短期实习生)
- 在实验室期间的成就
- 夏季实习生保持简洁(50-80 词)
应避免的内容
- 第一人称叙述(PI 简介可能除外)
- 关于项目的过多细节(保持 1-2 句话)
- 将来时或猜测
- 随意的语言或俚语
- 与研究无关的个人信息
- 与 frontmatter 重复(姓名、职位已在别处显示)
图片处理细节
首选规格
- 格式:JPG(首选)或 PNG
- 大小:100-250 KB(针对网络优化)
- 宽高比:正方形或接近正方形 (1:1 或 4:5)
- 最小尺寸:300x300 像素
- 推荐尺寸:400x400 至 600x600 像素
- 色彩:RGB 色彩空间
优化过程
如果图片需要优化:
# 使用捆绑脚本
bash .claude/skills/add-member/scripts/optimize-image.sh 输入文件.jpg 输出文件.jpg 500
或使用 sips 手动操作(macOS):
# 将最大尺寸调整为 500px,保持宽高比
sips -Z 500 输入文件.jpg --out 输出文件.jpg
# 将 PNG 转换为 JPG
sips -s format jpeg 输入文件.png --out 输出文件.jpg
或使用 ImageMagick:
# 调整大小并优化
convert 输入文件.jpg -resize 500x500^ -quality 85 输出文件.jpg
文件名规范
- 使用 kebab-case:
名-姓.jpg - 无空格、特殊字符或大写字母
- 与成员文件 slug 匹配
- 示例:
jane-doe.jpg、john-smith.jpg
按角色划分的注意事项
添加校友
添加已离开的人员时:
- 在 frontmatter 中设置
role: alumni - 在简介文本中包含其实际职位
- 更新
team/index.md的校友部分,包含:- 离开年份
- 括号中的职位描述
- 如果知道,加上 "下一个:" 注释
处理合作导师
当成员有合作导师时:
- 在简介中提及:"由 [姓名] 共同指导"
- 如果可能,包含超链接:
[姓名](URL) - 在向用户呈现摘要时注明
联合任命
当成员有联合隶属关系时:
- 在简介中提及:"与 [实验室名称] 联合"
- 如果可用,包含其他实验室的超链接
- 清晰地注明合作 PI
职位过渡的学生
当学生从本科生→硕士生→博士生过渡时:
- 创建新的成员文件?不 - 保留同一文件
- 更新 frontmatter 中的
role:字段 - 更新简介以反映新状态
- 更新
description:字段 - 考虑在简介中添加关于过渡的说明
夏季实习生
短期成员(2-3 个月):
- 活跃期间:以职位
undergrad或highschool添加 - 离开时:改为
role: alumni - 简介:可以简短(50-80 词),但突出:
- 机构与项目
- 他们从事的工作
- 指导他们的人
- 任何显著成就
错误处理
如果网页搜索找不到任何信息:
- 请用户直接提供信息
- 主动提出草拟最简简介,并让他们扩充
如果图片格式/尺寸错误:
- 主动提出使用提供的工具进行优化
- 如果工具不可用,提供手动说明
- 最坏情况:使用占位符并在摘要中注明
如果不确定职位:
- 提供来自 roles.yaml 的职位选项
- 使用 AskUserQuestion 澄清
如果存在重复成员:
- 检查是更新还是新成员
- 询问用户是希望更新现有还是创建新文件
验证检查清单
在最终确定前,验证:
- 全名在文件名、frontmatter 和简介中保持一致
- 职位有效(值为:pi、postdoc、staff、phd、ms、ra、programmer、undergrad、highschool、alumni)
- 图片文件名符合规范(kebab-case、.jpg)
- 简介通篇使用第三人称
- 简介长度适合该角色(参见指南)
- 简介中提到了加入日期(月和年)
- 包含教育背景
- 所有链接格式正确
- YAML frontmatter 有效(使用解析器测试)
- 如果是校友:已正确更新 team/index.md
- 无尾部空白或格式问题
相关资源
- reference.md - 关于成员文件格式和模式的详细文档
- examples.md - 不同场景的示例工作流程
- templates/ - 每种角色类型的简介模板