update-docslisted
Install: claude install-skill HyperAITeam/CLITrigger
# 문서 업데이트
## 목적
특정 날짜(기본: 오늘)의 git 커밋을 분석하여 다음 문서를 일관되게 업데이트합니다:
- `docs/changelog/YYYY-MM/YYYY-MM-DD.md` — 해당 날짜 변경 이력 파일 신규 생성 (또는 같은 날 추가 항목이면 `-2`/`-3` suffix)
- `docs/changelog/README.md` — 인덱스에 한 줄 추가
- `docs/SETUP.md` — 사용법/API 테이블 반영
**CLAUDE.md는 이 스킬의 기본 업데이트 대상이 아닙니다.** 일상적인 기능 추가/수정은 changelog와 SETUP.md만 갱신하고, CLAUDE.md는 손대지 않습니다. CLAUDE.md는 기존 설명에 **사실과 다른 부분(실수)이 있다고 명확히 확인된 경우에만** 그 부분만 정확히 고치도록 합니다 — 자세한 조건은 "Step 6: CLAUDE.md 처리" 참조.
## 워크플로우
### Step 1: 대상 커밋 수집
인수를 파싱하여 대상 커밋 범위를 결정합니다:
- **인수 없음**: 오늘 날짜 (`git log --since="YYYY-MM-DDT00:00:00" --until="YYYY-MM-DDT23:59:59"`)
- **날짜 지정** (예: `2026-04-03`): 해당 날짜 커밋
- **커밋 범위** (예: `abc123..def456`): 해당 범위 커밋
대상 커밋이 0개이면:
```markdown
## 문서 업데이트
해당 기간에 커밋이 없습니다.
```
종료합니다.
### Step 2: 변경 분석
각 커밋에 대해 다음을 수집합니다:
1. `git log <hash> -1 --format="%B"` — 커밋 메시지 전문
2. `git diff <hash>^..<hash> --stat` — 변경 파일 목록
3. `git diff <hash>^..<hash>` — 주요 파일의 실제 diff (서버 서비스, DB 스키마, 라우트, 클라이언트 컴포넌트 중심)
수집한 정보를 바탕으로 다음을 파악합니다:
- **기능 추가**: 새 파일, 새 API 엔드포인트, 새 UI 컴포넌트
- **아키텍처 변경**: 서비스 역할 변경, 새 패턴 도입, DB 스키마 변경
- **사용법 변경**: 새 설정 옵션, 새 사용자 기능, UI 흐름 변경
### Step 3: 현재 문서 읽기
다음 파일을 읽습니다:
1. `docs/changelog/README.md` — 인덱스 형식과 가장 최근 entry의 월/파일명 패턴 파악
2. 직전 entry 파일 1-2개 (예: `docs/changelog/YYYY-MM/YYYY-MM-DD.md`) — 본문 스타일과 톤 파악
3. `docs/SETUP.md` — 섹션 번호, API 테이블 위치 파악
**CLAUDE.md는 읽지 않습니다.** (기본 대상이 아니므로 Step 6에서 실수 정정 조건이 만족될 때만 부분적으로 읽습니다.)
### Step 4: 날짜별 changelog 파일 생성 + 인덱스 갱신
#### 4a. 파일 경로 결정