Menú
현재 세션의 시행착오를 시도, 실패, 원인, 해결, 재방문 신호의 5요소로 캡처합니다. 보편 교훈은 메모리에, 프로젝트 특수는 문서에 저장합니다. 동일 함정 재방문 차단을 위해 시행착오 인지 후 어느 시점에든 호출하세요(시점 무관).
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | pitfall |
| description | 현재 세션의 시행착오를 시도, 실패, 원인, 해결, 재방문 신호의 5요소로 캡처합니다. 보편 교훈은 메모리에, 프로젝트 특수는 문서에 저장합니다. 동일 함정 재방문 차단을 위해 시행착오 인지 후 어느 시점에든 호출하세요(시점 무관). |
| when_to_use | 이거 삽질했다, 함정에 빠졌다, 같은 실수 반복 방지, 시행착오 기록. 검증 없는 단순 메모는 memo. |
| argument-hint | [--target doc|mem|both] [--note <message>] |
| allowed-tools | Read, Edit, Write, Glob, Grep, AskUserQuestion, Bash(ls*), Bash(stat*), Bash(wc*) |
| effort | high |
현재 세션의 시행착오를 5요소로 캡처해 메모리 또는 문서에 저장. 동일 함정 재방문 차단.
톤: 추출은 분석적, 사용자 안내문은 존댓말, 산출 본문은 평서체.
/session-glean)(출처: 세션 N절) 표기| 데이터 | 경로 | 필수/선택 | 부재 시 동작 |
|---|---|---|---|
| 현재 세션 | (대화 내) | 필수 | 시행착오 0건 시 종료 |
| auto memory 디렉터리 | 시스템 자동 명시 경로 | 선택 | 문서 모드로 fallback |
| 메모리 인덱스 | MEMORY.md | 선택 | 신규 생성 |
| 프로젝트 문서 sink | .local.claude/learn/, .local.claude/modules/{name}.md, docs/pitfalls.md | 선택 | 신규 위치 추천 |
| 기존 시행착오 기록 | .local.claude/learn/*pitfall*.md, docs/pitfalls.md, MEMORY.md 의 feedback 항목 | 선택 | Grep 검사만 수행 |
호출 전 자동 read: CLAUDE.md, MEMORY.md (있으면), 기존 시행착오 기록 (중복 방지).
| 입력 | 동작 |
|---|---|
| (빈) | 현재 세션 중 가장 최근 시행착오 자동 추출 + 매체 자동 판단 |
--target doc | 문서만 |
--target mem | 메모리만 |
--target both | 양쪽 강제 |
--note "{텍스트}" | 사용자 명시 시행착오 (자동 추출 대체) |
현재 세션에서 시행착오 5요소 추출:
| 요소 | 정의 | 예시 |
|---|---|---|
| 시도(Tried) | 무엇을 시도했는가 | "X 라이브러리 Y API 사용" |
| 실패(Failed) | 어떤 실패가 발생했는가 | "Z 에러로 N분 지연" |
| 원인(Cause) | 진짜 원인 | "Y API는 W 조건에서 미동작" |
| 해결(Fix) | 어떻게 해결하거나 회피했는가 | "V 함수로 우회" |
| 재방문 신호(Trigger) | 다시 만났을 때 인식 키워드 | "Z 에러 + Y API" |
5요소 누락 시 AskUserQuestion으로 부족 요소 질문. 답변 못 받으면 추출 보류.
--note 입력 시: 사용자 텍스트를 5요소로 구조화. 부족 요소만 추출로 보충.
조기 종료: 현재 세션에 시행착오 식별 불가면 "추출할 시행착오가 없습니다" 안내 후 종료.
매체 자동 판단 휴리스틱:
| 시행착오 성격 | 매체 |
|---|---|
| 외부 도구, 라이브러리, 언어 기능 (보편) | 메모리 (feedback type) |
| 이 모듈, 이 코드베이스, 이 데이터 (프로젝트 특수) | 문서 |
| 양쪽 해당 | 둘 다 (각 매체에 맞는 표현) |
--target 인자 명시 시 자동 판단 생략하고 강제.
저장 위치 결정:
.local.claude/learn/ 존재 시 .local.claude/learn/{YYYY-MM-DD}-pitfall.md.local.claude/modules/{name}.md 의 "함정" 섹션 추가docs/pitfalls.md (부재 시 신규)동일 시행착오 사전 검사:
AskUserQuestion으로 매체와 위치 승인 후 Phase 3 진입.
처리 순서:
name, description, type) + 5요소 본문MEMORY.md 인덱스에 한 줄 추가: - [{title}]({file}.md): {재방문 신호}> /pitfall 으로 생성 (YYYY-MM-DD))> /pitfall 으로 생성 (YYYY-MM-DD)5요소 표 형식:
| 시도 | 실패 | 원인 | 해결 | 재방문 신호 | 출처 |
매체별 결정 규칙:
CONTRACT 5절 전수 준수.
| sink | 임계1 | 임계2 | 안내 |
|---|---|---|---|
| 메모리 개별 파일 | 50 | 100 | 분리 또는 요약 |
MEMORY.md (자동 로드) | 200 | 없음 | /memory-garden |
docs/pitfalls.md | 300 | 500 | 카테고리나 시기별 분리 |
.local.claude/learn/*pitfall*.md | 200 | 300 | 시기별 분리 |
.local.claude/modules/*.md | 300 | 500 | sub-doc 분리 |
| 질문 | 담당 | 이 스킬 |
|---|---|---|
| 세션 전체 다건 학습 흡수 | /session-glean | [다루지 않음] |
| 메모리 인덱스 정리와 아카이브 | /memory-garden | [다루지 않음] |
| 외부 디렉터리 흡수 | /absorb | [다루지 않음] |
| 단건 코드 검증 | /learn | [다루지 않음] |
| 만료 문서 정리 | /garden | [다루지 않음] |
| 현재 세션 중 단건 시행착오 캡처 | 이 스킬 | [핵심] |
/session-gleanMEMORY.md 200줄 근접 시 /memory-garden/learn/on-boarding/session-glean 안내)(출처: 세션 N절)공통 3블록은 CONTRACT 6-1절 참조.
[환경/규모] 시행착오 3건+ 발견
/session-glean 안내 + 가장 최근 1건만 처리[데이터 결함] 5요소 부분 누락
[데이터 결함] 동일 시행착오 이미 기록
이미 기록됨: {파일}:{줄}), 신규 저장 안 함[의존성 부재] auto memory 디렉터리 미존재
--target doc 자동 전환지정 디렉터리의 문서를 심층 분석하여 지식을 추출하고, 기존 문서 갱신 + 신규 문서 생성으로 프로젝트 지식 베이스에 반영합니다.
기술 의사결정 기록 (Architecture Decision Record). 중요한 기술적 결정의 맥락, 대안, 근거를 구조화하여 기록합니다.
현재 디렉터리의 내용을 분석하여 어떤 목적의 폴더인지 파악
슬랙/메일/메신저로 받은 업무 요청 메시지를 분석하여 의도, 핵심 내용, 판단, 액션 플랜, 대응 가이드를 정리합니다.
비즈니스 규칙, 도메인 규칙, 상태 전이 규칙을 하나의 문서로 관리합니다. 변경 이력이 누적됩니다.
열린 질문, 문제 해결, 기술 의사결정, 아이디어 발산을 구조화합니다. 회의록이나 메모 파일 경로를 인자로 전달하거나 직접 질문하세요.