---
name: study-supplement
description: 스터디 콘텐츠에 대해 질문에 답하고, 사용자 승인 시 해당 내용을 마크다운에 추가한 뒤 배포하는 워크플로우.
triggers:
  - "내용 보충"
  - "내용 추가"
  - "이거 설명해"
  - "이게 뭐야"
  - "supplement"
---

# 스터디 내용 보충 스킬

사용자가 스터디 관련 질문을 하면 답변하고, 해당 내용을 기존 챕터에 추가할지 확인 후 반영 및 배포.

## 전제 조건

- 프로젝트 루트: `/Users/hobeen/private/hobeen-kim.github.io`
- 스터디 콘텐츠 디렉토리: `docs/_study/{slug}/`
- 기존 챕터 파일이 존재해야 함

## 워크플로우

### 1단계: 질문 파악 및 답변

사용자의 질문을 분석:
- 어떤 스터디의 어떤 챕터에 해당하는 내용인지 판단
- 해당 챕터 파일을 읽어 현재 내용 확인
- 질문에 대해 상세하고 정확하게 답변

### 2단계: 내용 추가 제안

답변 후 반드시 되물음:

```
이 내용을 [챕터명]에 추가할까요?
```

사용자의 응답에 따라 분기:
- **"응"/"추가해"/"넣어"** → 3단계로 진행
- **"아니"/"괜찮아"** → 종료
- **"다른 챕터에"/"새 절로"** → 사용자가 지정한 위치에 추가

### 3단계: 내용 삽입

대상 챕터 파일을 수정:
- 기존 절의 내용을 보강하거나, 새 절(##)을 추가
- 기존 콘텐츠 패턴을 따름:
  - 교차 링크: 관련 블로그 포스트(`/posts/...`)나 다른 스터디 챕터(`/study/...`)가 있으면 본문에 링크 삽입
  - 문체: **반말 평서체(해라체)** 사용 — `~이다`, `~한다`, `~있다`, `~된다` 등. `~입니다`, `~합니다`, `~있습니다` 등 경어체 금지
  - Mermaid 다이어그램이 적절한 경우 포함
  - 코드 예제가 필요한 경우 포함
  - `<br/>` 사용 금지 — `<br>` 사용
  - `**bold**한글` 패턴 금지 — CommonMark에서 닫는 `**` 뒤에 한글이 바로 오면 bold가 적용되지 않음. `<strong>bold</strong>한글` 사용
  - GitHub 스타일 callout(`> [!TIP]`, `> [!INFO]`) 사용 금지 — VuePress에서 렌더링되지 않음
- VuePress 마크다운 컨테이너 활용:
  - `:::tip 제목` — 핵심 정리, 팁
  - `:::info 제목` — 참고 정보, 부연 설명
  - `:::warning 제목` — 주의사항, 안전 관련 경고
  - `:::details 제목` — 접기/펼치기 (긴 코드 예제, 심화 내용)
  - `:::tabs` + `@tab` — 멀티 언어 코드 예제 (C/Python 등)
- Mermaid 다이어그램 유형 활용:
  - `flowchart`, `sequenceDiagram` — 흐름도, 통신 과정
  - `packet-beta` — 프레임/패킷 필드 구조
  - `stateDiagram-v2` — 상태 천이 (`\n` 대신 `<br>` 사용)
  - `timeline` — 기술 발전사, 시간순 이벤트 (`<br>` 미지원, 쉼표로 구분)
  - `quadrantChart` — 2축 비교 (`한글/특수문자 라벨 미지원`, 영문만 사용)
  - `xychart-beta` — 수치 비교 차트
  - `pie` — 비율/분포
  - `mindmap` — 개념 지도
- 기존 내용을 삭제하거나 변경하지 않음 — 추가만

### 4단계: 빌드 및 배포

```bash
cd /Users/hobeen/private/hobeen-kim.github.io
npm run docs:build
git add docs/_study/
git commit -m "docs: {챕터명} 내용 보충 — {추가한 내용 요약}"
git push origin master
```

## 삽입 위치 판단 기준

| 상황 | 위치 |
|------|------|
| 기존 절의 내용을 보충 | 해당 절 하단에 추가 |
| 새로운 개념/토픽 | 관련 절 뒤에 새 `##` 절 추가 |
| 실습/예제 추가 | `:::tip 핵심 정리` 바로 위에 삽입 |
| 기존 챕터에 안 맞는 내용 | 사용자에게 새 챕터 생성 여부 확인 |

## 예시 흐름

```
사용자: CAN에서 비트 타이밍이 뭐야?
AI: [비트 타이밍에 대한 상세 설명]
    이 내용을 03. CAN 물리 계층에 추가할까요?
사용자: 응
AI: [03-can-physical.md에 '비트 타이밍' 절 추가]
    [빌드 → 커밋 → 푸시]
    추가 완료. https://hobeen-kim.github.io/study/isobus/03-can-physical 에서 확인 가능합니다.
```