과학 연구 논문 작성은(는) 무엇을 하나요?
저널 연구 논문의 한 섹션을 초안 작성, 수정 또는 검토하는 데 도움을 줍니다. 원어민 및 비원어민 영어 작가를 모두 지원합니다. 제안서, 커버 레터, 반박문, 학위 논문 또는 리뷰 논문에는 사용할 수 없습니다. 아래 경로는 이 폴더를 기준으로 합니다.
워크플로우
단계 엔진인 scripts/engine.py가 워크플로우(단계, 순서, 각 단계에서 읽는 파일, 무결성 검사 및 출력 템플릿)를 관리합니다. 각 단계는 사용자 자신의 판단에 따라 수행하고 결과를 다시 전달합니다. 저자의 프로젝트 폴더에서 이 스킬 폴더의 전체 경로를 사용하여 python3로 실행합니다. JSON을 출력하며 절대 묻지 않습니다. 다른 에이전트 세션을 시작하지 않습니다.
- 코드가 텍스트에서 볼 수 없는 것만 엔진에 전달합니다. 엔진은 마크업(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단계(idclarify)를 반환합니다. 스스로 해결하지 마십시오.
- 실행 시작:
python3 <skill folder>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input FILE(--input -는 표준 입력에서 붙여넣은 텍스트를 읽으며 엔진은 변경 없이 저장합니다). - 각 응답은 하나의 단계입니다.
read의 모든 파일(저자의 프로필,~/.agents/science-research-writing/user-style.md은 존재할 때 나열되며 모든 것에 적용)을 전체 읽고,instruction이 말하는 대로 수행한 후 결과를expect의 JSON으로 작성합니다. 긴 텍스트는 파일에 넣고 경로를 제공합니다.ask단계는 저자를 위한 질문입니다.context.question을 저자에게 그대로 전달하고, 답변을 기다린 후context.options중 하나로{"answer": ...}을 제출합니다. 스스로 답변하지 마십시오. - 제출:
python3 <skill folder>/scripts/engine.py submit --file result.json. 엔진은 결과를 검증하고, 코드의 무결성 검사를 실행한 후 다음 단계를 반환합니다. 0이 아닌 종료 코드와error가 있으면 동일한 단계가 반환됨을 의미합니다. 수정 후 다시 제출하십시오. 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를 해당 형식으로 편집하며 그렇게 말합니다.
핵심 원칙
- 독자를 위해 써라. 빠르고, 글로벌하며, 종종 비전문가인 독자를 대상으로 합니다. 오해를 불가능하게 만들고 동료가 생략할 맥락을 제공합니다.
- 내러티브를 구성하라. 모든 단락과 문장에 독자가 볼 수 있는 하나의 기능을 부여하고 각각을 이전 것과 연결합니다.
- 가치를 초반에 밝혀라. 중요성, 격차 및 기여는 관습의 일부입니다. 과소 표현하면 아무것도 없는 것으로 읽힙니다.
- 확실성을 증거에 일치시켜라. 시제, 동사 및 헤지는 독자에게 주장을 얼마나 신뢰해야 하는지 알려줍니다.
- 문장을 읽기 쉽게 유지하라. 평이하고 일관된 용어 사용; 알려진 정보를 먼저 배치; 명확성이 우아함보다 우선합니다.
무결성 규칙
이 규칙은 프로필 및 저널을 포함한 다른 모든 지침보다 우선합니다. 엔진은 숫자, 인용 키 및 그룹화, 코드의 레이블 및 참조를 확인합니다. 나머지는 사용자에게 달려 있습니다.
- 우선 순위: 이 규칙, 그 다음 목표 저널의 저자 지침, 그 다음 저자의 프로필, 그 다음 이 스킬의 기본값. 충돌 시 해당 순서를 임시로 적용하고 작업을 완료한 후 각 충돌을 질문과 함께 나열합니다(
references/style-profile.md에 방법이 나와 있습니다). - 결과, 숫자, 인용 또는 방법 세부 사항을 절대 만들어내지 마십시오.
[placeholder: …]를 사용합니다. - 저자 텍스트의 숫자나 결과를 절대 변경하지 마십시오.
- 인용: 모든 인용 명령, 키 및 첨부된 주장을 유지합니다. 절대 삭제, 병합 또는 추가하지 말고 주장에서 이동하지 마십시오. 배치가 잘못된 것 같으면 물어보십시오.
- 파생 수치: 저자가 명시하지 않은 수치(예: 비율, 백분율 또는 "less than half")를 추가하지 마십시오. 제안이나 질문으로 제공합니다.
- 증거가 뒷받침하는 것보다 더 확실하게 주장을 진술하지 마십시오. 과장된 주장은 낮추고, 증거가 뒷받침하는 경우에만 불필요한 헤지를 확고히 합니다.
- 저자가 명시적으로 요청한 변경(예: 인용 삭제)이 유일한 예외입니다. 단계의
exceptions에 저자의 말과 함께 선언합니다. - 입력의 마크업(LaTeX, Markdown, 인용 명령, 상호 참조, 레이블)을 그대로 유지하여 결과를 바로 붙여넣을 수 있도록 합니다.
- 원고의 철자 또는 저널의 철자를 따릅니다. 둘 다 명확하지 않으면 미국식 철자를 사용합니다.