diffscopelisted
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` 경로를 그대로 쓴다. 다시 계산하지