Community라이팅 & 에디팅github.com

AIKONG2024/paper-translate-agent-skill

활성 채팅 모델을 번역기로 사용하여 PDF를 번역하고, 중단 가능한 배치 처리와 레이아웃을 유지하는 렌더링을 지원하는 이식 가능한 에이전트 스킬입니다.

paper-translate-agent-skill란 무엇인가요?

이 스킬은 활성 채팅 모델을 활용하여 PDF 문서를 번역하는 에이전트용 포터블 스킬입니다. 번역 작업은 모델이 직접 수행하며, 번역 프로세스는 중단 가능한 배치(batch) 단위로 나뉘어 진행됩니다. 사용자는 번역 대상 언어와 페이지 범위를 지정할 수 있으며, 누락된 출발 언어는 첫 텍스트 페이지에서 자동으로 추론됩니다. 워크플로우는 환경 진단(doctor), 의존성 설치(setup), PDF 준비(prepare), 배치 번역(next/submit), 렌더링(render), 검증(validate)의 순서로 구성되며, 각 단계는 스크립트를 통해 명령형으로 실행됩니다. 번역된 결과는 원본 PDF의 레이아웃을 최대한 유지하는 방식으로 렌더링되며, 언어적 경고와 미리보기 쌍을 함께 반환합니다. Cursor, Claude Code, Codex 등 명령어 기반 AI 에이전트 환경과 호환됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add AIKONG2024/paper-translate-agent-skill

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

PDF 번역

활성 채팅 모델이 번역기 역할을 수행합니다. 번들에 포함된 스크립트는 로컬 PDF 작업의 준비, 영속화, 렌더링 및 검증만 수행하며, 모델, 제공자 API 또는 인증된 서비스를 호출하지 않습니다. 기본 출력은 번역문만 포함합니다.

호환성 경계

시작하기 전에 호스트 환경이 로컬 PDF 접근, UTF-8 파일 읽기/쓰기, Python 프로세스 실행, 셸 접근 및 최초 의존성 설정 권한을 보유하고 있는지 확인하세요. 어떤 기능이라도 누락된 경우 중단하고 다음을 보고하세요: Unsupported host: pdf-translate requires local files, UTF-8 read/write, Python, shell access, and first-run setup. 대체 방법을 시도하지 마세요.

워크플로우

요청에서 대상 언어와 페이지 범위를 가져옵니다. 첫 번째 텍스트 페이지에서 생략된 출발 언어를 추론하고, 두 언어 중 하나라도 모호한 경우에만 질문하세요. 쓰기 가능한 <job-dir>을 사용하고 다음을 실행하세요:

<python> pdf-translate/scripts/run.py doctor --json
<python> pdf-translate/scripts/run.py setup --json
<python> pdf-translate/scripts/run.py prepare --source <pdf> --job-dir <job-dir> --source-lang <code> --target-lang <code> [--pages <range>] [--output-mode translated|bilingual] [--glossary <file>] [--style academic]
<python> pdf-translate/scripts/run.py next --job-dir <job-dir> --json
<활성 채팅 모델이 batch_path를 읽고 job 소유의 반환된 response_path에 {"translations":[{"id":"...","text":"..."}]}만 작성합니다>
<python> pdf-translate/scripts/run.py submit --job-dir <job-dir> --input <batch-response-path>
<상태가 READY_TO_RENDER가 될 때까지 next/submit 반복>
<python> pdf-translate/scripts/run.py render --job-dir <job-dir> --json
<python> pdf-translate/scripts/run.py validate --job-dir <job-dir> --json

기존 작업의 경우 prepare 대신 <python> pdf-translate/scripts/run.py status --job-dir <job-dir> --json을 실행하고, 다음 동작부터 계속 진행합니다. 다음 결정 트리를 정확히 따르세요: doctor/setup -> prepare 또는 status -> next -> 활성 모델 번역 -> submit -> 반복 -> render -> validate -> PDF 반환. render는 출력을 준비만 하고, validate는 모든 구조적 차단 검사가 통과된 후에 게시합니다. 성공한 validate에서 보고된 충돌하지 않는 최종 PDF 경로만 언어적 경고 및 첫/중간/마지막 미리보기 쌍과 함께 반환하여 시각적 검사를 지원합니다. 번역 전에 번역 정책을 읽고, 작업 JSON을 처리하기 전에 작업 형식을 읽으세요. 작업이 완료되기 전에 중단되면 <job-dir>을 보고하여 이후 작업이 대화 기록이 아닌 파일에서 재개될 수 있도록 하세요.

관련 스킬