| name | dd-uninstall |
| description | Selectively remove dding-dong artifacts (global config, project config, TTS venv) with dry-run preview. 플러그인 정리/삭제 마법사. Use when the user says 'uninstall', 'remove dding-dong', 'clean up', 'delete config', '삭제', '정리', '제거', '언인스톨'. |
| allowed-tools | ["Bash","Read","Glob","AskUserQuestion"] |
dding-dong 정리 마법사
플러그인이 생성한 아티팩트(설정, 사운드팩, TTS venv 등)를 선택적으로 삭제합니다.
플래그 파싱
$ARGUMENTS에서 플래그를 확인합니다:
-
--help: 아래 사용법을 출력하고 종료합니다.
dding-dong 정리 마법사
사용법: /dding-dong:dd-uninstall [옵션]
옵션:
--all 모든 아티팩트 선택 (선택 단계 건너뜀)
--help 이 도움말 표시
-
--all: 2단계(범위 선택)를 건너뛰고 존재하는 모든 아티팩트를 선택합니다. dry-run과 최종 확인은 여전히 실행됩니다.
삭제 대상 아티팩트
| 카테고리 | 경로 | 설명 |
|---|
| 글로벌 설정 | ~/.config/dding-dong/config.json + *.backup* | 전역 설정 및 백업 |
| 글로벌 상태 | ~/.config/dding-dong/.state.json | 쿨다운 타임스탬프 |
| 글로벌 사운드팩 | ~/.config/dding-dong/packs/ | 사용자 설치 팩 |
| TTS venv | ~/.config/dding-dong/tts-venv/ | Python 가상환경 (2-15GB) |
| 프로젝트 설정 | .dding-dong/config.json + *.backup* | 팀 공유 설정 |
| 프로젝트 로컬 | .dding-dong/config.local.json + *.backup* | 개인 오버라이드 |
| 프로젝트 팩 | .dding-dong/packs/ | 프로젝트 커스텀 팩 |
| 프로젝트 상태 | .dding-dong/.state.json | 프로젝트 상태 |
실행 순서
1단계: 환경 스캔
현재 설정 상태를 확인합니다:
node "${CLAUDE_PLUGIN_ROOT}/scripts/check-config.mjs" --cwd "$(pwd)"
그 다음 각 아티팩트의 존재 여부를 확인합니다:
ls -la ~/.config/dding-dong/ 2>/dev/null || echo "GLOBAL_DIR_NOT_FOUND"
ls -d ~/.config/dding-dong/tts-venv 2>/dev/null && echo "TTS_VENV_EXISTS" || echo "TTS_VENV_NOT_FOUND"
ls -la .dding-dong/ 2>/dev/null || echo "PROJECT_DIR_NOT_FOUND"
아무 아티팩트도 없으면:
"dding-dong 관련 파일이 발견되지 않았습니다. 정리할 항목이 없습니다." 안내 후 종료합니다.
스캔 결과를 기억하여 이후 단계에서 사용합니다. 존재하는 항목만 목록으로 정리합니다.
2단계: 삭제 범위 선택
--all 플래그가 있으면 존재하는 모든 항목을 선택하고 3단계로 건너뜁니다.
AskUserQuestion (multiSelect: true)으로 질문합니다:
"삭제할 항목을 선택해주세요."
존재하는 항목만 선택지에 표시합니다. 각 선택지는 아래 카테고리를 기준으로 합니다:
- 글로벌 설정 — "전역 설정, 상태, 사용자 사운드팩 (~/.config/dding-dong/)" (글로벌 디렉토리 내 config.json, .state.json, packs/ 중 하나라도 존재할 때)
- 프로젝트 설정 — "프로젝트 설정, 로컬 설정, 프로젝트 팩 (.dding-dong/)" (프로젝트 디렉토리 내 파일이 하나라도 존재할 때)
- TTS 가상환경 — "Python TTS 가상환경 (~/.config/dding-dong/tts-venv/)" (tts-venv 디렉토리가 존재할 때)
선택지가 하나뿐이면 multiSelect 질문 대신 해당 항목을 자동 선택하고, 사용자에게 "삭제 가능한 항목이 하나뿐입니다: [항목명]" 안내 후 3단계로 진행합니다.
3단계: dry-run 미리보기
선택된 각 카테고리의 파일/폴더 목록과 크기를 표시합니다.
글로벌 설정 선택 시:
du -sh ~/.config/dding-dong/config.json ~/.config/dding-dong/.state.json ~/.config/dding-dong/packs/ 2>/dev/null; ls ~/.config/dding-dong/config.json.backup* 2>/dev/null
프로젝트 설정 선택 시:
du -sh .dding-dong/ 2>/dev/null
TTS venv 선택 시:
du -sh ~/.config/dding-dong/tts-venv/ 2>/dev/null
결과를 한국어 마크다운 테이블로 정리합니다:
## 삭제 예정 항목
| 항목 | 경로 | 크기 |
|------|------|------|
| 글로벌 설정 | ~/.config/dding-dong/config.json | XX KB |
| 글로벌 상태 | ~/.config/dding-dong/.state.json | XX KB |
| ... | ... | ... |
| **합계** | | **XX MB** |
경고 표시 조건:
- 프로젝트 설정에
.dding-dong/config.json이 포함된 경우:
⚠️ .dding-dong/config.json은 팀 공유 파일입니다 (Git 추적 대상). 삭제하면 팀원에게 영향을 줄 수 있습니다.
- TTS venv가 포함된 경우, 크기를 강조:
ℹ️ TTS 가상환경은 [크기] 의 디스크 공간을 차지하고 있습니다.
4단계: 최종 확인
AskUserQuestion으로 질문합니다:
"위 항목을 삭제합니다. 진행하시겠습니까?"
선택지:
- 삭제 진행 — "선택한 항목을 영구 삭제합니다."
- 취소 — "삭제를 취소합니다."
"취소"를 선택하면 "삭제가 취소되었습니다." 안내 후 종료합니다.
5단계: 삭제 실행
선택된 카테고리별로 삭제를 실행합니다. 각 명령은 개별적으로 실행하여 부분 실패를 추적합니다.
글로벌 설정 선택 시:
rm -f ~/.config/dding-dong/config.json ~/.config/dding-dong/config.json.backup*
rm -f ~/.config/dding-dong/.state.json
rm -rf ~/.config/dding-dong/packs/
프로젝트 설정 선택 시:
rm -rf .dding-dong/
TTS venv 선택 시:
rm -rf ~/.config/dding-dong/tts-venv/
글로벌 디렉토리 정리:
글로벌 설정과 TTS venv가 모두 삭제되어 ~/.config/dding-dong/이 비었으면 (내장 사운드 제외, 남은 파일 없음):
if [ -z "$(ls -A ~/.config/dding-dong/ 2>/dev/null)" ]; then
rmdir ~/.config/dding-dong/
fi
.gitignore 정리 (프로젝트 설정 삭제 시):
프로젝트 루트의 .gitignore에 dding-dong 관련 엔트리가 있으면 AskUserQuestion으로 질문:
".gitignore에서 dding-dong 관련 항목도 제거하시겠습니까?"
- 예, 제거 (Recommended) — ".gitignore에서 dding-dong 관련 라인을 삭제합니다."
- 아니오, 유지 — ".gitignore는 그대로 둡니다."
"예" 선택 시, .gitignore에서 다음 패턴을 포함하는 라인을 제거합니다:
dding-dong 또는 .dding-dong을 포함하는 라인config.local.json을 포함하는 라인 (dding-dong 관련 주석이 있는 경우만)
grep -n -i "dding.dong\|\.dding-dong" .gitignore 2>/dev/null
해당 라인을 확인 후 sed로 제거합니다. .gitignore가 비게 되면 파일 자체는 남겨둡니다.
에러 처리:
- 각 rm 명령의 종료 코드를 확인합니다.
- 실패한 항목은 기록하되 나머지 삭제는 계속 진행합니다.
- 최종 결과에 실패 항목을 포함합니다.
6단계: 결과 리포트
삭제 결과를 한국어로 요약합니다:
## 정리 완료
✓ 삭제된 항목:
- 글로벌 설정 (~/.config/dding-dong/config.json)
- 글로벌 상태 (~/.config/dding-dong/.state.json)
- ...
해제된 디스크 공간: ~XX MB
남은 항목:
- (없음) 또는 남아있는 항목 목록
실패한 항목이 있으면:
⚠️ 삭제 실패:
- [경로]: [에러 메시지]
마지막에 안내:
---
**참고**
- 재설정하려면 → `/dding-dong:dd-setup`
- 플러그인 자체를 제거하려면 → `claude plugin remove dding-dong`
관련 스킬
- 초기 설정 →
/dding-dong:dd-setup
- 설정 확인 →
/dding-dong:dd-config
- 알림 문제 진단 →
/dding-dong:dd-doctor
- 전체 기능 안내 →
/dding-dong:dd-help
