Communitygithub.com

joshua-zyy/academic-paper-writer

CS/AI/ML 분야의 증거 기반, 단계별 논문 작성을 위한 에이전트 스킬입니다.

academic-paper-writer란 무엇인가요?

이 에이전트 스킬은 컴퓨터 과학(CS), 인공지능(AI), 머신러닝(ML) 분야의 학술 논문 작성을 지원합니다. 증거 기반으로 각 섹션을 순차적으로 완성해 나가며, 특히 실험 데이터 시각화와 같은 학술적 그림(figure) 생성에 특화되어 있습니다. 사용자가 제공한 데이터 파일이나 수치 결과를 바탕으로 출판 품질의 그래프를 Python/Matplotlib 스크립트와 편집 가능한 SVG 형식으로 제작합니다. 또한 기존 그림의 감사(audit) 및 개정(revision) 기능을 제공하여 출판 준비 상태를 확인하고 개선할 수 있습니다. 모델 프레임워크도나 복잡한 메커니즘 다이어그램 등은 자동 생성하지 않고, 대신 수동 작업이 필요한 청사진(blueprint) 노트를 제공합니다. 이 스킬은 `manifest.yaml`에 정의된 규칙과 제약 조건을 준수하며, 사용자는 `chart-from-data`, `figure-blueprint`, `figure-audit`, `figure-revision` 모드 중 하나를 선택하여 작업을 진행할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add joshua-zyy/academic-paper-writer

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

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

문서

학술 그림

CS/AI/ML 학술 그림 라우터. 실험 데이터 그림은 기본적으로 Python/matplotlib 편집 가능한 SVG로 제공되며, CS/AI/ML 차트 설계 게이트를 실행합니다. 모델 프레임워크도, 아키텍처도, 개요도 및 복잡한 메커니즘 그림은 본 스킬의 자동 생성 범위에 속하지 않습니다. 논문에 이러한 그림이 필요한 경우, 수동 제작 요구 사항, 증거 목록, 캡션 초안 또는 figure blueprint notes만 출력할 수 있습니다.

라우터 프로토콜

  1. manifest.yaml을 읽습니다. 여기에는 always_load 파일, axes 및 references.on_demand가 선언되어 있습니다.
  2. always_load에 나열된 모든 파일을 읽습니다. 이 파일들은 스킬의 바인딩 규칙이며, 참고 자료가 아닙니다.
  3. 로드된 자료를 제약 조건으로 적용합니다.
    • stance.md는 Python 전용 플로팅, 그림 계약, 시각적 정책 및 범위를 정의합니다.
    • red-lines.md는 절대 금지 사항을 정의합니다. 이에 대해 협상하지 마십시오.
    • output-contract.md는 모드별 결과물을 정의합니다.
    • anti-patterns.md는 알려진 실패 패턴과 올바른 대안을 정의합니다.
  4. 매니페스트에서 정확히 하나의 mode를 선택합니다. 모호한 경우, 데이터 소스나 대상 사용처가 누락된 경우에만 하나의 간결한 명확화 질문을 합니다. 모델 프레임워크, 아키텍처, 개요 또는 메커니즘 다이어그램에 대한 요청은 figure-blueprint만 사용하여 manual_figure_needed 노트를 생성합니다. 이미지, SVG 또는 프롬프트를 렌더링하지 마십시오.
  5. 실행하기 전에 선택한 모드를 사용자에게 알립니다.
  6. 매니페스트의 references.on_demand 조건이 충족되는 경우에만 references/를 참조합니다.

모드

모드사용 조건
chart-from-data데이터 파일이나 수치 결과가 있으며, CS/AI/ML 차트 설계 게이트를 포함한 출판용 플롯이 필요할 때
figure-blueprint논문 섹션에 대한 그림 제안이 필요할 때
figure-audit기존 그림의 출판 준비 상태를 검토할 때
figure-revision기존 그림의 수정이 필요할 때

에이전트 디스패치

agents/figure_agent.md는 오케스트레이터에 의해 6.4단계에서 디스패치됩니다. 에이전트는 그림 산출물, 스크립트, SVG 경로 및 보고서를 반환합니다. 프로젝트 소스 코드나 실험 데이터를 독립적으로 편집해서는 안 됩니다.

완료 기준

  • chart-from-data: 그림 계약, CS/AI/ML 차트 설계 게이트, Python 스크립트, 소스 데이터, 편집 가능한 SVG, QA 보고서 — 모두 통과.
  • figure-audit: 모든 QA 항목에 대해 통과/실패 상태 및 구체적인 수정 지침이 제공됨.
  • figure-blueprint: 제안된 모든 그림이 논문의 주장과 데이터/증거 출처에 매핑됨.
  • figure-revision: 수정된 산출물 또는 지침, QA 보고서, 변경되지 않은 증거 추적 가능성이 유지됨.

관련 스킬