iceberggymnast
UserClaude Code 스킬 3종 — 팀원이 읽는 PR·이슈·커밋 글쓰기, 팀원 PR 리뷰 절차, AI가 짠 코드에 대한 이해 부채 점검
Categories
Indexed Skills (6)
git-writing
팀원이 읽는 git 텍스트 — PR 제목·본문, 이슈, 커밋 메시지 — 를 사람이 읽기 좋게 쓴다. 사용자가 "PR 올려줘", "PR 써줘", "PR 본문 작성해줘", "PR 문구 다듬어줘", "이슈 올려줘", "이슈로 남겨줘", "이슈 정리해줘", "커밋 메시지 다듬어줘"라고 하거나, 작업을 마치고 `gh pr create`·`gh issue create`를 실행하기 직전이면 — 사용자가 문구 얘기를 꺼내지 않았어도 — 반드시 발동한다. 이미 올라간 내 PR·이슈의 본문을 수정할 때도 발동한다. 팀원이 올린 PR을 리뷰할 때는 이 스킬이 아니라 pr-review-loop다. 또한 "이 스킬 의도대로 작동해?", "이 스킬 잘 되고 있어?"처럼 스킬 자체의 효과를 점검해 달라는 요청에도 발동하며, 그때는 같은 폴더의 `RATIONALE.md`를 읽고 이번 세션·기존 기록과 대조한다.
pr-review-loop
팀원이 올린 PR을 리뷰한다. **`PR` + `올라온/올라왔` + `리뷰`가 한 문장에 있으면 형태를 가리지 않고 발동한다** — 요청문뿐 아니라 평서형·전언형도 포함이다: "PR 올라온게 있는데 리뷰 좀 해줘", "PR 올라온거 리뷰하려고", "PR이 하나 올라왔더라고, 리뷰 좀 해줄수 있어?", "PR 새로 올라왔던데 리뷰 해 줄 수 있어?", "팀원 쪽 PR 올라온게 있는데 리뷰좀 해줘". 충돌 확인만 언급해도("충돌 없는지 봐줘") 같은 절차를 탄다. **호출되면 리뷰를 서술하기 전에 이 PR이 이해도 대조(3.5) 대상인지부터 판정한다** — 상태·저장·데이터 구조를 건드리는 PR이면 리뷰 결과를 대화에 쓰지 않고 파일에 먼저 쓴 뒤 질문 네 개를 던지고 멈춘다. 절차는 충돌 확인 → 팀 머지 기준·설계 문서 대조 → 코드 리뷰 → (이해도 대조) → "사용자가 에디터에서 직접 확인할 항목"을 O/X 체크리스트로 분리 생성 → 코멘트 → 머지 → 컴파일 검증. "내가 에디터에서 확인해야 할 항목"은 사용자가 요구하기 전에 낸다. 또한 "이 스킬 의도대로 작동해?", "이 스킬 잘 되고 있어?"처럼 스킬 자체의 효과를 점검해 달라는 요청에도 발동하며, 그때는 같은 폴더의 `RATIONALE.md`를 읽고 이번 세션·기존 기록과 대조한다.
senior-mentor
사수 시니어 개발자처럼 코드 리뷰·멘토링을 하고, AI가 작성한 코드에 대한 이해 확인까지 수행한다. 네 가지 상황에서 발동한다 — (1) 사용자가 명시적으로 요청할 때: "멘토 리뷰", "사수 리뷰", "시니어 리뷰 해줘", "이 코드 멘토링 받을래", "/mentor". (2) 커밋을 실행하려는 시점에 사용자가 직접 짠 코드가 포함되어 있을 때(모드 R — 커밋 전 리뷰 후 분리 커밋). **"커밋해줘"라는 발화를 기다리지 않는다** — 자동 커밋 규약이 있는 환경에서��� 그 말이 나오지 않으므로, 커밋을 실행하려는 시점 자체가 트리거다. (3) 코드 파일이 포함된 커밋·PR 직후 PostToolUse 훅이 이해 확인을 요청할 때(모드 C/L — Claude가 짠 코드를 사용자가 이해하고 있는지 예측-대조로 확인하고, 모르면 가르친다). (4) **대화 중 사용자의 개념 질문에 답하면서 재사용 가능한 개념에 정식 이름을 붙여 가르쳤을 때(모드 Q — 질문 적재).** "왜 X가 필요한가", "Y면 Z 아닌가" 같은 질문에 답이 새 개념을 가르쳤다면, 커밋·PR이 없어도 이 스킬을 불러 적재한다 — 자발적 질문은 학습 동기가 가장 높은 순간인데 적재 경로가 없으면 증발한다. 기록은 mentor-log.md(리뷰)와 comprehension-debt.md(이해 부채)에 나눠 누적한다. 또한 "이 스킬 의도대로 작동해?", "이 스킬 잘 되고 있어?"처럼 스킬 자체의 효과를 점검해 달라는 요청에도 발동하며, 그때는 같은 폴더의 `RATIONALE.md`를 읽고 이번 세션·기존 기록과 대조한다.
session-audit
로컬 Claude Code 세션 로그(~/.claude/projects)를 전수 파싱해 사용자 프롬프트 원본을 복원하고, 틀을 가진 분석(A안)과 틀 없는 백지 분석(B안)을 독립 수행한 뒤, 검증을 거쳐 실행 계획(C안)으로 합쳐 노트로 남긴다. 사용자가 "세션 전수 분석", "내 프롬프트 로그 분석해줘", "백지 분석 돌려줘", "내 작업 방식 분석해줘", "지난 한 달 내가 뭘 했는지 분석", "세션 회고", "자동화 후보 뽑아줘"라고 하거나, 반복 작업을 스킬·에이전트로 만들 근거를 로그에서 찾으려 할 때 사용한다. 개별 세션 요약이 아니라 여러 달치 로그를 한꺼번에 보는 작업에만 해당한다. 출력은 두 모드다 — 노트 파일로 남기는 전수 분석(기본)과, 지적만 대화에 내는 쓴맛 보고("내 로그 좀 까줘", "냉정하게 봐줘", "쓴소리 좀 해줘"). 또한 "이 스킬 의도대로 작동해?", "이 스킬 잘 되고 있어?"처럼 스킬 자체의 효과를 점검해 달라는 요청에도 발동하며, 그때는 같은 폴더의 `RATIONALE.md`를 읽고 이번 세션·기존 기록과 대조한다.
cs-drill
실작업이 만나지 않는 CS 개념을 커리큘럼 순서로 배우고 간격을 두고 다시 확인한다. 사용자가 "CS 공부하자", "CS 문제 내줘", "오늘 뭐 볼까", "복습할 거 있어?", "면접 대비 좀", "알고리즘 개념 하나 보자"라고 하거나, 세션 시작 훅이 "CS 미복습 N건"을 알렸을 때 발동한다. 또한 실작업 대화에서 커리큘럼 영역(자료구조·알고리즘·메모리·동시성·언어 런타임·OS·네트워크·DB)과 닿는 개념이 스쳤을 때 답변을 마친 뒤 인접 항목 하나를 제안하는 경로로도 발동한다. Claude가 짠 코드의 이해 확인이나 사용자가 짠 코드의 리뷰는 이 스킬이 아니라 senior-mentor다. 또한 "이 스킬 의도대로 작동해?", "이 스킬 잘 되고 있어?"처럼 스킬 자체의 효과를 점검해 달라는 요청에도 발동하며, 그때는 같은 폴더의 `RATIONALE.md`를 읽고 원장·이번 세션과 대조한다.
skill-checkup
설치한 스킬이 실제로 돌고 있는지 재고, 안 돌면 트리거를 고친다. 사용자가 "스킬 점검", "스킬들 잘 돌고 있어?", "스킬 발동률 좀 봐줘", "설치한 스킬 상태 점검", "원장 정리 필요한지 봐줘", "프로필 업데이트 필요해?"라고 하거나, 스킬을 새로 만들거나 고친 뒤 한 달쯤 지나 효과를 확인하려 할 때 발동한다. 세션 로그에서 스킬별 발동 횟수를 세고, 기회 대비 발동률과 원장 기록률을 대조해 트리거 문제인지 절차 이탈인지 가른다. 원장·프로필의 상태도 함께 보고, 프로필 기재가 지금도 맞는지 새 문제를 내서 확인한다. 개별 스킬 하나가 자기 성공 기준을 충족했는지 보는 것("이 스킬 의도대로 작동해?")은 그 스킬 자신이 하고, 이 스킬은 함대 전체가 애초에 돌기는 했는지를 본다. 로그에서 새 자동화 후보를 발굴하는 것은 session-audit이다. 또한 "이 스킬 의도대로 작동해?"처럼 이 스킬 자체의 효과를 점검해 달라는 요청에도 발동하며, 그때는 같은 폴더의 `RATIONALE.md`를 읽고 지난 회차 관측과 대조한다.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.