processing-audiolisted

# Audio Processor 스킬 ## Overview ffmpeg을 활용한 오디오 파일 변환 및 처리 자동화 스킬입니다. **중요**: 이 스킬이 활성화되면 Claude가 자동으로 스크립트를 실행합니다. 사용자가 직접 명령어를 입력할 필요가 없습니다. **핵심 기능:** - **포맷 변환**: wav, m4a, opus, mp3 등 상호 변환 - **샘플레이트 변환**: 8kHz, 16kHz, 22.05kHz, 44.1kHz, 48kHz - **채널 변환**: 스테레오 → 모노, 모노 → 스테레오 - **세그먼트 분할**: 고정 시간 또는 타임스탬프 기반 분할 - **배치 처리**: 디렉토리 내 여러 파일 일괄 처리 ## Script Location ``` SCRIPT: ./scripts/audio-process.sh ``` Claude는 이 스크립트를 Bash 도구로 직접 실행합니다. ## When to Use 이 스킬은 다음 상황에서 활성화됩니다: **명시적 요청:** - "오디오 변환해줘", "wav로 바꿔줘" - "샘플레이트 16kHz로 변경해줘" - "모노로 변환해줘" - "10초 단위로 분할해줘" - "ffmpeg으로 처리해줘" **자동 활성화:** - 오디오 파일 처리 요청 시 (.wav, .mp3, .m4a, .opus 등) - 음성 데이터 전처리 요청 시 ## Prerequisites ```bash # ffmpeg 설치 확인 ffmpeg -version # 스크립트 실행 권한 chmod +x /path/to/agt/ml/audio-processor/scripts/audio-process.sh ``` ## Workflow ### Claude 실행 절차 **Step 1**: 사용자 요청 분석 - 입력 파일 경로 확인 - 원하는 변환 유형 파악 (포맷/샘플레이트/채널/분할) - 출력 경로 결정 (명시되지 않으면 입력 파일과 같은 디렉토리) **Step 2**: 스크립트 실행 ```bash # 스크립트 경로 SCRIPT=./scripts/audio-process.sh # 포맷 변환 $SCRIPT convert <input> <output> [--sr <rate>] [--mono|--stereo] # 세그먼트 분할 $SCRIPT segment <input> <output_dir> --duration <sec> # 배치 변환 $SCRIPT batch <input_dir> <output_dir> --format <fmt> [--sr <rate>] [--mono] # 파일 정보 조회 $SCRIPT info <file> ``` **Step 3**: 결과 보고 - 스크립트 출력을 사용자에게 전달 - 변환 성공/실패 여부 확인 ### 명령어 레퍼런스 | 작업 | 명령어 | |------|--------| | 포맷 변환 | `$SCRIPT convert in.mp3 out.wav` | | 16kHz mono 변환 | `$SCRIPT convert in.mp3 out.wav --sr 16000