--- name: skill-evolve description: 스킬 실행 후 피드백을 받아 해당 SKILL.md를 자동 개선하는 메타 스킬. 스킬이 틀렸거나 누락이 있을 때, 또는 새로 배운 함정을 기록할 때 사용. argument-hint: "[개선할 스킬 이름] [피드백/개선 내용]" allowed-tools: Edit, Read, Write, Bash ---

# 스킬 자기개선

> 원형: [leeyudok/doksam-skills](https://github.com/leeyudok/doksam-skills) 의 동명 스킬. > 템플릿 동봉용으로 **의도적 분기** — 자동 동기하지 않으며, 좋은 개선은 수동 체리픽.

실행 중 발견한 문제, 사용자 피드백을 해당 스킬의 SKILL.md에 반영한다.

## 트리거

`/skill-evolve <스킬명> <피드백>`

## 프로세스

1. **대상 읽기**: `.claude/skills/<스킬명>/SKILL.md` 전체 읽기. 2. **분석**: 피드백 + 최근 실행 맥락 분석 → 변경 부분 결정. - 새로운 gotcha → `## Learned warnings` 섹션에 날짜와 함께 추가 - 단계 수정 → 프로세스 섹션 업데이트 - 잘못된 명령 → 수정 3. **제안**: 기존 내용 인용 + 변경 diff(추가/삭제 라인별) 제시. 4. **확인 요청**: "적용하시겠습니까? (Y/n)" 5. **적용**: 확인 후 SKILL.md 직접 수정. 6. **커밋**: 브랜치 재확인 후: ```bash git add .claude/skills/<스킬명>/SKILL.md git commit -m "evolve skill/<스킬명>: <요약>" ``` 7. **검증(미니 eval)**: 개선 계기가 된 것과 같은 유형의 입력으로 수정된 스킬을 실행해, 개선 전 실패했던 지점이 실제로 고쳐졌는지 전후 비교로 확인.

## 규칙

- 기존 Learned warnings는 삭제하지 않고 누적 - 날짜 태그 필수: `(YYYY-MM-DD)` - 중복 경고는 병합 - 커밋 직전 브랜치 재확인 (main 위 커밋 방지)

## 출력 형식

``` 개선 제안 기존: [인용] 제안: [수정안]

diff: + 추가 라인 - 삭제 라인

적용하시겠습니까? (Y/n) ```

## Learned warnings

(실행 중 발견한 주의사항이 여기에 누적됩니다)