Git 히스토리에서 브래그 문서 만들기
목표: 실제로 출시한 것을 바탕으로 편집 가능한 초안을 작성하되, 영향력을 지어내지 않습니다. 브래그 문서는 작업과 결과를 나열합니다. 이 스킬은 작업을 수집하고, 결과가 없는 모든 부분을 사용자가 채울 수 있도록 간극으로 표시합니다.
1단계: 증거 수집
시간 범위(기본값: 최근 6개월)와 리포지토리를 물어보세요. 그런 다음 GitHub CLI에 로그인한 상태에서:
gh search prs --author @me --merged --merged-at ">=YYYY-MM-DD" --json title,url,closedAt,repository --limit 200
GitHub가 아닌 코드의 경우 각 리포지토리에서 다음 명령을 사용하세요:
git log --author="<이름 또는 이메일>" --since="YYYY-MM-DD" --no-merges --pretty="%h %ad %s" --date=short
또한 사용자에게 git으로 보여줄 수 없는 내용(처리한 인시던트, 멘토링, 수행한 리뷰, 발표, 문서, 온콜, 설계 결정, 동료의 좋은 말 등)을 입력해 달라고 요청하세요.
사용자가 지정하지 않은 비공개 리포지토리는 읽지 마세요. 이름, 팀 또는 숫자를 추측하지 마세요.
2단계: 아직 요약하지 말고 그룹화하세요
항목을 주제별(예: 안정성, 새로운 기능, 성능, 도구, 멘토링, 교차 팀 작업)로 그룹화하세요. 각 항목을 해당 주제 아래에 날짜와 링크와 함께 나열하세요. 중복(기능 PR과 후속 수정 사항)은 병합하세요.
3단계: 각 주제에 대한 초안 작성
각 주제에 대해 다음을 작성하세요:
- 내가 한 일: 제목, 차이점 및 사용자 메모가 뒷받침하는 내용만 사용하여 평이한 동사로 한두 문장.
- 결과: 숫자, 인용문 또는 결과가 제공된 경우에만 작성합니다. 그렇지 않으면
[GAP: 사용자나 팀에 어떤 변화가 있었나요? 전후 지표가 있나요?]를 작성합니다. - 증거: 링크.
- 범위 신호(지원되는 경우): 주도함, 혼자 수행함, 팀 간 협업함, 온콜 중이었음, 다른 사람을 리뷰함.
4단계: 간극과 질문으로 마무리
모든 [GAP] 리스트를 사례를 얼마나 강화할 수 있는지 순위를 매겨 끝에 배치하고, 가장 많이 추가할 수 있는 답변이 있는 질문 세 가지를 포함하세요. 최종 버전을 자기 검토, 승진 패킷 개요 또는 이력서 항목으로 변환할 수 있도록 제안하세요.
규칙
- 절대 지표, 백분율, 고객 이름, 직함 또는 범위를 지어내지 마세요. 보이는 간극이 지어낸 숫자보다 낫습니다.
- 부풀리지 마세요: "기여했다"는 "기여했다" 그대로 유지합니다. 동사를 증거에 맞춥니다.
- 사용자의 신용을 정직하게 유지하세요: PR이 팀 작업이었다면 어떤 부분이 그들의 것인지 말하세요.
- 사용자가 문서가 내부용이라고 말하지 않는 한 비공개 또는 기밀 세부 정보를 포함하지 마세요.
- 사용자가 메모에 붙여넣을 수 있는 Markdown을 출력하세요.