| name | audio-ear |
| description | Compare reference/test WAV files for synth or sampler tuning and produce actionable DSP fixes. Use when asked to diagnose low-end decay mismatch, pitch drift, resonance, ringing, formant shifts, or overall timbre gaps between A and B. Includes a fast ffmpeg/sox profile and a detailed FFT/STFT comparison pipeline. |
Audio Ear Skill
레퍼런스 A와 구현 B의 사운드를 수치 비교해 개선 포인트를 뽑는다.
Workflow
- 빠른 1차 진단(FFmpeg/SoX)
- 정밀 2차 분석(FFT/STFT)
- JSON 결과를 프롬프트에 넣어 수정 우선순위 도출
1) Quick Compare (FFmpeg/SoX)
python3 scripts/ffmpeg_sox_quick_compare.py \
--ref /abs/path/A.wav \
--test /abs/path/B.wav \
--json-out /tmp/quick.json \
--md-out /tmp/quick.md
용도:
- 레벨/밝기/트랜지언트 차이를 빠르게 확인
- 큰 편차가 있는지 먼저 걸러내기
2) Detailed Compare (FFT/STFT)
python3 scripts/wav_ear_compare.py \
--ref /abs/path/A.wav \
--test /abs/path/B.wav \
--max-seconds 4.0 \
--fft-size 2048 \
--hop-size 512 \
--json-out /tmp/ear_detail.json \
--md-out /tmp/ear_detail.md
핵심 지표:
- 저역 감쇄(T20/T40)
- 스펙트럼 중심(centroid), rolloff, flatness, tilt
- resonance prominence, ring ratio
- median F0, F0 drift
- click/body 비율(초기 어택 강도)
- H2/H1, H3/H1, H1.5/H1(부분음/OSC2 유사 성분)
- formant-like peak
3) LLM 리뷰 연결
references/analysis_prompt_ko.md 템플릿에 /tmp/quick.json, /tmp/ear_detail.json 내용을 넣고 개선안을 요청한다.
4) Preset 실효 비교 (중요)
파라미터가 달라 보여도 엔진 우선순위 때문에 실제 음색 변화가 거의 없을 수 있다.
특히 pitchEnv가 있으면 startFreq/endFreq/p_decay는 _schedulePitch()에서 우선되지 않는다.
python3 scripts/preset_effective_compare.py \
--a /abs/path/preset_before.json \
--b /abs/path/preset_after.json \
--json-out /tmp/preset_effective.json \
--md-out /tmp/preset_effective.md
출력:
- Effective Changes: 실제 렌더에 반영되는 차이
- Ignored-Likely Changes: 바뀌어도 청감 영향이 작은/없는 필드
권장 캡처 규칙
- A/B를 동일 MIDI, 동일 길이, 동일 velocity로 렌더
- 가능한 dry 신호 기준으로 먼저 비교
- 레벨 편차가 크면 gain-match 후 해석
- 같은 샘플레이트를 권장(정밀 스크립트는 필요 시 리샘플링)
빠른 일괄 실행
bash scripts/run_ear_pipeline.sh /abs/path/A.wav /abs/path/B.wav /tmp/ear-run \
--preset-a /abs/path/preset_before.json \
--preset-b /abs/path/preset_after.json
출력:
quick.md, quick.jsondetail.md, detail.json- (옵션)
preset_effective.md, preset_effective.json
