설계 노트:
disable-model-invocation은 의도적으로 생략되었습니다. Bash 결과를 파싱하여 한국어 마크다운으로 구조화하는 데 모델 추론이 필요합니다.
dding-dong 도움말
사용자에게 dding-dong 플러그인의 전체 기능을 한국어로 안내합니다.
실행 방법
$ARGUMENTS를 파싱하여 범위를 결정합니다:
- •인자 없음 → 전체 도움말 (모든 섹션)
- •
skills→ 사용 가능한 스킬 목록만 - •
config→ 설정 옵션과 파일 경로만 - •
events→ 이벤트 타입만 - •
env→ 환경변수만 - •
packs→ 사운드팩만
인자가 위 키워드와 정확히 일치하지 않으면 전체 도움말을 표시합니다.
정보 수집
아래 명령어로 런타임 정보를 수집합니다:
node "${CLAUDE_PLUGIN_ROOT}/skills/dd-help/scripts/gather-info.mjs" --type all
$ARGUMENTS가 skills, config, packs 중 하나면 --type $ARGUMENTS로 해당 정보만 수집합니다.
실행이 실패하면 "정보를 가져올 수 없습니다. /dding-dong:dd-doctor로 진단해주세요."로 대체합니다.
출력 포맷팅
수집된 JSON을 아래 섹션별 형식으로 한국어 마크다운 출력합니다. 인자가 있으면 해당 섹션만, 없으면 모든 섹션을 순서대로 출력합니다.
헤더
# dding-dong 도움말 Claude Code 알림 플러그인 — 작업 완료, 오류, 입력 요청 시 사운드와 OS 알림을 보냅니다.
1. 사용 가능한 스킬 (인자: skills)
JSON의 skills 배열을 테이블로 출력합니다.
koDescription이 있으면 한글 설명을, 없으면 description 전체를 표시합니다.
| 스킬 | 설명 |
|---|---|
/dding-dong:<name> | koDescription 또는 description |
2. 이벤트 타입 (인자: events)
JSON의 config.sound.events와 config.notification.events에서 추출합니다.
ON/OFF 대신 체크마크를 사용합니다.
| 이벤트 | 사운드 | 알림 | 설명 |
|---|---|---|---|
task.complete | ✓/- | ✓/- | 작업 완료 |
task.error | ✓/- | ✓/- | 오류 발생 (훅 없음, 테스트 전용) |
input.required | ✓/- | ✓/- | 사용자 입력 필요 |
session.start | ✓/- | ✓/- | 세션 시작 |
session.end | ✓/- | ✓/- | 세션 종료 |
task.error는 현재 트리거 훅이 없으며,/dding-dong:dd-test에서만 테스트 가능합니다.
3. 설정 옵션 (인자: config)
JSON의 config 객체를 dot notation 테이블로 나열합니다.
_meta, messages 키는 제외합니다.
| 키 | 기본값 | 설명 |
|---|---|---|
enabled | true | 플러그인 활성화 |
language | "ko" | 메시지 언어 (ko/en) |
sound.enabled | true | 사운드 활성화 |
sound.pack | "default" | 사운드팩 이름 |
sound.volume | 0.7 | 볼륨 (0.0~1.0) |
sound.events.* | 이벤트별 사운드 ON/OFF | |
notification.enabled | true | OS 알림 활성화 |
notification.events.* | 이벤트별 알림 ON/OFF | |
quiet_hours.enabled | false | 야간 모드 활성화 |
quiet_hours.start | "22:00" | 야간 시작 시간 |
quiet_hours.end | "08:00" | 야간 종료 시간 |
cooldown_seconds | 3 | 알림 간 최소 간격 (초) |
설정 변경 예시: /dding-dong:dd-config set sound.volume 0.5
4. 설정 파일 경로 (인자: config)
나중 단계가 이전 단계를 덮어씁니다 (5단계 병합):
- •Default — 하드코딩 기본값
- •Global —
~/.config/dding-dong/config.json - •Project —
.dding-dong/config.json(팀 공유, 커밋됨) - •Project Local —
.dding-dong/config.local.json(개인 오버라이드, gitignore) - •환경변수 — 아래 참조
5. 환경변수 (인자: env)
| 변수 | 설명 |
|---|---|
DDING_DONG_ENABLED | false로 비활성화 |
DDING_DONG_VOLUME | 볼륨 오버라이드 (0.0~1.0) |
DDING_DONG_LANG | 언어 오버라이드 (ko/en) |
DDING_DONG_PACK | 사운드팩 오버라이드 |
6. 설치된 사운드팩 (인자: packs)
JSON의 packs 배열을 테이블로 출력합니다. type이 built-in이면 "내장", user이면 "사용자"로 표시합니다.
| 팩 이름 | 표시 이름 | 구분 |
|---|---|---|
<name> | <displayName> | 내장/사용자 |
사운드팩 관리: /dding-dong:dd-sounds
7. 관련 스킬 안내
출력 마지막에 다음 교차 참조를 추가합니다:
--- **다음 단계** - 설정 변경 → `/dding-dong:dd-config` - 사운드팩 변경 → `/dding-dong:dd-sounds` - 알림 테스트 → `/dding-dong:dd-test` - 문제 해결 → `/dding-dong:dd-doctor` - 피드백/버그 신고 → `/dding-dong:dd-feedback`