클로드스킬마트스킬 둘러보기스킬이 뭐예요?
목록으로

Claude Reflect - 자기학습 메모리

세션 중 사용자의 교정을 자동으로 모아 /reflect 명령으로 CLAUDE.md에 반영하는 자기학습 스킬.

유틸리티중급1,291110AI 점수 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에 체계적으로 축적하고 싶은 분
  • 프로젝트별/전역 메모리를 구분해 관리하려는 중급 이상 사용자

활용 예시

  1. "아니, 추론 작업에는 gpt-5가 아니라 gpt-5.1을 써" → 훅이 큐에 저장 → /reflect 실행 시 전역 CLAUDE.md에 규칙 추가 여부를 물어봄.
  2. 기능 개발을 마친 뒤 /view-queue로 이번 세션에 쌓인 교정 3건을 확인하고, 프로젝트 전용 규칙만 ./CLAUDE.md에 반영.
  3. 여러 세션에서 "테스트는 pytest -q로 실행"이라는 교정이 반복되면 /reflect-skills가 이를 별도 스킬/규칙 파일로 분리하도록 제안.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
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자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 저장소를 내려받습니다: git clone https://github.com/BayramAnnakov/claude-reflect.git
  2. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills/claude-reflect
  3. 파일을 복사합니다: cp -r claude-reflect/* ~/.claude/skills/claude-reflect/
  4. 저장소 README를 열어 훅(hooks) 설정 방법을 확인하고, 안내대로 ~/.claude/settings.json에 훅을 등록합니다. (자동 수집은 훅이 있어야 동작합니다)
  5. 안전을 위해 기존 ~/.claude/CLAUDE.md와 프로젝트 ./CLAUDE.md를 미리 백업해 둡니다.
  6. Claude Code를 다시 시작한 뒤 /view-queue/reflect --dry-run을 실행해 정상 동작을 확인합니다.