Learn

---
name: learn
description: Review and approve the learning candidates the hooks collected, turning them into rules that are auto-injected next session. 트리거: "학습 후보", "이거 기억해", "다음부터 이렇게", 교정받은 직후.
---

# learn — 세션에서 배우기

**기록은 훅이 자동으로 한다.** 이 스킬은 검토와 승인만 담당한다.

```
PostToolUse ─┐
             ├─▶ .nereus/learn/observations.jsonl ─(SessionEnd 집계)─▶ candidates.json ─(사용자 승인)─▶ learnings.jsonl ─(SessionStart)─▶ 주입
UserPrompt ──┘      (판정 없음, 원본만)              (정규식 신호 3종)          (여기서만 사람이 개입)
```

## 자동으로 잡히는 신호 (LLM 호출 없음)
- **실패→통과**: 같은 명령이 실패했다가 성공하면, 그 사이에 고친 파일이 근거로 붙는다.
- **반복 명령**: 한 세션에서 3회 이상 같은 명령을 돌리면 후보가 된다(스크립트로 만들 거리).
- **교정**: 사용자가 "아니", "말고", "actually" 같은 말을 하면 그 직후 편집한 파일과 함께 남는다.

관찰에는 도구 이름, 명령 머리 120자, 파일 경로, 교정 발췌 200자만 들어간다. 시크릿과 이메일은 정규식으로 지운다. `.nereus`, `.claude-mem`, `node_modules`, 빌드 산출물은 관찰하지 않는다. 읽기 도구(Read/Grep/Glob)도 제외한다.

## 명령
```bash
S="${CLAUDE_PLUGIN_ROOT}/skills/learn/scripts/learn.mjs"
node "$S" review                                            # 승인 대기 후보
node "$S" approve 0003 --trigger "<언제>" --rule "<무엇을>"   # 규칙으로 승격
node "$S" decline 0003                                      # 기각(다시 안 올라옴)
node "$S" add --trigger "<언제>" --rule "<무엇을>"            # 후보 없이 직접 추가
node "$S" list                                              # 저장된 규칙
```

## 승인 전 일반화 테스트 (네 가지 모두 예여야 승인)
1. 다른 프로젝트나 다른 태스크에서도 말이 되는가?
2. 이번 작업의 수정 사항이 아니라, **빠져 있던 규칙**을 가리키는가?
3. 재발할 근거가 있는가? (같은 지적을 두 번 이상 받았거나, 구조적으로 또 생길 일인가)
4. 코드·문서를 보면 알 수 있는 사실이 아닌가? (구조나 함수 이름은 규칙이 아니다)

하나라도 아니면 `decline` 한다. 규칙이 많아질수록 주입 예산을 잡아먹고 정작 중요한 규칙이 밀린다.

## 형식
`trigger`는 적용 상황, `rule`은 그때 무엇을 할지. 둘 다 한 줄로 구체적으로.
- 좋음: trigger `Nereus 테스트를 쓸 때` / rule `사용자 전역 설정을 읽지 않게 NEREUS_HOME 을 임시 디렉터리로 격리한다`
- 나쁨: trigger `항상` / rule `실수하지 말자`

## 신뢰도와 주입
새 규칙은 0.5로 시작하고 같은 규칙이 다시 확인될 때마다 0.2씩 올라 최대 1.0이 된다. **0.7 이상만 주입**되므로 한 번 더 확인된 규칙부터 자동으로 들어간다. 예산은 설정 `learnings`(minConfidence 0.7, limit 8, maxChars 900)로 조절한다.

틀린 규칙을 발견하면 `learnings.jsonl`에서 그 줄을 지우고 사용자에게 알린다. 조용히 무시하지 않는다.

## claude-mem 과의 경계
claude-mem은 **무슨 일이 있었나**(세션 요약, 회상)를 담당한다. 이 스킬은 **앞으로 어떻게 행동할까**(행동 규칙)만 담당한다. 요약이나 회상을 여기서 만들지 않는다.