Communitygithub.com

lucas-langlois/과학자-주도-글쓰기

과학 보고서 및 저널 원고를 과학자가 직접 해석하고, 섹션 및 단락 검토, 절제된 교정, 제공된 보고서나 저널 템플릿 서식 지정, 자동 Word 번호 매기기 및 상호 참조, EndNote 필드 보존, 변경 내역 검토 가능 기능을 통해 개선합니다. 초안 작성, 수정, 캡션, 참고문헌 또는 제출 확인에 사용하며, 선택적 NESP 프로필이 포함되어 있습니다.

과학자-주도-글쓰기란 무엇인가요?

이 스킬은 과학자가 자신의 연구 결과를 명확하고 정확하게 전달할 수 있도록 돕는 기술 문서 작성 및 편집 도구입니다. 핵심은 과학자의 과학적 결정과 해석 권한을 존중하면서, 편집 및 문서 형식과 관련된 반복적이고 번거로운 작업을 대신 처리해 주는 데 있습니다. 워드 프로세싱 자동화, 템플릿 기반 서식 지정, EndNote 참고문헌 관리, 변경 사항 추적 등 다양한 기능을 제공하여 원고의 완성도를 높입니다. 특히 NESP(국가환경과학프로그램) 보고서 작성을 위한 선택적 프로필을 포함하고 있어, 환경 및 생태학 관련 연구자에게 유용합니다. 제공된 원고나 자료를 분석하여 감사(Audit), 서식 및 교정(Format and proofread), 수정(Revise), 증거 기반 초안 작성(Draft from evidence) 등 요청된 작업 모드를 추론하고, 필요한 경우에만 최소한의 질문을 통해 과학자와 협업합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lucas-langlois/skills/tree/main/skills/scientist-led-writing

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

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

문서

과학자 주도 글쓰기 (Scientist Led Writing)

과학자가 자신의 연구를 전달할 수 있도록 돕습니다. 지루한 편집 및 문서 작업은 대신 처리하고, 과학적 결정은 과학자에게 명확히 귀속되고 투명하게 유지합니다. 유창한 산문을 제안으로 취급하고, 증거로 취급하지 마십시오.

범위 선택

요청된 모드를 추론하여 간략히 명시하십시오:

  • 감사 (Audit): 원본을 보존하고, 문제점을 식별하며 구체적인 수정안을 제안합니다.
  • 서식 지정 및 교정 (Format and proofread): 문서의 기계적 오류와 의미를 보존하는 표현을 수정한 사본을 만듭니다.
  • 수정 (Revise): 구성을 개선하고 산문을 다듬으며, 의미 변경 사항을 저자가 결정할 수 있도록 공개합니다.
  • 증거 기반 초안 작성 (Draft from evidence): 제공된 노트, 결과 및 검증된 출처로부터 산문을 구성하고, 누락된 입력 사항을 명시적으로 표시합니다.

유용하고 허가된 작업을 즉시 수행하십시오. 다음 섹션에 실질적으로 영향을 미치는 소수의 질문만 하십시오. 누락된 해석이 철자, 스타일, 캡션 또는 증거 목록 작성을 방해해서는 안 됩니다. 초안을 완성하기 위해 결과를 조작하지 마십시오.

올바른 지침 로드

  1. 제공된 실제 보고서 또는 저널 템플릿과 현재 대상 학술지의 지침을 읽으십시오. 모든 템플릿을 사용할 수 있습니다. NESP는 필수 사항이 아닙니다. NESP 작업의 경우에만 선택적 2026 프로필을 읽고 과학자의 현재 승인된 템플릿을 사용하십시오. 기관 템플릿은 이 공개 스킬과 함께 배포되지 않습니다. 해당 프로필은 검사된 하나의 2026 템플릿을 설명합니다. 동일하다고 가정하지 말고, 더 최신 버전이나 프로젝트별 대체 템플릿을 확인하십시오. 게시된 보고서는 예시일 뿐, 규칙이 아닙니다. 템플릿이 없어도 레이아웃에 의존하지 않는 증거 검토나 교정을 막을 수는 없습니다. 적절한 경우 대상 학술지 지침이나 기존 문서 구조를 사용하십시오.
  2. 초안 작성 또는 구조적 수정을 위해 섹션 및 단락 지침을 읽으십시오.
  3. DOCX 또는 해당 인용을 편집하기 전에 Word 및 EndNote 처리를 읽으십시오. 가능한 경우 호스트의 문서 및 PDF 스킬을 사용하십시오.
  4. 산문 변경, 그림 확인 및 검토 패키지를 위해 편집 검토를 읽으십시오.
  5. 상위 아이디어 및 기본 문서를 위해 출처 및 출처 증명을 참조하십시오. 상위 스킬, 유료 서비스, 네트워크 설치 또는 인용 변환기는 필수 런타임 종속성이 아닙니다.

레이아웃과 식별을 위해 정확한 템플릿을 사용하고, 내용을 위해 저자와 증거를 사용하십시오. 충돌하는 템플릿 지침을 조용히 정규화하지 말고 기록하십시오.

번들 경로는 원고의 작업 디렉터리가 아닌 이 SKILL.md를 기준으로 확인하십시오. 제공된 Word 템플릿의 프로젝트 사본으로 작업하고, 원본은 변경하지 않은 채로 두십시오. 선택적 감사는 Python 3와 표준 라이브러리만 필요로 합니다. Windows에서는 사용 가능한 Python 실행기(python 또는 py -3)를 사용하고, 공백이 포함된 경로는 따옴표로 묶으십시오. 이 스킬은 Word, EndNote 또는 문서 렌더링 엔진을 설치하거나 제공하지 않습니다. 사용 가능한 호스트 도구를 사용하고 어떤 기본 검사가 남아 있는지 명확히 명시하십시오.

1. 저자의 기여 확립

질문하기 전에 초안과 자료를 검사하십시오. 저자 브리핑을 미리 채우고, 첫 번째 라운드에서는 최대 3개의 가치 있는 질문을 하십시오. 대략적인 글머리 기호, 구술 노트 및 불완전한 문장을 수용하십시오.

과학자 자신의 언어로 된 주요 메시지, 그들이 가장 중요하게 생각하는 해석과 한계, 그리고 의도된 청중이나 결정에 우선순위를 두십시오. 초안이 제공하지 않는 경우에만 대표 단락을 요청하여 어조를 파악하십시오. 필요할 때 정확한 방법, 그림, 표 및 관련 참고 문헌 기록을 확보하십시오.

제공된 관찰 결과, 분석 출력, 게시된 증거, 저자 해석 및 에이전트 제안을 구별하십시오. 이전 대화의 결과를 현재 원고 증거로 재사용하기 전에 출처와 범위를 확인하지 않고 사용하지 마십시오.

새롭거나 실질적으로 변경된 주장, 논쟁이 있는 진술 및 주요 숫자에 대해 간결한 증거 원장을 구축하십시오. 모든 문법 수정에 대해 기록을 만들지 마십시오. 주장을 파일, 표, 스크립트 출력, 참고 문헌 또는 저자 응답에 연결하고 정확히 무엇을 뒷받침하는지 식별하십시오. 접근할 수 없는 논문은 확인되지 않은 상태로 표시하고, 올바른 DOI만으로는 주장을 확인할 수 없습니다.

2. 작업 문서 보호

원본은 건드리지 않고 명확하게 이름이 지정된 사본에서 작업하십시오. 기존 주석과 변경 내용 추적을 유지하십시오. DOCX 편집 전에 Python을 사용할 수 있으면 번들된 읽기 전용 감사를 실행하십시오:

python "<스킬-루트>/scripts/audit_docx.py" "<프로젝트>/original.docx" --json "<프로젝트>/audit-before.json"

템플릿 ID, 문서 해시, 사용 가능한 Word/EndNote 도구, 수정 상태 및 기준 결함을 기록하십시오. 감사는 제한된 구조적 검사입니다. Word를 렌더링하거나 과학적 주장 또는 라이브 EndNote 작동을 검증하지 않습니다.

가능한 경우 기본 Word 편집을 사용하십시오. 그렇지 않으면 테스트된 OOXML/문서 워크플로를 통해 필드 범위 외부에서 최소한의 편집을 수행하십시오. 전체 필드가 포함된 단락이나 표 셀을 덮어쓰거나, 참조를 평문으로 변환하거나, 라이브 EndNote 마스터를 평문으로 왕복시키지 마십시오. 안전한 편집이 불가능한 경우, 고정된 제안을 제공하고 영향을 받지 않은 작업을 완료하십시오.

3. 다듬기 전에 구조 해결

역방향 개요를 만드십시오: 섹션 목적, 각 단락의 역할, 사용된 증거, 다음 단락으로의 연결. 결과 순서를 질문/목표와 일치시키십시오. Methods가 보고된 분석을 설명하도록 만드십시오. 관찰과 해석을 분리하십시오. 더 큰 재구성은 간단한 근거와 함께 제안하고, 비교를 위해 원래 표현을 보존하십시오.

새 문서의 경우, 섹션 계획을 만들고 지원 자료를 채우십시오. 뒷받침되지 않는 과학적 주장은 명확하게 식별된 저자 질의로 보류하십시오. 유용한 경우 내부 작업 초안을 자리 표시자와 함께 사용하고, 제출 준비가 되었다고 설명하지 마십시오.

명확한 요점, 증거 또는 세부 사항, 그리고 관련성에 대한 설명을 중심으로 단락을 작성하십시오. 그 패턴을 자연스럽게 다양하게 만드십시오. 논리적 관계가 뒷받침되는 경우에만 전환을 사용하십시오. 산문을 부드럽게 만들기 위해 메커니즘, 확실성 또는 인과적 다리를 발명하지 마십시오.

4. 비례하여 편집

과학자의 어휘, 학문적 등록, 불확실성 및 어조를 보존하십시오. NESP의 경우 달리 지시하지 않는 한 호주 영어를 사용하고, 저널 모드에서는 저널의 언어 규칙을 따르십시오.

부풀려진 참신함, 일반적인 중요성, 뒷받침되지 않는 확실성, 반복적인 요약, 빈 전환, 장식적인 전문 용어, 확립된 용어에 대한 동의어 변경 및 채팅 잔재를 표시하십시오. 각각을 문맥에 따라 판단하십시오. 단어 선택을 AI 저작권의 증거로 취급하거나, 문서가 인간이 작성했음을 점수화하거나, 탐지기 회피를 약속하거나, 가짜 성격을 추가하지 마십시오.

값, 단위, 과학적 이름, 부정적 결과, 비교 방향, 샘플링 단위 및 범위를 그대로 유지하십시오. 연구가 확립하는 바를 변경하는 더 짧은 문장은 교정 수정이 아니라 과학적 변경입니다. 결정 등록부에 기록하십시오.

원격 탐사 및 생태학 작업의 경우, 매핑된 미탐지가 지원 없이 실제 부재로 불리지 않는지, 이미지 해상도가 위치 정확도가 아닌지, 검증이 주장된 단위 및 지리와 일치하는지, 정확도 지표와 임계값이 명명되었는지, 반복된 타일이 독립적인 사이트로 취급되지 않는지 확인하십시오. 설계 정보가 누락된 경우, 오류를 주장하기보다는 질의를 제기하십시오.

5. 문서 메커니즘을 실제로 만들기

  • 입력된 제목 번호 대신 템플릿 단락 스타일과 다단계 제목 번호 매기기를 사용하십시오.
  • 실제 SEQ 캡션 필드와 캡션 스타일을 사용하십시오. NESP의 경우, 캡션을 그림 아래, 표 위에 배치하십시오.
  • 그림, 표, 제목 및 부록에 대해 수동으로 입력된 번호 대신 Word 상호 참조 필드/책갈피를 사용하십시오.
  • 문서 구조에서 목차와 그림/표 목록을 생성하고 업데이트하십시오.
  • 모든 과학적 디스플레이에 캡션, 의미 있는 텍스트 호출 및 올바른 소스/데이터 연결이 있는지 확인하십시오. 로고나 장식용 표지 이미지를 과학적 그림으로 취급하지 마십시오.
  • EndNote CWYW 필드와 포함된 데이터를 보존하십시오. 새/변경된 라이브 인용에는 EndNote 도구를 사용하십시오. 사용할 수 없는 경우, 확인된 메타데이터와 명확하게 식별된 인용 삽입 요청을 준비하십시오.
  • 필요한 앞부분, 구역 나누기, 머리글/바닥글, 페이지 번호 매기기 및 감사의 글을 보존하십시오. 새 작업 보고서에서만 교육용 예제를 제거하고 관련 템플릿 결함을 기록하십시오.

편집 후 작업 사본을 기준과 비교하십시오:

python "<스킬-루트>/scripts/audit_docx.py" "<프로젝트>/proposed.docx" --baseline "<프로젝트>/original.docx" --json "<프로젝트>/audit-after.json"

변경되거나 제거된 필드/책갈피를 의도된 편집과 비교하여 조사하십시오. 개수만으로는 보존을 확립할 수 없습니다. 예상치 못한 변경을 조용히 수락하지 마십시오.

6. 쉬운 검토 제공

서식, 표현, 과학적 결정, 증거 부족의 네 가지 범주를 사용하십시오. 중요한 항목에만 안정적인 ID를 할당하십시오. 검토 등록부를 유지하고, 섹션과 짧고 정확한 텍스트 발췌로 고정하고, 최종 렌더링 후 페이지 번호를 추가하십시오.

실질적인 수정의 경우 다음을 제공하십시오:

  1. 안전하게 지원되는 경우 실제 추적된 표현 변경 사항과 고정된 주석이 포함된 검토 DOCX. 제안 표의 이름을 정확하게 지정하고, 변경 내용 추적이라고 부르지 마십시오.
  2. 유용한 경우 깨끗한 읽기 보기. Word의 '변경 내용 없음' 보기를 선호하고, 별도의 읽기 사본을 만드는 경우 검토 마스터를 유지하고 가독성이 저자의 수락을 의미하지 않는다고 설명하십시오.
  3. 간단한 결정 목록: 위치, 문제, 제안된 표현/질문, 이유/증거, 수락/편집/거부/입력 필요 선택. 반복적인 기계적 수정은 그룹화하십시오.
  4. 확인된 항목, 해결되지 않은 입력, 여전히 필요한 기본 Word/EndNote 검사를 구분하는 검증 요약.

레이아웃 편집 후 모든 렌더링된 페이지를 검토하십시오. 가능한 경우 기본 Word를 통해 Word 필드를 새로 고치고 페이지 매김을 업데이트하고, EndNote의 '인용 및 참고 문헌 업데이트'를 별도로 실행하십시오. 주석/수정 앵커를 구조적으로 확인하십시오. PDF 렌더링에서 생략될 수 있기 때문입니다. PDF 미리보기로는 라이브 인용 기능을 확인할 수 없습니다.

가장 유용한 저자 결정으로 끝내십시오(일반적으로 3개 이하). 완전한 등록부는 유지하십시오. 교정 및 서식 지정을 계속 진행하십시오. 과학자의 지시 없이 제출, 게시, 검토 기록 제거, 기여자 역할 발명 또는 과학적 수락을 표시하지 마십시오. 실질적인 AI 지원을 기록하여 대상별 공개를 정확하게 준비할 수 있도록 하십시오.

관련 스킬