Academic DeAI가 하는 일
Academic DeAI는 중국어 및 영어 학술 문장을 편집하는 스킬입니다. 원고의 사실, 인용, 용어, 부정 표현, 근거의 강도, 인과관계에 대한 한정, 저자의 문체는 유지하면서 내용 없는 서론적 표현, 반복적인 구조, 템플릿 같은 언어를 제거합니다.
이 프로젝트는 교정, 문장 다듬기, 학술 번역, 사용자가 승인한 구조 수정 작업을 지원합니다. 주요 범위에는 일반적인 이메일, 블로그 또는 마케팅 문구가 포함되지 않습니다.
Academic DeAI는 AI 모델을 선택하거나 모델 API를 호출하거나 다른 편집기를 자동으로 연쇄 실행하지 않습니다. 호환되는 호스트 내에서 실행되는 편집 스킬입니다. 버전 3.0.0은 최신 GPT-6 스킬 지침을 따르며 Humanizer 3.1.0의 맥락 기반 편집 아이디어를 참고하지만, 모든 GPT-6 체크포인트에서 동일한 성능을 보장한다고 주장하지는 않습니다.
맥락 기반 학술 편집이 중요한 이유
학술 문장에는 근거를 추가하지 않으면서 강조만 더하는 표현이 자주 포함됩니다. Academic DeAI는 주변 맥락이 변경을 뒷받침하는 경우에만 이러한 표현을 제거하는 것을 목표로 합니다. 개별 단어를 원치 않는 패턴으로 처리하기 전에 구조와 의미를 평가합니다.
예를 들어 다음과 같은 가상의 중국어 문단을 살펴보겠습니다.
주목할 점은 본 연구가 126명의 환자를 대상으로 횡단면 분석을 실시한 결과, 수면의 질 점수와 가려움증 중증도 점수가 상관관계를 보였다는 것이다(r=0.32, P=0.01). 이 발견은 두 변수 사이의 복잡한 연관성을 밝혀냈을 뿐만 아니라 향후 연구에도 중요한 시사점을 제공한다.
가능한 수정문은 다음과 같습니다.
본 연구는 126명의 환자를 대상으로 횡단면 분석을 실시하여 수면의 질 점수와 가려움증 중증도 점수가 상관관계를 보인다는 사실을 확인했다(r=0.32, P=0.01).
수정문은 일반적인 서론적 표현을 제거하면서 연구 설계, 표본 수, 변수, 상관계수 및 P값을 유지합니다. 이 짧은 예시는 편집 방식을 보여 주기 위한 것이며, 벤치마크 비교가 아닙니다.
주요 기능
- 중국어 및 영어 편집: 사용자가 요청한 수준에 맞춰 어느 언어로든 학술 문장을 수정합니다.
- 학술 번역: 제공된 용어, 문체 샘플, 구조적 요구사항 및 분량 제한을 따르면서 원고를 번역합니다.
- 주장 보존: 원문 주장 수준에서 행위자, 대상, 방향, 시간, 조건 및 인용의 연결을 검토합니다.
- 근거를 고려한 수정: 불확실성, 부정, 인과관계에 대한 한정, 범위, 부정적 결과 및 필요한 비교를 유지합니다.
- 구조를 고려한 편집: 국소적인 표현을 다듬기 전에 원고의 구성을 고려합니다.
- 문체 지침: 저자 샘플을 표현 방식의 지침으로 활용하되, 해당 샘플에서 새로운 사실을 가져오지 않습니다.
- 유연한 실행: 요청이 이미 충분히 구체적인 경우 의무적인 수정 횟수나 필수 보고서를 요구하지 않습니다.
- 선택적 리소스 로딩: 작업과 관련된 경우에만 참고 자료와 도구를 불러옵니다.
사전 요구사항
스킬을 지원하고 해당 호스트에 유효한 스킬 위치가 설정된 호스트가 필요합니다. 현재 Codex 문서에는 사용자 수준 스킬 위치로 ~/.agents/skills, 저장소 수준 스킬 위치로 .agents/skills가 기재되어 있습니다. 기존 환경에서는 다른 설정 위치를 사용할 수 있으므로 호스트의 문서를 따르세요.
Python 3.10 이상은 포함된 텍스트 유틸리티와 검증 명령을 사용할 때만 필요합니다. 이러한 유틸리티는 콘텐츠와 패키지 동작을 검사하며 문장을 생성하거나 다시 작성하지 않습니다.
Academic DeAI 설치
사용자용 신규 설치
저장소를 다운로드할 디렉터리에서 다음을 실행하세요.
git clone https://github.com/heise3/academic-deai.git
mkdir -p ~/.agents/skills
cp -R academic-deai ~/.agents/skills/academic-deai저장소 폴더 전체를 복사하세요. 패키지는 상대 경로 참조를 사용하고 선택적 스크립트를 포함하므로 SKILL.md만 복사하지 마세요.
대상 위치가 아직 존재하지 않을 때만 복사 명령을 사용하세요. 설치한 후 호스트의 스킬 목록을 다시 여세요. Academic DeAI가 표시되지 않으면 Codex 또는 해당 호스트를 재시작하세요.
저장소 수준 설치
호스트가 저장소 스킬을 지원하는 경우 전체 패키지를 저장소의 설정된 스킬 디렉터리(일반적으로 .agents/skills)에 배치하세요. 파일을 복사하기 전에 정확히 지원되는 경로를 확인하세요.
기존 설치 업그레이드
업그레이드하기 전에 설치된 Academic DeAI 디렉터리를 백업하세요. 기존 폴더를 의도적으로 교체하고, 이전 릴리스의 확인되지 않은 파일을 병합하지 마세요. 이렇게 하면 오래된 참조, 스크립트 또는 구성 파일이 패키지에 남는 것을 방지할 수 있습니다.
현재 호스트별 설치 지침은 공식 스킬 문서를 참조하세요.
기본 사용법
중국어 학술 섹션 수정
스킬을 지정하고 섹션과 언어를 명시하며, 변경하지 말아야 할 내용을 나열하고 원하는 출력 형식을 밝혀 주세요.
Use $academic-deai to revise this Chinese discussion section.
Keep every substantive claim, citation, number, and causal qualification.
Return only the edited text.지시문 뒤에 토론 섹션을 붙여 넣으세요. 최종 문장은 원고에 바로 삽입할 수 있는 텍스트가 필요할 때 추가 설명이 나오지 않도록 합니다.
원고를 영어로 번역
번역할 때는 명시적인 구조 제약과 함께 용어 및 문체 참고 자료를 제공하세요.
Use $academic-deai to translate this manuscript into English.
Use the terminology list and my writing sample below.
Preserve the requested section structure and minimum length.용어 목록을 사용하면 분야별 용어의 번역을 일관되게 정할 수 있습니다. 문체 샘플은 문체를 안내할 수 있지만 새로운 사실의 출처로 취급해서는 안 됩니다.
통제된 구조 수정 요청
Academic DeAI는 사용자가 권한을 부여하면 구조적 수정을 수행할 수 있습니다. 변경해도 되는 내용과 반드시 고정해야 하는 내용을 정의하십시오. 예:
$academic-deai를 사용하여 이 영어 결과 섹션을 수정하십시오.
문단 순서와 전환을 개선하되, 모든 제목,
통계, 비교, 부정적 결과, 인용 및 한정 표현은 그대로 유지하십시오.
수정된 섹션만 반환하십시오.이 지시는 허용된 구성상의 변경과 보호해야 할 실질적 내용을 구분합니다. 요청된 경우 필수 제목과 필요한 수동태 방법 서술을 포함한 의미 있는 방법론적 표현은 유지해야 합니다.
패키지 검증
저장소 루트에서 패키지 검증기를 실행하십시오:
PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_package.py .검증기는 패키지 구조, 참조, 버전 정보 및 이식 가능한 파일을 확인합니다.
다음 명령으로 단위 테스트를 실행하십시오:
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests -v테스트는 포함된 도구의 관찰 가능한 동작을 다룹니다. 검증과 테스트를 통과했다고 해서 편집 품질, 의미적 동등성, 저자성 또는 탐지기 성능이 입증되는 것은 아닙니다.
콘텐츠 잠금으로 두 텍스트 파일 확인
콘텐츠 잠금 유틸리티를 사용하여 원본 문서와 수정본을 비교할 수 있습니다:
python3 scripts/content_lock.py original.md revised.md --strict이 유틸리티는 검증 과정의 일부이며 텍스트 생성기가 아닙니다. 모든 의미와 주장이 보존되었다는 증명이 아니라 보조 수단으로 결과를 해석하십시오.
PDF 및 DOCX 원본 사용
PDF 텍스트 추출에는 Poppler의 pdftotext가 추가로 필요합니다. PDF 추출에 의존하기 전에 해당 명령이 설치되어 있고 환경에서 사용할 수 있는지 확인하십시오.
DOCX 추출은 본문 XML을 읽지만 모든 스타일, 주석, 변경 내용 추적, 각주 또는 텍스트 상자를 보존하지는 않습니다. 이러한 문서 기능이 중요하다면 문서 처리 기능을 갖춘 도구를 사용하고 편집 가능한 Word 파일을 직접 확인하십시오.
신뢰할 수 있는 편집을 위한 고급 팁
보호할 내용을 명시적으로 정의
이 글을 더 자연스럽게 다듬어 주세요와 같은 일반적인 요청에 의존하지 마십시오. 주장, 숫자, 인용, 용어, 부정, 불확실성, 시간 범위, 조건 및 인과 강도를 포함하여 변경할 수 없는 요소를 명시하십시오.
허용되는 편집 수준을 명시
교정과 더 깊은 수정을 구분하십시오. 교정에서는 변경을 문법과 표현으로 제한하십시오. 구조 편집에서는 문단 재배열, 전환 변경 또는 중복되는 서술의 삭제를 명시적으로 허용하십시오.
근거의 강도를 보호
기술이 연관성과 인과관계, 가능성과 확실성, 근거의 부재와 부재의 근거를 구분하여 유지하도록 요청하십시오. 부정적 결과와 한정된 결론은 문체상 약해 보일 수 있지만 과학적으로 필수적일 수 있습니다.
인용을 올바른 주장에 연결
문장 경계나 문단 구조를 수정할 때 각 인용이 뒷받침하는 명제에 계속 연결되어 있는지 확인하십시오. 하나의 긴 문장을 여러 개의 짧은 문장으로 나눌 때 특히 중요합니다.
용어 목록 제공
다국어 원고나 전문 원고의 경우 선호하는 번역, 약어, 대문자 표기 및 변경하지 않아야 하는 용어를 제공하십시오. 이렇게 하면 편집자가 해당 분야의 관례를 추측하지 않고도 일관성을 줄일 수 있습니다.
저자 샘플은 신중하게 사용
대표적인 글쓰기 샘플은 문장 길이, 격식 수준 및 선호하는 표현을 안내할 수 있습니다. 해당 샘플은 스타일 참고 자료일 뿐이며 편집된 원고에 사실, 인용 또는 주장을 추가하는 데 사용해서는 안 된다고 명시하십시오.
필수 형식을 유지
학술지, 기관 또는 지도교수가 제목, 최소 분량, 섹션 순서 또는 보고 문구를 요구한다면 프롬프트에 해당 제약 조건을 포함하십시오. Academic DeAI는 지시를 받으면 필수 제목과 구조를 유지하도록 설계되었습니다.
결과를 수동으로 검토
편집 후 주장 단위로 수정본을 원본과 비교하십시오. 각 행동을 수행한 주체, 측정한 내용, 각 결과의 방향, 해당 시간 범위와 조건, 인과적 표현, 수치 및 인용 위치를 확인하십시오.
중요한 제한 사항
- Academic DeAI는 모델을 선택하거나 모델 API를 호출하지 않습니다.
- 포함된 도구는 텍스트를 작성하거나 다시 쓰지 않습니다.
- 검증은 의미적 동등성이나 편집 품질을 입증하지 않습니다.
- DOCX 추출은 모든 문서 기능을 보존할 수 없습니다.
- 프로젝트의 설계 지침은 모든 GPT-6 체크포인트에 대한 벤치마크를 보장하지 않습니다.
- 이 기술을 설치해도 원격 Git 저장소가 생성되거나 수정되지 않습니다.
결론
Academic DeAI는 근거를 의도적으로 약화하거나 실질적 주장을 변경하지 않으면서 중국어와 영어 학술 문장을 다듬고 번역할 수 있는 구조화된 방법을 제공합니다. 전체 패키지를 설치하고, 정확한 편집 범위를 제시하며, 분야별 용어를 보존하고, 각 수정본을 원본과 수동으로 비교하십시오. 이 프로젝트는 MIT 라이선스로 제공됩니다.