Paper Polisher

Paper Polisher은(는) 무엇을 하나요?

범위 및 참고

이 스킬은 TeX 안전 학술 영어 다듬기, 번역, 교정, 원천-출력 검증, 용어 또는 표기 검토, 수치 일관성 검토, 명시적으로 승인된 표기 정규화에 사용합니다.

전체 논문, 긴 섹션, 검증, 일관성 감사, 정규화 또는 엄격한 스타일 가이드 작업의 경우, 작업 전 references/tex_safe_polishing.md를 읽으십시오. 중국어 기반 워크플로 지침이 실질적으로 유용한 경우에는 대신 references/tex_safe_polishing_zh.md를 읽으십시오. 컨텍스트를 중복으로 로드하기 위해 둘 다 로드하지 마십시오. 짧은 지역 다듬기의 경우 아래 핵심 규칙을 사용하고 필요한 경우에만 참고 자료를 참조하십시오.

이 스킬을 다음의 주요 도구로 사용하지 마십시오:

• 참신성, 기여 방어 가능성, 위험 기준선 또는 리뷰어 공격 감사; 가능한 경우 idea-novelty-auditor를 사용하십시오.
• 문헌 검토, 격차 프레임, 참조 선택 또는 인용 역할 할당; 가능한 경우 problem-driven-literature-review를 사용하십시오.
• 광범위한 스토리라인, 서론 구조 또는 실험-주장 재설계; 가능한 경우 paper-argument-reconstructor를 사용하십시오.

요청이 이러한 작업과 다듬기를 결합하는 경우, 먼저 상위 추론 작업을 완료하고 최종 충실한 언어 및 일관성 패스에만 이 스킬을 사용하십시오.

모드 선택 및 우선 순위

입력을 누가 생성했는지 고려하기 전에 사용자의 명시적 요청 작업을 따르십시오. 출처만으로는 다듬기, 감사, 검증 또는 정규화에 대한 명시적 요청을 재정의하지 않습니다. 둘 이상의 작업이 요청된 경우, 사용자가 결합된 결과물을 요청하지 않는 한 해당 아티팩트와 보고서를 분리하여 유지하십시오.

모드별 출력 규칙은 문서 길이에 따른 출력 규칙보다 우선합니다. 특히, 전체 원고 검증 또는 일관성 전용 감사는 보고서 전용으로 유지됩니다.

사용자가 표기 정규화와 산문 다듬기를 모두 요청하는 경우, 먼저 정규화를 수행하고 승인한 다음, 정규화된 TeX를 새로운 기준선으로 처리하고 해당 기준선에 대해 다듬기를 수행하십시오. 결합된 산문 및 기호 변경을 하나의 정규화 비교로 검증하려고 시도하지 마십시오.

기본 다듬기 모드

제공된 텍스트를 모든 보호 요소를 유지하면서 다듬거나 번역하십시오. 전체 원고의 경우, 용어, 표기 및 소스 내 수치 일관성 감사도 실행하고 소스 수준 문제를 보고하되, 자동으로 수정하지는 마십시오.

검증 모드

사용자가 후보를 원본과 비교하거나 품질 검사하도록 요청할 때 검증 모드를 사용하십시오.

• TeX, 수학, 숫자, 단위, 부호, 인용, 기술적 의미 또는 주장 강도에 대한 모든 비교 판단에는 원본과 후보가 모두 필요합니다.
• 원본을 사용할 수 없는 경우, 후보의 고유 속성만 검사하고 모든 소스 비교 검사를 NOT ASSESSED로 표시하십시오. 후보만으로 보존을 추론하지 마십시오.
• 검증 모드에서는 엄격한 규칙 위반을 포함하여 후보를 다시 쓰거나 수리하지 마십시오. 각 편차와 위치를 보고하십시오. 별도의 명시적으로 요청된 편집 턴 또는 모드에서만 수정 사항을 적용하십시오.
• 후보에 도입된 편차를 소스에 이미 존재하는 용어, 표기 또는 수치 충돌과 분리하십시오.

일관성 감사 모드

사용자가 용어, 변수, 기호, 표기 또는 수치 일관성만 요청하는 경우, 원고를 다시 쓰지 마십시오. 사용 가능한 범위를 감사하고 해당되는 TERM-*, SYM-*, NUM-* 소견을 보고하십시오. 소스 텍스트, 기호, 값, 단위 및 부호를 변경하지 않고 유지하십시오.

승인된 표기 정규화 모드

사용자가 명시적으로 정규화를 요청하고 정확한 기호 매핑을 승인한 경우에만 이 모드를 사용하십시오. 승인된 매핑은 수학적 개체, 이전 및 새 기호, 영향을 받는 범위 또는 위치, 의도된 별칭 또는 제외 사항을 식별해야 합니다.

• 승인된 기호 대체만 적용하십시오. 사용자를 대신하여 정의를 재해석하거나 표준 기호를 선택하지 마십시오.
• 적용된 모든 대체를 AUTHORIZED CHANGE로 기록하십시오. 매핑되지 않은 모든 수학, 구조, 텍스트 또는 수치 차이를 오류로 처리하십시오.
• 모든 숫자, 단위, 백분율, 차원, 표본 크기, 숫자 토큰 순서 및 양수, 음수 또는 플러스-마이너스 부호를 변경하지 않고 유지하십시오.
• 영향을 받는 기호가 사용 불가능하거나 편집할 수 없는 그림 자산, 사용자 정의 환경, 생성된 파일 또는 해결되지 않은 매크로 확장 내에서 발생하는 경우, 해결되지 않은 위치를 보고하고 완전한 정규화를 주장하지 마십시오.
• 정규화된 결과를 승인된 매핑에 대해 검증하십시오. 매핑 인식 비교를 사용할 수 없는 경우, 정규화된 TeX를 새로운 저자 승인 기준선으로 승인한 다음, 모든 후속 다듬기에 대해 해당 기준선에 대한 엄격한 비교를 사용하십시오.

--allow-additions를 사용하여 기호 변경을 승인하지 마십시오. NUM-* 충돌을 보고한 후에도 이 페이퍼-폴리셔 모드에서 숫자, 단위 또는 수치 부호를 수정하지 마십시오. 사용자에게 이 스킬 외부에서 소스를 수정하고 수정된 TeX를 새로운 저자 승인 기준선으로 제공하도록 요청하십시오. 대체 값을 추론하거나 적용하지 마십시오.

공유 범위 및 결과 프로토콜

모든 용어, 표기 및 수치 일관성 감사에 대해 범위와 결과를 별도로 보고하십시오.

• Coverage: FULL MANUSCRIPT는 아래 완전성 게이트가 통과되었음을 의미합니다.
• Coverage: PARTIAL는 명시된 로컬 또는 해결 가능한 범위만 감사되었음을 의미합니다.
• Result: PASS는 평가된 범위 내에서 충돌 또는 해결되지 않은 모호성이 발견되지 않았음을 의미합니다.
• Result: ISSUE REPORTED는 적어도 하나의 명확한 불일치가 발견되었고 저자의 결정이 여전히 필요한 소견이 없음을 의미합니다.
• Result: AUTHOR DECISION REQUIRED는 원고만으로는 해결할 수 없는 적어도 하나의 그럴듯한 소견이 있음을 의미합니다. 확인된 문제는 개별적으로 ISSUE REPORTED로 레이블이 지정됩니다.
• Result: NOT ASSESSED는 해당 감사 또는 비교를 전혀 수행할 수 없음을 의미합니다. 범위가 부분적이라는 이유만으로 사용하지 마십시오.

결정적 소견 식별자를 루트 상대 파일 및 소스 순서로 할당하십시오: TERM-001, SYM-001, NUM-001. 파일을 사용할 수 있는 경우 각 소견에 정확한 파일 및 줄 위치를 제공하십시오. 그렇지 않으면 사용 가능한 가장 안정적인 섹션, 방정식, 표, 알고리즘, 캡션 또는 인용된 텍스트 앵커를 사용하십시오.

확인된 불일치에는 ISSUE REPORTED를 사용하십시오. 증거가 비교된 사용이 동일한 개체, 개념, 수량 또는 실험 조건을 참조하는지 또는 그 차이가 의도적인지 여부를 확립할 수 없을 때 AUTHOR DECISION REQUIRED를 사용하십시오. 충돌 확실성을 수정 조치와 분리하십시오: 확인된 충돌은 저자가 여전히 대체 용어, 기호 또는 값을 선택해야 하는 경우에도 ISSUE REPORTED로 유지됩니다.

전체 원고 완전성 게이트

다음이 모두 참인 경우에만 FULL MANUSCRIPT 범위를 주장하십시오:

1. 권위 있는 루트 TeX 파일을 식별하고 문서 순서로 정적으로 도달 가능한 모든 \input, \include, \subfile, \import 및 동등한 포함 항목을 해결합니다.
2. 누락된, 조건부, 매크로 생성, 생성된 또는 순환 포함 항목과 표기를 포함하는 모든 부록 또는 보충 자료를 설명합니다.
3. 표기를 생성하는 사용자 매크로 및 사용자 정의 수학 환경을 검사합니다. 보존 스크립트 패스에 의존하여 이를 확장하거나 이해하지 마십시오.
4. 산문, 방정식, 알고리즘, 캡션, 표 및 제공된 그림 자산의 표기 및 수치 주장을 검사합니다. 자산이 관련 포함 텍스트를 포함하지만 검사할 수 없는 경우, 범위는 부분적입니다. 정규화가 그림에 영향을 미치지만 편집 가능한 소스를 사용할 수 없는 경우, 정규화는 불완전합니다.
5. 소견에 대한 루트 상대 파일 및 줄 위치를 유지하고 요청된 범위가 건너뛰어지지 않았는지 확인합니다.

어떤 조건이 실패하면, 적용 범위 격차를 명시하고 Coverage: PARTIAL을 사용하십시오. 완전한 파일 업로드만으로는 완전한 분석 범위가 설정되지 않습니다.

절대 규칙

• TeX 구조, 환경, 인용, 레이블, 참조, 참고 문헌 키, 함수 이름, 모듈 이름, 데이터 세트 이름, 메트릭 이름 및 기술적 의미를 유지하십시오.
• \label{...}, \ref{...}, \eqref{...}, \includegraphics{...}, 인용 명령, \bibitem{...} 및 BibTeX 키와 같은 구조적 명령 내의 정확한 인수와 키를 유지하십시오. 이름을 바꾸거나, 병합하거나, 삭제하거나, 재정렬하거나, 정규화하지 마십시오.
• 주석과 리터럴 또는 코드 유사 소스( comment, verbatim, listing 환경 및 인라인 리터럴 명령 포함)를 모든 모드에서 정확한 보호 소스로 처리하십시오. 산문을 이러한 영역 안팎으로 이동하거나, 인라인 주석을 전체 줄 주석으로 변경하거나, 보호된 수학 또는 TeX 구조를 가로질러 이동하지 마십시오.
• 다듬기, 번역, 산문 추가 및 검증 중에 모든 원래 수학 영역과 문서 순서를 유지하십시오. 유일한 예외는 저자가 승인한 표기 매핑에 나열된 정확한 대체입니다.
• 다듬기, 번역, 산문 추가, 검증, 일관성 감사 및 표기 정규화 중에 모든 숫자, 단위, 백분율, 차원, 매개변수, 표본 크기, 표 값, 그림 보고 값, 유의성 표시, 숫자 토큰 순서 및 양수, 음수 또는 플러스-마이너스 부호를 유지하십시오. 여기에는 식별자에 포함된 숫자와 주석, 리터럴 예제, URL 또는 보호된 명령 인수 내부의 숫자 토큰이 포함됩니다. 이 스킬에는 숫자 편집 예외가 없으며, --allow-additions는 이 규칙을 완화하지 않습니다.
• 원천-출력 보존과 원천 내 일관성을 별도의 검사로 취급하십시오. 원천 내 용어, 기호, 값, 단위 또는 부호 충돌은 편집 권한이 아닌 소견입니다.
• 이 스킬에서 의심스러운 값을 절대 수정하지 마십시오. NUM-* 소견을 보고한 후, 사용자에게 외부에서 소스를 수정하고 저자 승인 기준선을 반환하도록 요청하십시오.
• 수학적 정의, 정리 조건, 증명 논리, 알고리즘 단계, 실험 설정, 보고된 결과, 기준선 또는 데이터 세트를 변경하지 마십시오.
• 이 스킬에서 참고 문헌 레코드 또는 식별자를 수정하지 마십시오. 참고 문헌 정리 요청은 다른 보호 규칙과 충돌하지 않는 비숫자, 비식별자 메타데이터 편집만 승인할 수 있습니다. 연도, 페이지, 권, 호, DOI/URL/arXiv 식별자 및 기타 모든 숫자 토큰은 paper-polisher 외부에서 수정하고 저자 승인 기준선으로 반환해야 합니다.
• 주장, 실험, 보증, 배포 가치, 한계 또는 결론을 발명하지 마십시오.
• 단순한 스타일 다양성을 위해 기술 용어를 변경하지 마십시오. 개체 매핑이 지원되는 경우에만 표준 용어를 사용하십시오.
• 보호된 내용을 변경하지 않고 문장 시작, 절 순서, 음성, 전환 및 단락 구조의 기계적 반복을 피하십시오.
• 저자가 작성한 원고 산문에서 대시 구두점을 사용하지 마십시오. 어휘 하이픈, 수학 빼기 부호, 부호 값, 보호된 키, URL, DOI 문자열, 파일 이름, 인용 키 및 참고 문헌 메타데이터를 정확하게 유지하십시오.

요청된 편집이 이러한 규칙을 위반하고 정확한 승인된 매핑으로 해결되지 않는 경우, 해당 편집을 중단하고 누락된 권한 또는 소스 정보를 보고하십시오. 초안이 규칙을 위반하는 경우, 반환하기 전에 수정하십시오.

워크플로

1. 사용자의 명시적 의도에서 모드를 선택하고 제공된 범위를 식별합니다.
2. 전체 원고 작업의 경우, 완전성 게이트를 적용하고 해결된 문서 순서를 유지합니다.
3. 관련 원장을 구축합니다:
   • 용어: 개체, 표준 용어, 허용된 문맥 형태, 정의 및 위치;
   • 표기: 수학 개체, 기호, 정의 및 용도, 범위, 유형 또는 차원, 프레임 및 별칭;
   • 수치: 측정 또는 구성된 수량, 값, 단위, 부호, 조건, 소스 위치 및 일치하는 산문/표/그림 사용.
4. 다듬기 모드에서, 보호된 수학 및 숫자 토큰 순서를 고정하면서 산문을 수정합니다. 절이나 문장을 재정렬하는 것은 보호된 수학, 숫자, 단위 또는 부호를 재정렬하지 않는 경우에만 허용됩니다.
5. 양방향 일관성 검사를 실행합니다: 개체에서 용어 또는 기호로, 용어 또는 기호에서 개체로, 수량 또는 실험 조건에서 보고된 값, 단위 및 부호로.
6. 평가된 범위에 걸쳐 문장 구조, 대시 없는 산문, 객관적인 어조 및 주장 경계 검사를 실행합니다.
7. 원본 및 후보 파일을 사용할 수 있는 경우, 보존 검사기를 실행합니다. 다중 파일 원고의 경우 프로젝트 모드를 사용하십시오.
8. 모드별 출력을 반환하고 승인된 변경, 소스 수준 소견, 후보 도입 편차 및 평가되지 않은 검사를 구분합니다.

보존 검사기

하나의 원본 및 후보 TeX 파일에 대해 엄격한 비교를 실행합니다:

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex

사용자가 일반 산문 추가를 승인한 경우에만 --allow-additions를 사용하십시오:

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex --allow-additions

이 옵션은 새로운, 삭제된, 변경된 또는 재정렬된 구조적 키, 수학 영역, 숫자 토큰, 단위 또는 부호를 허용하지 않습니다. 인식된 주석 및 리터럴 또는 코드 유사 영역은 인라인-대-전체-줄 주석 경계 및 보호된 수학 및 TeX에 대한 순서를 포함하여 정확한 보호 소스로 유지됩니다. 사용자 정의 또는 인식되지 않은 리터럴 매크로를 수동으로 비교하십시오. 새로운 그림, 표, 방정식, 참조, 이미지 자산 또는 기호 매핑을 승인하지 않습니다. 의도적인 보호된 구조적 변경을 위한 저자 승인 기준선을 설정하거나, 수치 내용을 paper-polisher 외부에서 수정해야 했을 때 외부에서 수정되고 저자가 승인한 TeX를 새 기준선으로 사용하십시오.

다중 파일 원고의 경우, 두 권위 있는 루트 TeX 파일을 전달하고 프로젝트 탐색을 활성화하십시오:

python3 paper-polisher/scripts/check_preservation.py original/main.tex candidate/main.tex --project

프로젝트 모드는 각 루트에서 정적으로 도달 가능한 \input, \include, \subfile, \subfileinclude, \import, \subimport, \inputfrom, \subinputfrom, \includefrom 및 \subincludefrom 지시문을 현재 및 프로젝트 루트 상대 경로를 포함하여 해결합니다. TEXINPUTS 또는 BIBINPUTS 환경 변수에 의해 도입된 동적으로 확인된 포함 또는 조회는 지원되지 않습니다.

보존 검사기에 의존하여 표기 정규화를 검증하지 마십시오. 대신 매핑 인식 정규화 비교를 수행하거나 승인된 기준선에 대한 엄격한 비교를 사용하십시오.

허용 파일 연산

다음 파일 연산이 허용됩니다:

• auxiliary.tex – 포함된 보조 자료를 편집 가능한 원고의 일부로 처리합니다. 이를 자체 루트 파일로 취급합니다.
• references.bib – 참고 문헌 정리가 명시적으로 요청되고 외부 수정이 필요한 참고 문헌 메타데이터에만 영향을 미치는 경우, 숫자 토큰을 편집하지 않고 용어 및 표기 감사에 필요한 인용 키를 수집합니다. 연도, 페이지, 권 번호를 변경하거나 식별자를 수정하지 마십시오.
• figures/* – 포함된 그림 자산은 내장 텍스트에 대해 검사되지만 편집 가능한 소스를 사용할 수 없는 경우 수정되지 않습니다. 포함된 그래픽 내의 표기는 부분적으로만 감사할 수 있습니다.
• tables/* – 포함된 표 파일은 모든 감사 모드에서 완전히 검사됩니다.
• .bib 이상의 파일 확장자는 명시적인 권한 없이 편집되지 않습니다.