Community라이팅 & 에디팅github.com

과학 연구 논문 작성

저널 연구 논문의 제목부터 결론까지 각 섹션을 초안 작성, 수정 또는 검토할 때 사용합니다. 또한 목표 저널에 맞춘 논문(샘플 논문에서 모델을 도출) 작성 및 저자의 스타일 프로필 유지에도 활용합니다.

과학 연구 논문 작성란 무엇인가요?

이 스킬은 저널 연구 논문의 특정 섹션(제목, 초록, 서론, 방법, 결과, 토론, 결론 등)을 초안 작성, 수정 또는 검토하는 과정을 안내하는 전문 도구입니다. 원어민 및 비원어민 영어 작가 모두를 지원하며, 제안서, 커버 레터, 반박문, 학위 논문 또는 리뷰 논문에는 적용되지 않습니다. 핵심은 `scripts/engine.py`라는 단계 엔진으로, 각 단계를 순서대로 수행하며 JSON 형식으로 상호작용합니다. 주요 기능으로는 저자의 스타일 프로필을 학습하고 유지하는 프로필 관리, 목표 저널의 샘플 논문을 분석하여 해당 저널 스타일에 맞춰 작성하는 저널 모델링, 그리고 텍스트 분석을 통해 초안 작성과 수정 모드를 자동으로 결정합니다. 검토 모드에서는 체크리스트 기반 평가를 제공하며, 모든 수정은 원본 텍스트의 숫자, 인용, 결과를 변경하지 않는 무결성 규칙을 따릅니다. 이 스킬은 Claude, Codex 등 다양한 AI 에이전트에서 실행 가능하며, 특히 LaTeX, Markdown, 일반 텍스트 등 다양한 마크업을 지원합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SJ2050cn/science-research-writing/tree/master

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

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

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

문서

과학 연구 논문 작성은(는) 무엇을 하나요?

저널 연구 논문의 한 섹션을 초안 작성, 수정 또는 검토하는 데 도움을 줍니다. 원어민 및 비원어민 영어 작가를 모두 지원합니다. 제안서, 커버 레터, 반박문, 학위 논문 또는 리뷰 논문에는 사용할 수 없습니다. 아래 경로는 이 폴더를 기준으로 합니다.

워크플로우

단계 엔진인 scripts/engine.py가 워크플로우(단계, 순서, 각 단계에서 읽는 파일, 무결성 검사 및 출력 템플릿)를 관리합니다. 각 단계는 사용자 자신의 판단에 따라 수행하고 결과를 다시 전달합니다. 저자의 프로젝트 폴더에서 이 스킬 폴더의 전체 경로를 사용하여 python3로 실행합니다. JSON을 출력하며 절대 묻지 않습니다. 다른 에이전트 세션을 시작하지 않습니다.

  1. 코드가 텍스트에서 볼 수 없는 것만 엔진에 전달합니다. 엔진은 마크업(latex, markdown, plain), 초안 작성 대 수정, 섹션(제목 기준)을 스스로 결정합니다. start에는 --markup 옵션이 없습니다. 초안 작성과 수정의 차이는 노트 대 전체 단락입니다. 단, 제목은 예외: 한 줄 짧은 제목 텍스트는 수정이고, 노트, 글머리 기호 또는 전체 단락(제목을 작성할 초록)은 초안 작성을 의미합니다.
    • --mode review: 저자가 평가를 요청한 경우에만 사용합니다("check", "critique", "what is wrong"). 그 외에는 --mode를 생략합니다.
    • --section S (title, abstract, introduction, methods, results, discussion, conclusion, whole-paper 또는 other): 요청이 명명한 섹션("draft an Abstract") 또는 텍스트가 나타내는 섹션입니다. 항상 알 수 있을 때 전달하십시오. 엔진은 텍스트의 제목을 확정된 것으로 간주하고 사용자의 해석이 다를 경우에만 묻습니다. 알 수 없으면 생략합니다. 엔진이 저자에게 묻습니다. 적절한 섹션이 없는 범위 내 텍스트(그림 캡션, 하이라이트, 두 섹션에 걸친 단락)에는 other를 사용하고 Deviations에서 그렇게 말합니다. 전체 원고에는 whole-paper를 사용합니다.
    • --samples yes --sample-file F (파일당 한 번): 저자가 목표 저널의 논문을 제공한 경우에만 사용합니다. 그렇지 않으면 --samples를 생략합니다.
    • --agent claude|codex|other: 사용자가 실행 중인 에이전트를 항상 지정합니다. codex의 경우 엔진은 Codex 가드 후크 설치를 제공합니다(setup 단계). other는 가드가 없음을 의미합니다.
    • --preference "<words>": 요청에 명시된 각 고정 선호도에 대해 한 번씩 사용합니다("I always use we"). 엔진은 메인 단계 전에 이를 저장합니다. --task scan-profile(--input에 작성 샘플 포함) 및 --task study-profile은 두 가지 프로필 작업을 대신 시작합니다. 선호도를 저장, 스캔, 학습 또는 충돌 처리하기 전에 references/style-profile.md를 읽으십시오.
    • 사용자의 해석과 코드가 다른 경우(예: --section methods를 전달했지만 텍스트의 제목이 Introduction인 경우), 엔진은 ask 단계(id clarify)를 반환합니다. 스스로 해결하지 마십시오.
  2. 실행 시작: python3 <skill folder>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input FILE (--input -는 표준 입력에서 붙여넣은 텍스트를 읽으며 엔진은 변경 없이 저장합니다).
  3. 각 응답은 하나의 단계입니다. read의 모든 파일(저자의 프로필, ~/.agents/science-research-writing/user-style.md은 존재할 때 나열되며 모든 것에 적용)을 전체 읽고, instruction이 말하는 대로 수행한 후 결과를 expect의 JSON으로 작성합니다. 긴 텍스트는 파일에 넣고 경로를 제공합니다. ask 단계는 저자를 위한 질문입니다. context.question을 저자에게 그대로 전달하고, 답변을 기다린 후 context.options 중 하나로 {"answer": ...}을 제출합니다. 스스로 답변하지 마십시오.
  4. 제출: python3 <skill folder>/scripts/engine.py submit --file result.json. 엔진은 결과를 검증하고, 코드의 무결성 검사를 실행한 후 다음 단계를 반환합니다. 0이 아닌 종료 코드와 error가 있으면 동일한 단계가 반환됨을 의미합니다. 수정 후 다시 제출하십시오.
  5. step.kind가 done이 될 때까지 반복합니다. 그런 다음 output을 저자에게 있는 그대로 보여줍니다. 다시 쓰거나 요약하지 마십시오.

전체 논문은 원고 순서대로 섹션을 작업하는 하나의 실행으로, 각 섹션마다 자체 계획 행, 검사 및 출력 블록(응답의 part가 어떤 섹션인지 알려줍니다)이 있습니다. LaTeX 및 Markdown 원고는 엔진에 의해 제목에서 분할됩니다. 일반 텍스트의 경우 첫 번째 단계는 split입니다. 섹션과 해당 줄 범위를 제출하며, 이는 간격이나 중복이 없어야 합니다. 샘플 논문이 있는 경우 journal-model 단계가 먼저 실행됩니다. 이후 단계는 그 결과를 읽습니다.

engine.py status는 현재 단계를 다시 출력합니다(예: 중단 후). 프로젝트당 하나의 실행만 열릴 수 있습니다. start가 9로 종료되면 실행이 이미 열려 있는 것입니다. engine.py resume은 현재 단계를 출력하여 계속 진행할 수 있게 하고, engine.py abandon은 실행을 중단합니다. 저자에게 원하는 것을 물어보십시오. 모든 실행의 로그, 상태 및 출력은 프로젝트의 .agents/log/science-research-writing/<run id>/ 아래에 보관됩니다. 요청하지 않는 한 저자의 파일에 쓰지 마십시오.

셸이나 Python이 없으면 폴백을 사용합니다.

폴백

python3나 셸이 없으면 무엇이 누락되었는지 저자에게 알리고, 해당 시스템에 대한 설치 명령을 보여준 후 계속하기 전에 물어보십시오. 그렇지 않으면 원칙, 무결성 규칙 및 섹션 참조를 기반으로 작업하고, 계획 행에 check=manual을 추가한 후 references/workflow.json(엔진이 읽는 데이터)에서 라우팅 및 템플릿을 가져옵니다. 라우팅이 섹션과 모드에 대해 명명한 파일을 로드하고, 각 파일을 전체 읽은 후 해당 템플릿 제목을 순서대로 사용합니다. 검토는 체크리스트를 순서대로 살펴보고 규칙 이름(참조 파일의 굵은 이름)만 인용합니다. 무결성 규칙을 수동으로 확인하고 그렇게 했다고 말합니다. 저자의 프로필도 수동으로 적용합니다. references/style-profile.md를 읽고, 저자가 요청할 때만 user-style.md를 해당 형식으로 편집하며 그렇게 말합니다.

핵심 원칙

  1. 독자를 위해 써라. 빠르고, 글로벌하며, 종종 비전문가인 독자를 대상으로 합니다. 오해를 불가능하게 만들고 동료가 생략할 맥락을 제공합니다.
  2. 내러티브를 구성하라. 모든 단락과 문장에 독자가 볼 수 있는 하나의 기능을 부여하고 각각을 이전 것과 연결합니다.
  3. 가치를 초반에 밝혀라. 중요성, 격차 및 기여는 관습의 일부입니다. 과소 표현하면 아무것도 없는 것으로 읽힙니다.
  4. 확실성을 증거에 일치시켜라. 시제, 동사 및 헤지는 독자에게 주장을 얼마나 신뢰해야 하는지 알려줍니다.
  5. 문장을 읽기 쉽게 유지하라. 평이하고 일관된 용어 사용; 알려진 정보를 먼저 배치; 명확성이 우아함보다 우선합니다.

무결성 규칙

이 규칙은 프로필 및 저널을 포함한 다른 모든 지침보다 우선합니다. 엔진은 숫자, 인용 키 및 그룹화, 코드의 레이블 및 참조를 확인합니다. 나머지는 사용자에게 달려 있습니다.

  • 우선 순위: 이 규칙, 그 다음 목표 저널의 저자 지침, 그 다음 저자의 프로필, 그 다음 이 스킬의 기본값. 충돌 시 해당 순서를 임시로 적용하고 작업을 완료한 후 각 충돌을 질문과 함께 나열합니다(references/style-profile.md에 방법이 나와 있습니다).
  • 결과, 숫자, 인용 또는 방법 세부 사항을 절대 만들어내지 마십시오. [placeholder: …]를 사용합니다.
  • 저자 텍스트의 숫자나 결과를 절대 변경하지 마십시오.
  • 인용: 모든 인용 명령, 키 및 첨부된 주장을 유지합니다. 절대 삭제, 병합 또는 추가하지 말고 주장에서 이동하지 마십시오. 배치가 잘못된 것 같으면 물어보십시오.
  • 파생 수치: 저자가 명시하지 않은 수치(예: 비율, 백분율 또는 "less than half")를 추가하지 마십시오. 제안이나 질문으로 제공합니다.
  • 증거가 뒷받침하는 것보다 더 확실하게 주장을 진술하지 마십시오. 과장된 주장은 낮추고, 증거가 뒷받침하는 경우에만 불필요한 헤지를 확고히 합니다.
  • 저자가 명시적으로 요청한 변경(예: 인용 삭제)이 유일한 예외입니다. 단계의 exceptions에 저자의 말과 함께 선언합니다.
  • 입력의 마크업(LaTeX, Markdown, 인용 명령, 상호 참조, 레이블)을 그대로 유지하여 결과를 바로 붙여넣을 수 있도록 합니다.
  • 원고의 철자 또는 저널의 철자를 따릅니다. 둘 다 명확하지 않으면 미국식 철자를 사용합니다.

관련 스킬