Claude Code 업데이트를 일본어로 요약하여 Obsidian으로 전송하고 캐치업하기

Claude Code 세션 내에서 ** /catch-up-claude-code를 한 번 실행하는 것만으로**, 요약되지 않은 릴리스(Release)가 일본어로 요약되어 Obsidian Vault에 차곡차곡 쌓이게 됩니다.

Obsidian Vault
└── ClaudeCodeUpdates/
├── v2.1.138.md ← 🚨 보안 수정 / ✨ 신기능 ...
...

/catch-up-claude-code를 실행하고,

Obsidian에서 열면 다음과 같은 이미지로 추가되므로, 길을 잃지 않고 나중에 틈틈이 읽을 수 있습니다.

서두에서 주목할 포인트를 심층 분석 → 전체 변경 사항을 표로 일람 구성으로 하여, "표로 전체를 빠르게 파악 → 관심 있는 주목 포인트를 깊게 읽기"라는 자연스러운 독서 흐름이 가능하도록 했습니다.

Claude Code는 거의 매일 릴리스가 나옵니다.

이것을 전부 쫓아가는 것은 힘듭니다. 게다가 공식 릴리스 노트(Release Notes)는:

❌ 이런 식으로 전달됨 (영어 + 전문 용어)
─────────────────────────────────────
- Added /ultrareview command for cloud-based multi-agent code review
...

✅ 원하는 것은 이쪽 (일본어 + 사용자 관점)
─────────────────────────────────────
- /ultrareview 명령어를 추가 — PR 리뷰를 클라우드 상의 복수 AI
...

셸 스크립트(Shell Script)도 launchd도 사용하지 않습니다. Claude Code의 Skill 기능만으로 완결합니다. 이유는 나중에 설명하겠습니다. 하루에 Claude Code를 열 때, 그날 처음으로 /catch-up-claude-code를 한 번 실행하는 것, 딱 그것뿐입니다.

파일은 이것뿐입니다:

~/.claude/skills/
└── catch-up-claude-code/
└── SKILL.md ← 차분(Diff) 검출부터 일본어 요약까지 전부

Vault에 있는 파일 이름과 GitHub 측의 최신 태그(Tag)를 대조하여, 요약되지 않은 것만 추출합니다.

몇 번을 실행해도 이미 요약된 것은 건드리지 않습니다. 새로운 릴리스가 없다면 한 줄 보고만 합니다:

✅ 현 시점에서 요약되지 않은 릴리스는 없습니다 (최신: v2.1.143)

새로운 릴리스가 있다면 다음과 같습니다:

✅ 2건의 릴리스를 요약했습니다
- v2.1.144 → ~/Documents/Obsidian Vault/ClaudeCodeUpdates/v2.1.144.md
- v2.1.145 → ~/Documents/Obsidian Vault/ClaudeCodeUpdates/v2.1.145.md

각 버전의 요약 파일은 이 구조로 생성됩니다.

/catch-up-claude-code

name: catch-up-claude-code
description: Claude Code의 요약되지 않은 릴리스를 GitHub에서 감지하여, 일본어로 일괄 요약한 뒤 Obsidian Vault에 저장한다. 각 버전의 요약은 "주목할 점을 서두에서 심층 분석 → 카테고리별 표로 모든 변경 사항을 나열"하는 구성이다. "최신 내용까지 따라잡아줘", "Claude Code 업데이트를 확인해줘"라는 요청을 받았을 때 사용한다.
...

ls "$HOME/Documents/Obsidian Vault/ClaudeCodeUpdates/" 2>/dev/null | grep -E '^v[0-9]' | sed 's/\.md$//'

디렉토리가 존재하지 않는 경우 생성:

mkdir -p "$HOME/Documents/Obsidian Vault/ClaudeCodeUpdates"

2. GitHub Releases에서 최신 태그 목록 가져오기

최근 20개의 릴리스 태그를 가져온다:

gh api 'repos/anthropics/claude-code/releases?per_page=20' --jq '.[].tag_name'

3. 차이(Diff) 계산

단계 2의 태그 중, 단계 1의 파일명에 존재하지 않는 것을 "요약되지 않은 버전"으로 간주한다.
요약되지 않은 버전이 0개라면, 다음과 같이 한 줄로 보고하고 종료한다:

✅ 현재 시점에서 요약되지 않은 릴리스가 없습니다 (최신: vX.Y.Z)

4. 요약되지 않은 버전의 요약 및 저장

요약되지 않은 버전을 오래된 순서대로 처리한다. 각 버전에 대하여:
a. 릴리스 노트(Release Notes)를 가져온다:

gh api repos/anthropics/claude-code/releases --jq '.[] | select(.tag_name == "<TAG>") | .body'

릴리스 노트가 비어 있는 경우, 해당 버전은 건너뛰고 다음으로 진행한다 (최종 보고서에 건너뛰었다는 내용을 기재).
b. 아래의 "출력 포맷"과 "규칙"을 엄격히 준수하여 일본어로 요약한다.
c. 결과를 다음 경로에 저장한다 (경로에 공백이 있으므로 반드시 따옴표를 사용):

~/Documents/Obsidian Vault/ClaudeCodeUpdates/<TAG>.md

5. 최종 보고서

모든 처리가 끝나면, 하나의 블록으로 간결하게 보고한다. 예시:

✅ 3건의 릴리스를 요약했습니다
- v2.1.144 → ~/Documents/Obsidian Vault/ClaudeCodeUpdates/v2.1.144.md
- v2.1.145 → ~/Documents/Obsidian Vault/ClaudeCodeUpdates/v2.1.145.md
- v2.1.146 → ~/Documents/Obsidian Vault/ClaudeCodeUpdates/v2.1.146.md
🧩 스킵: 없음

출력 포맷 (엄수)

각 버전의 요약 파일은 다음 포맷으로 생성한다.

# Claude Code v{VERSION} 업데이트 정리
## 💡 주목할 점
(1~5개, 각 3~5행으로 심층 분석. 발화 조건에 해당할 경우 Mermaid 도해를 삽입)
## 📃 변경 사항 목록
### 📨 보안 수정
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|
| ... | ... |
### ✨ 신기능
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|
### ↑ 개선
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|
### 💩 버그 수정
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|
### 📝 기타
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|

해당 사항이 없는 카테고리의 표는 통째로 생략한다.

규칙

Ⅿ 주목할 점은 "서두에", "1~5개 가변적으로" 작성한다

...

# Claude Code v2.1.111 업데이트 정리
## 💡 주목할 점
### 1.

`/ultrareview` 커맨드 추가 — PR 리뷰의 품질과 속도를 한 단계 끌어올림
기존의 코드 리뷰는 단일 모델이 위에서부터 순차적으로 읽는 형식이라, 규모가 큰 PR(Pull Request)의 경우 놓치는 부분이 생기기 쉽고 시간도 오래 걸렸다. 이 기능은 클라우드 상에서 여러 에이전트(Agent)를 병렬로 실행하여 관점별로 체크하기 때문에, 설계 실수, 보안 우려, 성능 문제 등을 동시에 찾아낼 수 있다. 인자 없이 실행하면 현재 브랜치를, `/ultrareview <PR#>`를 사용하면 임의의 GitHub PR을 리뷰할 수 있다.
```mermaid
flowchart LR
PR[PR or branch] --> U["/ultrareview"]
U --> A1[Agent: 설계]
...
```
인간 리뷰어의 전단계 필터로 사용하면, 지적의 입도가 거친 초기 라운드를 AI에게 맡길 수 있다.
### 2. Auto 모드가 Opus 4.7에서 사용 가능 (Max 플랜)
지금까지는 태스크에 따라 수동으로 모델을 전환해야 했으며, "무거운 구현은 Opus, 가벼운 질문은 Sonnet"과 같이 매번 사용법을 판단해야 했다. Auto 모드는 태스크의 난이도를 보고 자동으로 모델을 선택해 주기 때문에, 일상적인 사용에서 고민 없이 속도와 지능의 균형을 맞출 수 있다.
## 📋 변경 목록
### ✨ 신기능
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|
| `/ultrareview` 커맨드 | PR 리뷰를 여러 AI로 병렬 실행하여 누락 감소 |
| Auto 모드 Opus 4.7 지원 (Max 플랜) | 모델 선택의 번거로움 제거 |
### ⬆️ 개선
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|
| `Ctrl+U`로 입력 버퍼 전체 삭제 (이전에는 행 시작 부분까지) | 긴 입력을 한 번에 삭제 가능. 실수했을 경우 `Ctrl+Y`로 복구 |
### 🐛 버그 수정
| 변경 사항 | 누구에게 어떻게 유익한가 |
|---|---|
| iTerm2 + tmux 환경에서 장시간 실행 시 화면 깨짐 수정 | 글자 깨짐으로 인해 작업이 불가능해지던 문제 해결 |

이 포맷과 입도를 엄격히 준수한다.

보충

"특정 버전만 다시 생성하고 싶다"면, Vault에서 해당 파일(예: ~/Documents/Obsidian Vault/ClaudeCodeUpdates/v2.1.144.md)을 삭제하고 이 스킬을 재실행하면 차분 탐지(diff detection)를 통해 포착된다.

```

Claude Code 세션 내에서 `/catch-up-claude-code`

...
```
{
"hooks": {
"SessionStart": [
{
"hooks": [
{ "type": "command", "command": "echo '/catch-up-claude-code'" }
]
}
]
}
}
```

hook 자체는 실행되며, 출력도 세션의 컨텍스트(Context)로 전달된다. 다만 **Claude Code의 SessionStart hook은 "컨텍스트를 준비하는" 사양으로, 이를 받아 Claude가 자발적으로 움직이기 시작하지는 않는다** (사용자의 입력을 기다림). 셸 함수(`claude()`를 오버라이드하여 초기 프롬프트를 전달하는 방식)도 시도해 보았으나, `source ~/.zshrc`를 해야 하는 번거로움과 효과가 맞먹지 않아, 최종적으로는 수동 운용으로 정착했습니다.

교훈: "PC를 닫아도 동작한다", "세션을 넘나들며 동작한다"와 같은 요구사항은 정말 필요한지 먼저 재고해 볼 가치가 있다. 하루에 몇 번 실행하는 정도라면, `/catch-up-claude-code`를 한 번 입력하는 것이 훨씬 편하다.

- Claude Code 업데이트를 추적하지 못하는 문제는 스킬 하나로 해결
- 세션에서 `/catch-up-claude-code`를 한 번 입력하기만 하면 됨. 차분 판정이 있어 낭비가 없음
- 자동 실행은 SessionStart hook/셸 함수로 시도해 보았으나, 결국 수동이 가장 심플함
- 셸 스크립트도 launchd도 `/loop`도 hook도 필요 없음. Claude Code 내에서 완결

마찬가지로 Claude Code의 릴리스 노트(Release Notes)에 파묻혀 있는 분들에게 참고가 되길 바랍니다.

Insights