Communitygithub.com

Paper Format Agent

DOCX 포맷터로, 학술 논문의 서식을 변경하면서 내용은 절대 수정되지 않음을 보장하는 콘텐츠 지문 보호 기능을 제공합니다. 에이전트 스킬로도 설치 가능합니다.

Paper Format Agent란 무엇인가요?

Paper Format Agent는 로컬 우선(Local-first) 방식의 학술 문서 서식 도구입니다. `.docx` 형식의 논문과 별도로 제공되는 서식 명세서(Format Specification)를 입력받아, 논문의 내용은 전혀 변경하지 않고 오직 서식만 수정합니다. 이 도구는 콘텐츠 지문(Content Fingerprint)을 생성하여 수정 전후의 텍스트를 비교함으로써 내용 변경 여부를 검증하며, 이를 `format_report.json`에 기록합니다. 사용자는 명령줄 인터페이스(CLI)를 통해 서식 파일, 논문 파일, 출력 디렉토리를 지정하여 실행할 수 있으며, 결과물로 서식이 적용된 문서, 추출된 규칙, 다양한 보고서를 생성합니다. 민감한 학술 데이터를 외부 서비스에 업로드하지 않도록 설계되었으며, 기본적으로 서식만 변경하고 사용자가 명시적으로 동의한 경우에만 내용을 수정합니다. 또한 합성 테스트와 결정론적 규칙 추출(Deterministic Rule Extraction)을 선호하여 기여하기 쉬운 구조로 되어 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add zxyasfas/paper_format_agent

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

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

문서

Paper Format Agent은(는) 무엇을 하나요?

이 스킬은 로컬 우선(Local-first) 방식의 학술 문서 서식 작업에 사용됩니다. .docx 형식의 논문과 별도로 제공되는 서식 명세서를 .docx, .doc, 혹은 .txt 형식으로 처리하도록 설계되었습니다.

안전 기본값 (Safety Defaults)

  • 사용자가 명시적으로 요청하지 않는 한, 개인 논문이나 서식 가이드를 외부 서비스에 업로드하지 마십시오.
  • 학생 논문, 원고, 리뷰어 의견, 학교 템플릿을 민감한 데이터로 취급하십시오.
  • 사용자가 명시적으로 동의하지 않는 한 학술 내용을 변경하지 마십시오. 기본값은 서식만 변경하는 것입니다.
  • 보고서와 생성된 문서는 사용자가 제공한 출력 디렉토리에 보관하십시오.

표준 작업 흐름 (Standard Workflow)

  1. 입력 파일을 확인합니다:
    • --format-file: 서식 가이드 또는 템플릿 텍스트.
    • --paper-file: 원본 논문 (현재 .docx).
    • --out-dir: 보고서 및 생성된 문서를 위한 출력 디렉토리.
  2. 서식만 변경하는 모드로 CLI를 실행합니다:
python -m paper_format_agent.cli \
  --format-file "format_guide.docx" \
  --paper-file "paper.docx" \
  --out-dir "./output" \
  --engine auto \
  --strict-required-sections
  1. 생성된 결과물을 검사합니다:
    • formatted_paper_v3.docx: 수정된 문서.
    • format_rules.json: 추출된 규칙.
    • format_report.json: 기계가 읽을 수 있는 점수 및 검사 결과.
    • format_report.html: 사람이 읽을 수 있는 보고서.
    • modify_log.json: 서식 작업 기록.
    • engine_report.json: 후처리 엔진 결과.
  2. format_report.json에서 콘텐츠 보호 필드를 확인합니다:
    • content_changed는 일반적으로 false여야 합니다.
    • content_guard_enforced는 일반적으로 true여야 합니다.
  3. 규칙이 잘못된 경우, 규칙 추출 또는 채점 로직을 업데이트하고 최소한의 테스트 케이스를 추가하십시오.

검증 (Validation)

작업을 반환하기 전에 다음 명령을 실행하십시오:

python tools/validate_skill.py
python -m unittest discover -s tests -p "test_*.py"
python tools/compile_check.py
python tools/release_audit.py

템플릿 지원을 추가할 때 (When Adding Template Support)

  • 동작을 재현하는 데 필요한 가장 작은 대표 규칙 텍스트를 추가하십시오.
  • LLM만 사용한 해석보다 결정론적 규칙 추출(Deterministic Rule Extraction)을 선호하십시오.
  • 여백, 글꼴 크기, 줄 간격, 필수 섹션, 제목, 캡션 또는 참고문헌에 대한 테스트를 추가하십시오.
  • 실제 학생 문서를 커밋하지 마십시오. 합성 텍스트나 익명화된 픽스처를 사용하십시오.

출력을 검토할 때 (When Reviewing Output)

format_report.json을 먼저 읽고, 사용자가 사람이 읽을 수 있는 요약이 필요한 경우 format_report.html을 검사하십시오. 다음 순서로 문제의 우선순위를 지정하십시오:

  1. 내용이 예기치 않게 변경됨.
  2. 필수 섹션 또는 제목이 잘못 분류됨.
  3. 페이지 설정, 여백, 글꼴 또는 줄 간격이 잘못됨.
  4. 캡션, 참고문헌, 표 또는 번호 매기기가 잘못됨.
  5. 보고서 문구 또는 점수 설명이 명확하지 않음.

기여에 적합한 작업 (Contribution-Friendly Tasks)

좋은 첫 PR(풀 리퀘스트)은 일반적으로 다음 범주 중 하나에 해당합니다:

  • 학교, 저널 또는 학회 서식 규칙에 대한 합성 테스트 추가.
  • 좁은 범위의 정규식이나 파서를 사용하여 규칙 추출기 개선.
  • 채점 의미를 변경하지 않고 보고서 명확성 개선.
  • docs/regression_manifest.sample.json에 회귀 테스트 사례 추가.
  • 이 스킬 워크플로우 또는 agents/openai.yaml 메타데이터 개선.

관련 스킬