← ClaudeAtlas

diffscopelisted

코드 변경을 학습용 브리핑으로 바꾼다. 변경 지도 시각화 + 동작 차이 추적 + Python 문법 해설을 한 번에 터미널에 출력한다. Stop hook이 "[diffscope] 이번 턴에 소스 파일 N개가 변경되었다"라는 지시와 함께 patch 경로를 넘기면 반드시 이 스킬을 사용할 것. 사용자가 "방금 뭐 바뀐 거야", "이번 변경 설명해줘", "변경사항 설명", "이 코드 이해 안 돼", "브리핑", "다시 설명해줘", "더 자세히", "쉽게 다시", "문법만 다시", "로직만 다시", "아까 그 변경 다시 보여줘", "자동 분석 꺼줘/켜줘"라고 할 때도 이 스킬을 사용할 것. 다음에는 사용하지 않는다 — 코드를 고쳐달라는 요청, 코드 리뷰나 버그 탐색 요청(이 스킬은 이해를 돕는 설명이지 리뷰가 아니다), `git diff`/`git log` 원문을 그대로 보여달라는 요청, 커밋 메시지나 PR 설명 작성 요청. 즉 "변경분을 재료로 무언가를 만들어 달라"가 아니라 "변경분을 이해하게 도와달라"일 때만 쓴다.
SWHee/diffscope · ★ 1 · Code & Development · score 64
Install: claude install-skill SWHee/diffscope
# diffscope — 변경 학습 브리핑 오케스트레이터 코딩 에이전트가 코드를 바꾼 직후, 그 턴의 변경분만 골라 **읽고 이해할 수 있는 형태**로 터미널에 출력한다. 목표는 리뷰가 아니라 학습이다. 사용자가 파일마다 diff를 열어보는 시간을 없애는 것이 존재 이유다. ## 실행 모드: 하이브리드 | Phase | 모드 | 이유 | |-------|------|------| | 1. 컨텍스트·패치 로드 | 오케스트레이터 직접 | 파일 읽기뿐. 에이전트 스폰은 순손실 | | 2. 분석 | 규모에 따라 인라인 / 서브 에이전트 팬아웃 | 아래 분기표 참조 | | 3. 브리핑 조합·출력 | 오케스트레이터 직접 | 통합은 한 명이 해야 톤이 일관됨 | 에이전트 팀(TeamCreate)을 쓰지 않는다. 이 워크플로우는 `지도 작성 → (문법 ∥ 로직)`의 순차 의존 + 병렬 독립 구조라 팀원 간 실시간 조율에서 얻을 것이 없고, 팀 구성 오버헤드는 "빠른 브리핑"이라는 목적에 정면으로 반한다. ## Phase 0: 컨텍스트 확인 무엇 때문에 호출됐는지부터 판별한다. 여기를 건너뛰면 재실행 요청에 초기 실행��� 반복하게 된다. | 신호 | 실행 모드 | |------|-----------| | hook 메시지에 `patch:` 경로가 있음 | **자동 브리핑** — Phase 1로 | | 사용자가 설명을 요청했고 직전에 브리핑을 출력한 적 있음 | **부분 재실행** — 아래 참조 | | 사용자가 설명을 요청했으나 브리핑 이력 없음 | **수동 브리핑** — Phase 1에서 패치를 직접 만든다 | | 사용자가 자동 분석 on/off를 요청 | **설정 변경** — 아래 참조 | **부분 재실행:** 대화에 남아 있는 이전 브리핑을 활용한다. 사용자가 지목한 부분만 다시 만든다 — "문법만 다시" → python-tutor만 재호출, "더 쉽게" → 해당 섹션만 깊이 조정. 전체를 다시 돌리지 않는다. **설정 변경:** 전용 명령이 있으므로 직접 파일을 건드리지 않는다. 사용자에게 `/diffscope:off`(이 저장소만 끄기) · `/diffscope:on`(켜기) · `/diffscope:status` (상태·진단)를 안내한다. 사용자가 대화로 요청했다면 `sh {플러그인 경로}/scripts/toggle.sh off` 처럼 같은 스크립트를 부르고, 출력만 전달한 뒤 끝낸다. 전체를 끄려면 `off --global`. **브리핑이 안 뜬다는 문의**에는 추측하지 말고 `toggle.sh status`를 실행한다. 최근 기록에 왜 건너뛰었는지(`filtered`/`nochange`/`off`/`skipped`/`error`)가 남아 있다. 기록이 아예 없으면 hook이 한 번도 실행되지 않은 것이므로 `/reload-plugins` 여부를 확인시킨다. ## Phase 1: 패치 로드와 규모 판정 **hook 호출인 경우** — 메시지의 `patch`, `stat`, `repo` 경로를 그대로 쓴다. 다시 계산하지