녹취록 교정기 (Transcript Fixer)
음성인식(STT) 결과물의 오탈자·동음이의어·고유명사 오인식을 사전 규칙과 Claude 내장 AI로 2단계 교정하고, 교정 내역을 학습해 다음부터 자동으로 잡아주는 스킬입니다.
콘텐츠·글쓰기고급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 1단계(사전 교정):
~/.transcript-fixer/corrections.db에 쌓인 규칙으로 반복되는 오인식(제품명, 인명, 자주 틀리는 단어)을 즉시·무료로 교정합니다. 기본값은 안전 모드라 위험도가 높은 치환은 자동 적용하지 않고*_needs_review.md로 따로 빼줍니다. - 2단계(Claude 내장 AI 교정): 외부 API 키 없이 Claude가 1단계 결과물을 직접 읽어 사전에 없던 전문 용어·고유명사·문맥 동음이의어를 잡아냅니다. 이 단계가 실제로 가장 많은 오류를 잡는 핵심 경로입니다.
- 학습·누적: 확정된 교정은
--add로 도메인 사전에 저장되고, 반복 패턴은--review-learned/--approve로 승격됩니다. 애매한 항목은 리뷰 큐에 저장해 나중에 한 번에 판정할 수 있습니다. - 안전장치: 드라이런 미리보기, 변경 리포트, 오탐 신고(
--report-false-positive), 규칙 감사(--audit), 코퍼스 실측 확인(--probe) 등 오교정을 막는 도구가 촘촘합니다. - 자동화 대비: Claude Code가 없는 CI 환경에서는 GLM API를 쓰는 3단계 배치 모드를 대안으로 제공합니다.
이런 분께 추천
- 회의록, 인터뷰, 강의 녹취록을 정기적으로 정리하는 리서처·PM·기록 담당자
- Whisper/Otter/사내 회의 도구의 STT 결과를 문서로 다듬어야 하는 지식 노동자
- 사내 제품명, 팀원 이름 등 고유명사가 계속 잘못 인식되어 매번 같은 수정을 반복하는 사람
- 여러 녹취록을 파이프라인으로 자동 처리하려는 개발자
활용 예시
- 주간 회의록 정리:
--stage 1로 사전 교정을 돌린 뒤 Claude가 남은 오류를 직접 읽고 고치고, 반복될 만한 오인식은--domain myproject로 사전에 등록해 다음 주엔 자동 교정되게 합니다. - 강의 녹취록 대량 처리: 폴더 안의 파일들을 셸 루프로 1단계 처리하고,
--json출력으로 적용/보류 건수를 확인해 보류 항목만 사람이 검토합니다. - 인명 오인식 정리: 자주 등장하는 사람 이름의 STT 변형을 people roster에 등록해, 이후 모든 녹취록에서 이름이 자동으로 정확히 표기되게 만듭니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-audio/transcript-fixer 폴더를 내 ~/.claude/skills/transcript-fixer/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-audio/transcript-fixer ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- uv 설치: 스킬의 스크립트들이 uv(PEP 723 인라인 의존성)로 실행됩니다. 터미널에서
curl -LsSf https://astral.sh/uv/install.sh | sh를 실행하세요(macOS/Linux). - 저장소 클론:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더 복사:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-audio/transcript-fixer ~/.claude/skills/ - DB 초기화:
cd ~/.claude/skills/transcript-fixer && uv run scripts/fix_transcription.py --init - Claude Code 재시작 후 "이 녹취록 오인식 고쳐줘" 처럼 요청하면 스킬이 자동으로 호출됩니다.
- (선택) 도메인 프리셋 불러오기:
uv run scripts/fix_transcription.py --load-presets tech - (선택) Claude Code 없이 CI에서 배치 처리하려면
export GLM_API_KEY="..."후--stage 3모드를 사용하세요. Claude Code 안에서는 3단계를 쓰지 않는 것이 권장됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT