retrospectivelisted
Install: claude install-skill gagip/gagip-dev
# 회고 스킬
현재 대화 세션을 돌아보며 유의미한 정보를 추출하고, **스킬 문서·상시 로드 지침·서브에이전트 정의**에 반영한다.
다음 대화에서 LLM이 같은 실수를 반복하지 않거나, 더 나은 판단을 내릴 수 있도록 맥락을 축적하는 것이 핵심 목적이다.
돌아보는 대상은 두 갈래다 — **사용자와 주고받은 것**(내가 뭘 틀렸고 뭘 고쳐 받았나)과
**서브에이전트에 위임한 것**(무엇을 시켜 무엇을 받았고 그게 쓰였나). 뒤쪽을 빼면 위임으로 돌아간
작업이 통째로 회고에서 사라진다.
> **범위**: 이 스킬은 명시적으로 로드되는 규칙(스킬 `SKILL.md`, 전역·프로젝트·디렉토리 지침 파일),
> 서브에이전트 정의, 신규 스킬 추천만 다룬다. 자동 메모리, 날짜별 회고 로그(`retrospective/YYYY-MM-DD.md`)
> 같은 별도 기록물은 이 스킬의 대상이 아니다.
---
## 실행 절차
### Step 1: 대화 세션 분석
현재 대화 전체를 읽으며 아래 항목을 추출한다.
여러 세션을 대상으로 하는 회고라면, 먼저 아래 "옵션: 범위 확장 → 다중 세션·주간 회고 워크플로우"로
세션을 분산 분석한 뒤 그 결과를 종합해 같은 항목을 추출한다.
**추출 항목**:
- **수정/재작업 발생 지점**: 내가 처음 제안한 것을 사용자가 수정 요청한 경우 → 왜 틀렸는지
- **사용자 명시적 피드백**: "그건 아니야", "그게 아니라", "다시 해봐", "원본 유지해" 등의 표현
- **사용자 암묵적 피드백**: 수정 없이 바로 수락한 접근법 → 무엇이 잘 작동했는지
- **새로 확립한 규칙**: 이번 세션에서 사용자가 알려준, 앞으로도 계속 적용될 작업 방식·판단 기준
- **스킬 개선 포인트**: 스킬이 놓친 케이스, 잘못된 절차, 빠진 단계
- **반복 작업 패턴**: 이번 세션(또는 여러 세션)에서 여러 번 반복한 다단계 절차 → 신규 스킬 후보
- **에이전트 작업**: 서브에이전트에 무엇을 시켜 무엇을 받았고 그 결과가 어떻게 쓰였나
→ 아래 "에이전트 작업 진단" 절에서 원재료를 뽑는다
- **수행 지표**: 이번 세션에서 **셀 수 있는 것** — 재작업 횟수, 사용자 교정 건수, 스킬을 열어 놓고 어긴 조항, 확인 없이 단정했다가 뒤집힌 주장 (세는 규칙은 Step 3)
### Step 1-b: 에이전트 작업 진단
이번 범위에서 서브에이전트를 띄웠다면, 그 위임이 값을 했는지 본다. **에이전트를 안 띄웠으면 이 단계를 건너뛴다.**
**원재료 뽑기** — 현재 `SKILL.md`가 들어 있는 디렉터리의 `scripts/agent_trace.py`를 실행한다.
셸에 넘기기 전 절대 경로로 바꾼다. 인자 없이 실행하면 현재 작업 디렉터리의 최신 세션 하나를 본다.
기간 회고면 `--days N`, 특정 세션이면 `--session <경로>`, 보고서 전문이 필요하면 `--full`을 붙인다.
스크립트는 에이전트별로 **위임 프롬프트 · 보고서 · 직후 사용자 발화 · 소요·토큰·도구 호출