d3ro-voice/.claude/skills/debug-electron/SKILL.md
Yun Chan e24bb8378c 초기 프로젝트 설정: 하네스 시스템 + 설계서 + RE 노하우
- CLAUDE.md: 프로젝트 규칙, 기술 스택, 코딩 규칙, 페이즈 로드맵
- .claude/settings.json: 권한, 강제 훅 (매 프롬프트 설계서 규칙 주입)
- .claude/skills/: implement-phase, review-phase, scaffold, test-commit, debug
- .claude/agents/: electron-architect, voice-pipeline-expert, ui-specialist
- docs/design/00-09: 마스터 아키텍처, 서비스 명세(16개), IPC(113채널),
  DB스키마, UI컴포넌트, 검증리포트, 외부엔진연동, 갭분석,
  VoiceMode패턴, 디자인시스템, 히스토리팝업
- docs/phases/1-7+3.5: 전체 구현 페이즈 문서
- docs/re-findings/: Speakly RE 노하우 5개 문서
2026-04-05 01:03:03 +09:00

858 B

name description allowed-tools
debug-electron Electron 앱 디버깅. IPC 문제, 메모리 누수, 렌더러 크래시 등 진단. Read Grep Glob Bash

Electron Debug

일반 디버깅

  1. 로그 확인 (electron-log 출력)
  2. IPC 채널 매칭 검증 (shared/ipc-channels.ts vs 실제 핸들러)
  3. 프리로드 스크립트 노출 API 확인

IPC 문제

  • shared/ipc-channels.ts에 채널 정의 확인
  • src/main/ipc/에 핸들러 등록 확인
  • src/preload/index.ts에 브릿지 노출 확인
  • 렌더러에서 window.electronAPI.* 호출 확인

오디오 문제

  • Web Audio API 초기화 상태
  • 마이크 권한 확인
  • AudioContext sampleRate (24000Hz)
  • noiseSuppression: false 확인

메모리 누수

  • useEffect cleanup 함수 확인
  • IPC 이벤트 리스너 제거 확인
  • BrowserWindow destroy 확인