Claude Reflect - 자기학습 메모리
세션 중 사용자의 교정을 자동으로 모아 /reflect 명령으로 CLAUDE.md에 반영하는 자기학습 스킬.
유틸리티중급★ 1,291⑂ 110AI 점수 8/10마지막 업데이트: 2026. 3. 16.
무엇을 해주나
Claude Code가 같은 실수를 반복하지 않도록 돕는 2단계 학습 시스템입니다.
- 1단계 수집(자동): 훅이 "아니, X를 써", "사실은…", "Y 말고 X" 같은 교정 패턴과 도구 실행 거부를 감지해
~/.claude/learnings-queue.json에 쌓아둡니다. - 2단계 반영(수동):
/reflect를 실행하면 쌓인 학습 항목을 사람이 확인한 뒤 적절한 위치(전역~/.claude/CLAUDE.md, 프로젝트./CLAUDE.md, 개인용CLAUDE.local.md,.claude/rules/*.md등)에 기록합니다. /reflect --scan-history로 놓친 학습을 과거 세션에서 찾고,--dry-run으로 미리보기,/view-queue로 대기 목록 확인,/skip-reflect로 폐기할 수 있습니다./reflect-skills는 반복되는 패턴에서 새 스킬 후보를 추천합니다.
이런 분께 추천
- 매 세션마다 같은 규칙(모델명, 패키지 매니저, 코드 스타일)을 반복해서 알려주는 데 지친 분
- 팀 컨벤션을 CLAUDE.md에 체계적으로 축적하고 싶은 분
- 프로젝트별/전역 메모리를 구분해 관리하려는 중급 이상 사용자
활용 예시
- "아니, 추론 작업에는 gpt-5가 아니라 gpt-5.1을 써" → 훅이 큐에 저장 →
/reflect실행 시 전역 CLAUDE.md에 규칙 추가 여부를 물어봄. - 기능 개발을 마친 뒤
/view-queue로 이번 세션에 쌓인 교정 3건을 확인하고, 프로젝트 전용 규칙만./CLAUDE.md에 반영. - 여러 세션에서 "테스트는 pytest -q로 실행"이라는 교정이 반복되면
/reflect-skills가 이를 별도 스킬/규칙 파일로 분리하도록 제안.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 BayramAnnakov/claude-reflect 의 SKILL.m 폴더를 내 ~/.claude/skills/claude-reflect/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/BayramAnnakov/claude-reflect.git && mkdir -p ~/.claude/skills/claude-reflect && cp -r claude-reflect/* ~/.claude/skills/claude-reflect/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 내려받습니다:
git clone https://github.com/BayramAnnakov/claude-reflect.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills/claude-reflect - 파일을 복사합니다:
cp -r claude-reflect/* ~/.claude/skills/claude-reflect/ - 저장소 README를 열어 훅(hooks) 설정 방법을 확인하고, 안내대로
~/.claude/settings.json에 훅을 등록합니다. (자동 수집은 훅이 있어야 동작합니다) - 안전을 위해 기존
~/.claude/CLAUDE.md와 프로젝트./CLAUDE.md를 미리 백업해 둡니다. - Claude Code를 다시 시작한 뒤
/view-queue와/reflect --dry-run을 실행해 정상 동작을 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT