
프로젝트 소개
sci-translation-skill은 coding agent에 로드할 수 있는 논문 번역, 용어 관리 및 번역문 검토 지침 모음으로, 컴퓨터 과학, 의학, 공학, 재료과학 및 기타 이공계 논문의 중국어-영어 번역 작업을 대상으로 합니다. 새로운 번역 모델이 아니라 워크플로 규범, 역할 계약, 용어 관리, 로컬 결정론적 검사 스크립트를 결합한 도구입니다.
프로젝트의 목표는 단순히 더 “SCI 논문다운” 영어를 생성하는 것이 아닙니다. 자연스러운 표현을 유지하면서 용어 변동, 기술적 의미의 왜곡, 조건과 한정의 누락, 숫자의 잘못된 연결, 형식 손상을 줄여 저자가 항목별로 검토할 수 있는 투고용 원고에 가까운 번역문을 만드는 것입니다.
유창함이 정확성을 의미하지는 않습니다. 과학 번역에서는 원문의 주장 범위, 근거의 강도, 인과관계, 부정, 조건, 수량 표현 및 기술적 경계를 우선적으로 보존해야 합니다.
핵심 워크플로
- 구조 목록 작성: 원문을 보존하고 논문 유형, 장, 대상 독자 및 편집 범위를 기록한 뒤 문단별로 명제의 경계를 정리합니다.
- 프로젝트 용어 고정: 핵심 개념에 개념 ID, 표준 번역, 문맥, 권장 형태, 금지된 별칭, 근거 및 미결 사항을 지정합니다.
- 충실한 초역: 먼저 원문의 의미를 정확히 전달한 다음, 동작 주체를 명확히 하고 부담이 큰 문장을 나누며 문단 내 연결을 개선하는 등 독자 중심의 편집을 수행합니다. 단, 논증을 추가하지 않습니다.
- 양방향 교정: 원문, 초역 및 편집본을 동시에 대조하여 편집 과정에서 새로운 기술적 오류가 생겼는지 확인합니다.
- issue ID별 수정: 문제, 수정 내용 및 이유를 항목별로 기록한 후 최종 차이와 영향을 받은 용어를 다시 확인합니다.
- 검토 자료 납품: 번역문, 용어집, 교정 기록, 저자 확인 항목을 출력하고 실제 검사 범위를 명시합니다.
새 논문을 처리할 때 README에서는 먼저 방법 또는 결과 부분의 2~3개 문단을 시험 번역한 뒤 본문, 그림, 표 및 부록으로 확장하고, 마지막에 초록을 확정할 것을 권장합니다. 이렇게 하면 처리 범위를 넓히기 전에 용어와 워크플로를 검증할 수 있습니다.
주요 기능과 적용 범위
용어 및 기술적 충실성
프로젝트는 개념 ID, 고정 버전 및 문맥 기록을 통해 프로젝트 용어를 고정합니다. 모든 논문에 동일한 고정 용어집을 사용하도록 요구하지 않고, 각 논문에 맞는 독립적인 용어 계약을 수립합니다. 문단별 검토에서는 부정, 조건, 수량 표현, 근거의 강도, 숫자, 단위 및 지표의 연결도 확인합니다.
독자 중심 편집
독자 중심 편집은 장의 구성에 따라 기존 정보를 정리하고, 주체와 지시 대상을 명확히 하며, 문장 부담을 낮추고, 더 자연스러운 실질 동사와 어순을 사용해 정보가 없는 상투적 표현을 줄입니다. 필요한 hedging을 삭제하거나 원문에 없는 의미를 추가해서는 안 되며, 논증을 문단 사이에서 옮겨서도 안 됩니다.
다중 Agent와 정직한 단계 하향
실제로 도구가 지원되는 경우 용어 연구, 번역 및 독립 교정을 서로 다른 작업 컨텍스트에 배정할 수 있습니다. 여기서 “다중 Agent”는 여러 독립 작업 컨텍스트를 뜻하며, 서로 다른 모델이나 인간 전문가를 사용한다는 의미는 자동으로 포함하지 않습니다. 실제 도구가 없을 때는 순차적 자체 검토로 전환하고 이를 명확히 공개해야 합니다.
run-manifest는 실제 역할 ID와 알려진 모델을 기록하는 데 사용하며, 존재하지 않는 팀 로그를 만들어서는 안 됩니다. 복잡한 형식과 의학 원고는 여전히 수동 검토 또는 렌더링 검증이 필요하고, 의학 콘텐츠는 전문 인력의 최종 검토도 필요합니다.
분야별 중점 사항
- 컴퓨터 과학, 보안 및 AI: 위협 모델, 접근 제어, KEM과 페이로드 복호화, 수학 기호 및 기술적 경계를 중점적으로 확인합니다.
- 의학 및 생물학: 연구 설계, 연관관계와 인과관계, 효과 크기, 구간, 표본, 용량, 평가변수 및 시점을 중점적으로 확인합니다.
- 공학 및 재료과학: 실험 조건, 단위와 차원, 실측과 시뮬레이션, 오차 및 적용 범위를 중점적으로 확인합니다.
설치 및 실행 환경
SKILL.md가 포함된 sci-translation-skill 디렉터리를 호스트가 실제로 지원하는 스킬 디렉터리에 넣고, 중복 중첩을 피합니다. 저장소 주소를 에이전트에 직접 제공하여 호스트가 설치하도록 할 수도 있습니다.
로컬 Codex의 예시 위치는 ~/.codex/skills/sci-translation-skill/SKILL.md입니다. 현재 디렉터리가 저장소 루트라면 다음 명령으로 설치할 수 있습니다. 대상 위치에 기존 버전이 있다면 먼저 백업하는 것이 좋습니다.
mkdir -p ~/.codex/skills/sci-translation-skill
rsync -a --exclude '.git/' --exclude '.DS_Store' --exclude '__pycache__/' ./ ~/.codex/skills/sci-translation-skill/설치가 완료되면 호스트에서 스킬을 새로 고치거나 새 세션을 열고, SKILL.md를 읽을 수 있는지 확인합니다. 이 파일은 현재 호스트 자체의 구성 문서를 대체하지 않습니다.
다른 호스트로 이전할 때는 먼저 해당 호스트의 스킬 또는 규칙 로드 인터페이스를 확인해야 합니다. Claude Code는 현재 버전에서 지원하는 skill 디렉터리를 기준으로 로드해야 하며, Antigravity, Cursor, Windsurf 및 Aider는 규칙 인터페이스를 확인해야 합니다. Dify, FastGPT, Coze 또는 자체 구축 Harness는 역할 노드, 파일 전달, 종속성 관리 및 실행 기록을 직접 구현해야 합니다. 지식 베이스에 업로드하는 것만으로는 다중 Agent 파이프라인이 구축되지 않습니다.
이 스킬은 Sonnet 또는 Opus의 고정 사용을 요구하지 않으며, 호스트 구성을 임의로 수정하지도 않습니다. 검사 스크립트에는 Python 3 표준 라이브러리만 필요합니다.
기본 사용법
1. pilot 모드로 시험 번역하기
처음 사용할 때는 에이전트에 먼저 용어집을 작성한 다음 지정한 2~3개 문단을 시험 번역하도록 요청할 수 있습니다. 프롬프트에는 분야, 목표 저널 및 입력 형식을 명시하고 인과관계, 부정, 한정 및 수치를 보존하도록 요구해야 합니다.
$sci-translation-skill을 사용해 pilot 모드로 논문을 번역하세요.
분야: [학문 분야];목표 저널: [이름 또는 미정];형식: [LaTeX/Word/일반 텍스트].
먼저 본문, 수식 설명, 그림·표 및 부록을 바탕으로 용어집을 작성한 뒤, 제가 지정한 2~3개 문단을 시험 번역하세요.
먼저 충실하게 번역한 다음 장과 독자를 기준으로 문단 내 정보를 정리하세요. 동작 주체와 지시 대상을 명확히 하고 문장 길이를 억지로 맞추지 마세요.
원문의 인과관계, 부정, 한정 및 수치를 보존하고 실험, 인용 또는 안전 보장을 추가하지 마세요.
독립 Agent 도구가 있으면 역할을 나누어 재검토하고, 그렇지 않으면 순차적 자체 검토임을 명시하세요.
번역문, 고정 용어, 위치가 표시된 수정 설명 및 저자 확인 항목을 출력하세요.시험 번역 결과에는 최소한 번역문, 고정 용어, 위치가 표시된 수정 설명 및 저자 확인이 필요한 사항이 포함되어야 합니다. 용어와 작업 방식을 확인한 후 전체 처리로 확장합니다.
2. 기존 중영 대조 원고 교정하기
중국어 원문과 영어 번역문이 이미 있다면 review 모드를 사용할 수 있습니다. 교정 순서는 먼저 기술적 의미, 용어, 주장 강도, 숫자, 단위 및 인용을 확인하고, 그다음 언어의 자연스러움을 점검해야 합니다.
$sci-translation-skill의 review 모드를 사용해 중국어 원문과 대조하며 영어를 문단별로 교정하세요.
먼저 기술적 의미, 용어, 주장 강도, 숫자/단위 및 인용을 확인한 다음 언어의 자연스러움을 점검하세요.
근거가 있는 문제만 수정하고, “uses→adopts”와 같은 선호 표현과 실질적 오류를 구분하세요.
문장을 수정하기 전에 읽기 장애 요소를 먼저 확인하고, 초역과 편집본을 대조해 조건의 적용 범위, 인과관계, 지표 및 인용의 연결을 재검토하세요.
각 항목에 원문, 현재 번역, 수정안 및 이유를 기록하고 수정 후 다시 확인하세요.이 모드는 실질적 오류와 표현상의 선호를 구분합니다. 예를 들어 단순히 uses를 adopts로 바꾸는 것이 반드시 기술적 문제를 의미하지는 않으므로, 모든 문체 차이를 오류로 등록해서는 안 됩니다.
3. 원문을 보호하면서 전체 번역하기
전체 모드는 용어와 시험 번역 결과를 확인한 후 사용하는 것이 적합합니다. 에이전트에 새 디렉터리에 결과를 납품하도록 요구하고 원문을 덮어쓰지 않도록 해야 합니다. 각 부분은 동일한 버전의 용어집과 연구 컨텍스트를 공유하며 본문, 그림 설명, 표, 수식 설명, 알고리즘 및 부록을 포함해야 합니다.
$sci-translation-skill을 사용해 확인된 용어집에 따라 전체를 번역하세요.
새 디렉터리에 납품하고 원문을 덮어쓰지 마세요. 모든 블록이 동일한 버전의 용어집과 연구 컨텍스트를 공유해야 합니다.
본문, 그림 설명, 표, 수식 설명, 알고리즘 및 부록을 포함하고, 마지막에 초록의 주장 범위를 확인하세요.
영문 원고, 용어집, 문단별 정렬, 교정 폐쇄 루프 기록 및 확인 대기 항목을 납품하세요.결정론적 검사 도구 사용
저장소는 번역에서 관찰 가능한 차이를 검사하는 로컬 스크립트를 제공합니다. 먼저 스킬 무결성 테스트를 실행합니다.
bash references/test-skill-integrity.sh그런 다음 원본 파일과 대상 파일에 번역 감사를 실행할 수 있습니다.
python3 scripts/audit_translation.py source.tex target.tex \
--glossary terminology-glossary.json \
--alignment alignment.json \
--output qa-report.json이 감사는 숫자, 보호된 구간, 인용 횟수, 기본 구조, 정렬 정보 및 등록된 용어를 검사할 수 있습니다. 기존 셸 진입점도 계속 사용할 수 있습니다.
bash references/test-translation-structure.sh source.tex target.tex glossary.json종료 코드의 의미는 다음과 같습니다.
0: 구현된 검사에서 차이가 발견되지 않았습니다.1: 추가 확인이 필요한 차이가 발견되었습니다.2: 입력 또는 파싱 오류입니다.
종료 코드가 0이라고 해서 번역문이 투고 가능한 상태에 도달했다는 의미는 아닙니다. alignment를 제공하지 않은 경우 문단별 범위 또는 용어 준수 검사를 완료했다고 주장할 수 없습니다. 일부 올바른 숫자 순서 또는 형식 조정도 차이를 일으킬 수 있으므로 수동으로 처리 결과를 기록해야 합니다.
이 스크립트는 “AI 느낌”을 검사하지 않으며 분야별 정확성을 인증하지도 않습니다. 결정론적 구조 차이를 발견하는 데 도움을 줄 뿐, 의미 검토, 수동 확인 또는 전문 인력의 최종 검토를 대체할 수 없습니다.
고급 실무 권장 사항
용어집 버전을 고정하고 문맥 기록하기
예시 용어집을 모든 논문에 그대로 적용하지 마세요. 프로젝트가 제공하는 예시 용어집은 필드 설명에만 사용되며 외부 검증을 거치지 않았습니다. 실제 프로젝트에서는 개념, 장 및 문맥에 따라 자체 용어 기록을 작성하고, 수정 후 영향을 받은 용어를 다시 확인해야 합니다.
충실성 기준과 언어 품질 구분하기
먼저 번역이 과학적 의미를 보존했는지 판단한 다음 문장이 자연스러운지 평가합니다. 발견된 오류가 0개라고 해서 자동으로 만점인 것은 아닙니다. 검사 범위가 제한적일 수 있고 아직 식별되지 않은 문제가 남아 있을 수 있기 때문입니다. 언어 편집 역시 더 화려한 표현으로 근거 부족을 가려서는 안 됩니다.
형식과 인용 연결 보호하기
번역을 시작하기 전에 구조 목록을 작성하고, 특히 수식, 매크로, 인용, 표 좌표, 그림 설명 및 부록을 기록합니다. 수정 후에는 숫자가 존재하는지만 확인하지 말고, 숫자가 여전히 올바른 지표, 단위 및 조건에 연결되어 있는지도 확인해야 합니다. 수식 개수가 같다고 해서 변수가 변경되지 않았다는 뜻은 아닙니다.
문제 번호별 폐쇄 루프 수정
각 문제에 안정적인 issue ID를 부여하고 원문, 현재 번역, 수정안, 이유 및 위치를 기록합니다. 수정이 완료되면 원문, 초역 및 편집본을 다시 대조하고, 특히 조건의 적용 범위, 인과관계, 지표, 인용 및 주장 강도를 재확인합니다.
프로젝트 파일 안내
SKILL.md: 스킬 진입점과 통과 조건.- 용어 계약: 통합 용어집 schema와 alignment 형식.
- 역할 계약: 실제 도구 및 파일 소유권 요구 사항.
- 언어 가이드: 충실하고 간결하며 자연스러운 표현.
- 독자 중심 편집: 장별 라우팅, 문장 내 부담, 연결성 및 편집 후 충실성 재검토.
- 분야별 설정: 분야별 주요 위험 요소.
- 행동 평가: 모델 행동 수용 계획.
- 번역 예시: 구성된 차이 사례이며, 발표된 성능 증거가 아님.
맺음말
sci-translation-skill의 가치는 논문 번역을 일회성 윤문에서 용어 고정, 충실한 초역, 독립 교정, 차이 검사 및 저자 확인을 포함하는 추적 가능한 프로세스로 전환하는 데 있습니다. pilot, review, 전체 납품 및 최종 감사 순서로 사용하면 기술적·형식적 위험을 더 일찍 발견할 수 있습니다.
그러나 이 도구는 분야별 정확성을 자동으로 인증하는 도구가 아니며, 과학적 결론에 대한 저자의 확인을 대체할 수 없습니다. 복잡한 형식, 의학 원고 및 투고를 준비 중인 모든 번역문은 렌더링 검사, 수동 검토 및 전문 인력의 최종 검토를 함께 진행해야 합니다.
