연구실 멤버 추가은(는) 무엇을 하나요?
이 스킬은 올바른 포맷, 약력 작성, 이미지 처리를 통해 새 연구실 멤버를 웹사이트에 추가하는 과정을 안내합니다.
이 스킬을 사용해야 하는 경우
다음과 같은 경우에 이 스킬을 사용하세요:
- "새 연구실 멤버 추가"
- "[이름]의 프로필 생성"
- "[이름]을 팀 페이지에 추가"
- "[이름]의 역할 업데이트"
- "[이름]을 Alumni로 표시"
- 팀 멤버 프로필 추가 또는 업데이트와 관련된 모든 요청
대화형 워크플로우
1단계: 기본 정보 수집
사용자에게 필수 세부 정보를 요청하세요:
필수:
- 전체 이름
- 역할 (pi, postdoc, staff, phd, ms, ra, programmer, undergrad, highschool)
선택 사항 (제공되지 않은 경우 조사할 예정):
- 이메일 주소
- GitHub 사용자 이름
- LinkedIn 프로필
- 개인 웹사이트
- 현재 소속 기관/프로그램 (학생인 경우)
AskUserQuestion을 사용하여 초기 요청에 제공되지 않은 경우 이 정보를 수집하세요.
2단계: 웹 리서치
배경 정보를 수집하기 위해 웹 리서치를 수행하세요:
-
LinkedIn 검색하여 학력 및 경력 조회
- 질의: "[전체 이름] LinkedIn [알고 있는 기관명]"
- 추출: 학위, 기관, 이전 직위
-
GitHub 검색하여 사용자 이름 및 프로젝트 확인
- 질의: "[전체 이름] GitHub [알고 있는 이메일 도메인]"
- 추출: 사용자 이름, 주목할 만한 저장소
-
기관 페이지 검색하여 약력 정보 획득
- 질의: "[전체 이름] [기관명] 신경과학/생물학/컴퓨터과학"
- 추출: 연구 관심 분야, 현재 작업
-
논문 검색 (해당되는 경우, PhD/Postdoc)
- 질의: "[전체 이름] [기관명] publications"
- 추출: 연구 분야
발견한 내용을 사용자에게 제시:
- 찾은 내용을 보여주세요
- 사용자에게 정확성 확인 요청
- 불명확한 부분에 대한 설명 요청
- 누락된 중요한 정보 요청
3단계: 약력 초안 작성
수집된 정보와 역할에 적합한 템플릿을 사용하여:
-
역할에 따른 약력 길이 결정:
- PI: 250~300단어 (상세)
- PhD/Postdoc/Staff: 100~150단어
- MS/RA/Programmer: 80~120단어
- Undergrad: 80~100단어
- Alumni: 50~250단어 (재임 기간 및 성과 기반)
-
templates/ 디렉토리의 약력 템플릿 따르기:
- 3인칭 사용
- 전문적이고 학술적인 어조
- 포함: 교육, 입학일, 연구 초점/현재 작업
- 해당되는 경우 공동 지도교수 언급
- 관련된 경우 이전 경험 강조
- 주목할 만한 상/펠로우십 언급
-
초안을 사용자에게 제시:
- 작성된 약력 보여주기
- 수정할 부분이 있는지 질문
- 피드백에 따라 개선
4단계: 프로필 이미지 처리
-
사용자에게 이미지 요청:
- "[이름]의 프로필 사진이 있나요?"
- 예인 경우: "이미지 파일 경로를 알려주세요"
- 아니오인 경우: "지금은 플레이스홀더를 사용하고 나중에 추가할 수 있습니다"
-
이미지가 제공된 경우 유효성 검사 및 최적화:
file또는sips를 사용하여 파일 크기와 해상도 확인- 목표 사양: 100~250KB, 합리적으로 정사각형 비율
- 너무 크거나(>500KB) 비율이 맞지 않는 경우:
- scripts/optimize-image.sh를 사용하여 크기 조정/최적화 제안
- 가능한 경우
sips(macOS) 또는convert(ImageMagick) 사용
-
이미지 파일명 생성:
- 형식:
firstname-lastname.jpg - 공백이나 특수 문자 없음
- 올바른 이름으로
images/디렉토리에 복사
- 형식:
5단계: 멤버 파일 생성
-
파일명 생성:
_members/firstname-lastname.md -
프론트매터 작성:
--- name: [전체 이름] image: images/[firstname-lastname].jpg role: [역할] description: [roles.yaml의 역할 표시 텍스트] links: email: [제공된 경우 이메일] github: [찾았거나 제공된 경우 사용자 이름] linkedin: [찾았거나 제공된 경우 프로필] home-page: [제공된 경우 URL] ---- 사용 가능한 링크만 포함
- 빈 링크 필드 제거
-
약력 텍스트 추가 (3단계에서)
-
파일 쓰기 (
_members/firstname-lastname.md)
6단계: Alumni 처리 (해당되는 경우)
역할이 alumni이거나 사용자가 이 사람이 떠난다고 표시한 경우:
-
Alumni 세부 정보 요청:
- 떠난(떠날) 연도
- 연구실에서의 역할 (현재와 다른 경우)
- "다음" 직책 (어디로 가는지)
-
team/index.md 업데이트:
- 현재 alumni 섹션 읽기
- 연대순(최신순)으로 항목 추가:
- YEAR: [**Name**](/members/firstname-lastname.html) (Role Description). **Next:** [Next position] - 올바른 포맷 유지
7단계: 유효성 검사
유효성 검사 항목 확인:
- 멤버 파일이
_members/firstname-lastname.md에 존재합니까? - YAML 프론트매터가 유효합니까?
- 역할이 유효합니까? (roles.yaml과 대조)
- 이미지 파일이 존재합니까? (또는 플레이스홀더로 표시)
- 약력이 역할에 적합한 길이입니까?
- 약력이 3인칭을 사용합니까?
- 링크가 올바르게 포맷되었습니까?
- Alumni인 경우: team/index.md가 업데이트되었습니까?
8단계: 요약 제시
사용자에게 생성된 내용을 보여주세요:
✓ [이름]의 멤버 프로필 생성됨
✓ 파일: _members/firstname-lastname.md
✓ 역할: [역할 표시 텍스트]
✓ 이미지: images/firstname-lastname.jpg [또는 "플레이스홀더 - 나중에 추가"]
✓ 링크: [포함된 링크 목록]
[✓ Alumni 목록 업데이트됨] [해당되는 경우]
약력 미리보기:
[약력의 처음 100자]...
전체 파일 내용을 보시겠습니까?
9단계: 선택적 커밋
변경 사항을 커밋할지 사용자에게 질문:
- 예인 경우: 적절한 메시지로 Git 커밋 생성
- 아니오인 경우: 수동 검토를 위해 스테이징되지 않은 변경 사항으로 남김
약력 작성 지침
화자와 어조
- 항상 3인칭: "제인은 박사 과정 학생입니다..." ("저는..." 아님)
- 전문적이고 학술적: 격식 있지만 경직되지 않음
- 사실 기반 및 성과 중심: 자격 증명과 작업에 초점
- 현재 작업에는 현재 시제: "연구 중", "개발 중", "조사 중"
- 배경에는 과거 시제: "받았습니다", "근무했습니다", "합류했습니다"
필수 요소
모든 멤버는 다음을 포함해야 합니다:
- 현재 역할 및 소속 기관
- 합류 시기 (월 및 연도)
- 교육 배경 (학위, 전공, 기관)
- 현재 연구/작업 초점
역할별 추가 요소:
PI:
- 박사 학위 기관 및 지도교수 (하이퍼링크 포함)
- 연구 철학 및 접근 방식
- 주목할 만한 논문 또는 미디어 보도
- 이전 직위
- 주요 수상 및 영예
PhD/Postdoc:
- 학부 및/또는 석사 기관
- 구체적인 연구 관심사
- 해당되는 경우 공동 지도교수
- 주목할 만한 경우 이전 연구 경험
Staff/Programmer:
- 이전 업무 경험 (산업계 또는 학계)
- 기술 전문성 및 초점 분야
- 작업 중인 프로젝트
- 해당되는 경우 공동 임용
학생 (MS/Undergrad):
- 전공 및 학년
- 연구 관심사
- 해당되는 경우 이전 인턴십 또는 연구
- 주목할 만한 경우 상/펠로우십
Alumni:
- 역할에 따른 위의 모든 사항
- 멘토 (특히 단기 인턴의 경우)
- 연구실 재임 기간 동안의 성과
- 여름 인턴의 경우 간결하게 유지 (50~80단어)
피해야 할 사항
- 1인칭 서술 (PI 소개는 가능할 수 있음)
- 프로젝트에 대한 과도한 세부 사항 (1~2문장으로 유지)
- 미래 시제 또는 추측
- 캐주얼한 언어 또는 속어
- 연구와 관련 없는 개인 정보
- 프론트매터와의 중복 (이름, 역할은 이미 표시됨)
이미지 처리 세부 사항
권장 사양
- 형식: JPG (권장) 또는 PNG
- 크기: 웹 최적화를 위해 100~250KB
- 종횡비: 정사각형 또는 거의 정사각형 (1:1 또는 4:5)
- 최소 해상도: 300x300픽셀
- 권장: 400x400 ~ 600x600픽셀
- 색상: RGB 색상 공간
최적화 프로세스
이미지 최적화가 필요한 경우:
# 번들 스크립트 사용
bash .claude/skills/add-member/scripts/optimize-image.sh input.jpg output.jpg 500
또는 sips(macOS)를 수동으로 사용:
# 최대 500px로 크기 조정, 종횡비 유지
sips -Z 500 input.jpg --out output.jpg
# PNG를 JPG로 변환
sips -s format jpeg input.png --out output.jpg
또는 ImageMagick 사용:
# 크기 조정 및 최적화
convert input.jpg -resize 500x500^ -quality 85 output.jpg
파일명 규칙
- 케밥 케이스 사용:
firstname-lastname.jpg - 공백, 특수 문자 또는 대문자 없음
- 멤버 파일 슬러그와 일치
- 예:
jane-doe.jpg,john-smith.jpg
역할별 참고 사항
Alumni 추가
이미 떠난 사람을 추가하는 경우:
- 프론트매터에서
role: alumni설정 - 약력 텍스트에 실제 역할 포함
team/index.mdalumni 섹션 업데이트:- 떠난 연도
- 괄호 안의 역할 설명
- 알고 있는 경우 "다음:" 주석
공동 지도교수 처리
멤버에게 공동 지도교수가 있는 경우:
- 약력에 언급: "[이름]의 공동 지도 아래"
- 가능한 경우 하이퍼링크 포함:
[이름](url) - 사용자에게 제시할 때 요약에 표시
공동 겸임
멤버에게 공동 소속이 있는 경우:
- 약력에 언급: "[연구실 이름]과 공동으로"
- 가능한 경우 다른 연구실에 하이퍼링크 포함
- 협력 PI를 명확히 표시
역할 전환 학생
학생이 학부 → 석사 → 박사로 이동하는 경우:
- 새 멤버 파일 생성? 아니오 - 동일한 파일 유지
- 프론트매터의
role:필드 업데이트 - 새 상태를 반영하도록 약력 업데이트
description:필드 업데이트- 약력에 전환에 대한 메모 추가 고려
여름 인턴
단기 멤버 (2~3개월):
- 활동 중인 동안:
undergrad또는highschool역할로 추가 - 떠날 때:
role: alumni로 변경 - 약력: 간결하게(50~80단어) 유지하지만 다음을 강조:
- 기관 및 프로그램
- 작업한 내용
- 멘토링한 사람
- 주목할 만한 성과
오류 처리
웹 검색에서 아무것도 찾지 못한 경우:
- 사용자에게 직접 정보를 제공하도록 요청
- 최소한의 약력을 작성하고 사용자가 확장할 수 있도록 제안
이미지 형식/크기가 잘못된 경우:
- 제공된 도구를 사용하여 최적화 제안
- 도구를 사용할 수 없는 경우 수동 지침 제공
- 최악의 경우: 플레이스홀더를 사용하고 요약에 표시
역할이 확실하지 않은 경우:
- roles.yaml에서 역할 옵션 제시
- AskUserQuestion을 사용하여 명확히 함
중복 멤버가 있는 경우:
- 업데이트인지 새 멤버인지 확인
- 사용자에게 기존 항목을 업데이트할지 새로 만들지 질문
유효성 검사 체크리스트
마무리하기 전에 다음을 확인:
- 전체 이름이 파일명, 프론트매터, 약력 전반에 걸쳐 일치합니까?
- 역할이 유효합니까? (pi, postdoc, staff, phd, ms, ra, programmer, undergrad, highschool, alumni 중 하나)
- 이미지 파일명이 규칙을 따릅니까? (케밥 케이스, .jpg)
- 약력 전체가 3인칭입니까?
- 약력 길이가 역할에 적합합니까? (지침 참조)
- 약력에 합류 날짜가 언급되었습니까? (월 및 연도)
- 교육 배경이 포함되었습니까?
- 모든 링크가 올바르게 포맷되었습니까?
- YAML 프론트매터가 유효합니까? (파서로 테스트)
- Alumni인 경우: team/index.md가 올바르게 업데이트되었습니까?
- 후행 공백 또는 포맷 문제가 없습니까?
참고 항목
- reference.md - 멤버 파일 형식 및 패턴에 대한 상세 문서
- examples.md - 다양한 시나리오에 대한 예제 워크플로우
- templates/ - 각 역할 유형에 대한 약력 템플릿