Paper Format Agent은(는) 무엇을 하나요?
이 스킬은 로컬 우선(Local-first) 방식의 학술 문서 서식 작업에 사용됩니다. .docx 형식의 논문과 별도로 제공되는 서식 명세서를 .docx, .doc, 혹은 .txt 형식으로 처리하도록 설계되었습니다.
안전 기본값 (Safety Defaults)
- 사용자가 명시적으로 요청하지 않는 한, 개인 논문이나 서식 가이드를 외부 서비스에 업로드하지 마십시오.
- 학생 논문, 원고, 리뷰어 의견, 학교 템플릿을 민감한 데이터로 취급하십시오.
- 사용자가 명시적으로 동의하지 않는 한 학술 내용을 변경하지 마십시오. 기본값은 서식만 변경하는 것입니다.
- 보고서와 생성된 문서는 사용자가 제공한 출력 디렉토리에 보관하십시오.
표준 작업 흐름 (Standard Workflow)
- 입력 파일을 확인합니다:
--format-file: 서식 가이드 또는 템플릿 텍스트.--paper-file: 원본 논문 (현재.docx).--out-dir: 보고서 및 생성된 문서를 위한 출력 디렉토리.
- 서식만 변경하는 모드로 CLI를 실행합니다:
python -m paper_format_agent.cli \
--format-file "format_guide.docx" \
--paper-file "paper.docx" \
--out-dir "./output" \
--engine auto \
--strict-required-sections
- 생성된 결과물을 검사합니다:
formatted_paper_v3.docx: 수정된 문서.format_rules.json: 추출된 규칙.format_report.json: 기계가 읽을 수 있는 점수 및 검사 결과.format_report.html: 사람이 읽을 수 있는 보고서.modify_log.json: 서식 작업 기록.engine_report.json: 후처리 엔진 결과.
format_report.json에서 콘텐츠 보호 필드를 확인합니다:content_changed는 일반적으로false여야 합니다.content_guard_enforced는 일반적으로true여야 합니다.
- 규칙이 잘못된 경우, 규칙 추출 또는 채점 로직을 업데이트하고 최소한의 테스트 케이스를 추가하십시오.
검증 (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을 검사하십시오. 다음 순서로 문제의 우선순위를 지정하십시오:
- 내용이 예기치 않게 변경됨.
- 필수 섹션 또는 제목이 잘못 분류됨.
- 페이지 설정, 여백, 글꼴 또는 줄 간격이 잘못됨.
- 캡션, 참고문헌, 표 또는 번호 매기기가 잘못됨.
- 보고서 문구 또는 점수 설명이 명확하지 않음.
기여에 적합한 작업 (Contribution-Friendly Tasks)
좋은 첫 PR(풀 리퀘스트)은 일반적으로 다음 범주 중 하나에 해당합니다:
- 학교, 저널 또는 학회 서식 규칙에 대한 합성 테스트 추가.
- 좁은 범위의 정규식이나 파서를 사용하여 규칙 추출기 개선.
- 채점 의미를 변경하지 않고 보고서 명확성 개선.
docs/regression_manifest.sample.json에 회귀 테스트 사례 추가.- 이 스킬 워크플로우 또는
agents/openai.yaml메타데이터 개선.