<references_contract>
참조는 필수이며 선택 사항이 아닙니다
이 스킬은 6개의 참조 파일과 references/examples/ 디렉토리 내 두 개의 작업 예제를 제공합니다.
해당 단계가 필요하기 전에 일치하는 참조를 읽고, 작업을 확인하기 위한 용도로 이후에 읽지 마십시오.
references/data-integrity.md: 소스 데이터에서 초록 재현 (1단계)references/venues.md: 장소의 규칙 찾기 및 날짜 확인; 기관 브랜드 키트 (0단계 및 2단계)references/design-rules.md: 가독성 기준, 서체 배율, 레이아웃, 하우스 스타일 (3단계)references/build-and-charts.md: 네이티브 차트, 복구 트리거, python-pptx 함정 (4단계)references/rendering-qa.md: 렌더링, 가독성 및 겹침 확인, QR 코드 (5단계)references/citations.md: 확인, 서식 지정, 하이퍼링크 (2단계) </references_contract>
이 스킬은 실제 사용을 통해 강화된 워크플로를 인코딩합니다. 해당 단계가 필요하기 전에 일치하는 참조를 읽고, 작업을 확인하기 위한 용도로 이후에 읽지 마십시오(그때는 이미 출력에 오류가 있습니다). 이미 해결된 부분(차트 안전, 렌더링, 타이포그래피 배율)을 재발명하지 마십시오. 스크립트는 ${CLAUDE_SKILL_DIR}/scripts/에 있습니다. 작업 예제와 심층 지침은 ${CLAUDE_SKILL_DIR}/references/에 있습니다. 렌더링은 LibreOffice(크로스 플랫폼) 또는 macOS의 Microsoft PowerPoint를 사용합니다. 자세한 내용은 references/rendering-qa.md를 참조하세요.
<companion_skills> 이 스킬이 필요로 하는 모든 것은 번들로 제공됩니다. 빌드, 렌더링, 확인은 여기 스크립트만으로 실행됩니다. 다음 선택적 스킬은 완성도를 높입니다. 설치된 것을 사용하세요. 하나가 없으면 계속 진행하고 사용자에게 한 줄 설치를 한 번 언급하고, 절대 중단하지 마세요.
| 스킬 | 추가 기능 | 설치 (Claude Code에서) |
|---|---|---|
Anthropic pptx + pdf (document-skills) | 기존 포스터 편집, 어려운 PDF | /plugin marketplace add anthropics/skills, 그 다음 /plugin install document-skills@anthropic-agent-skills |
frontend-design | 팔레트, 서체 짝짓기, 레이아웃 방향 | /plugin install frontend-design@claude-plugins-official |
K-Dense citation-management (MIT) | PubMed / DOI 조회, 서식화된 참고문헌 | skills/citation-management을 github.com/K-Dense-AI/scientific-agent-skills에서 복사하여 ~/.claude/skills/로 |
K-Dense scientific-visualization (MIT) | 저널 스타일 matplotlib 그림 (이미지 차트 경로) | 동일 저장소, skills/scientific-visualization |
K-Dense pptx-posters(동일한 요청과 경쟁하는 HTML/CSS 포스터 경로)와 scientific-writing(포스터에 필요한 글머리 기호를 금지하는 원고 산문)는 제외하세요. 인용 확인에는 추가 스킬이 필요하지 않습니다: PubMed, Crossref, doi.org에 대한 웹 검색 및 가져오기가 작업을 수행합니다.
</companion_skills>
<execution_context>
대화형 또는 완전 자율적으로 실행하세요. 아래 모든 게이트는 권장 기본값이 명확히 표시된 AskUserQuestion이므로, 자율 실행은 기본값을 선택하고 명시합니다.
- 🟢 자동 (질문 없음): 입력 읽기, 조사, 하우스 스타일 추출, 빌드, 렌더링, 자체 QA 및 반복, 포스터 자체 작업 디렉토리에서 git 초기화 및 커밋, 중간 파일 정리.
- 🟡 질문 (권장 기본값 포함): 포스터 크기 / 장소 사양, 저자 + 소속 + 로고 확인, 어조 수준, 인용 깊이, 차트 엔진(편집 가능 네이티브 vs 이미지), 데이터 최종 여부.
- 🔴 절대 안 됨: 숫자, 결과, 인용을 조작하지 마십시오. 연구의 보고된 결과를 변경하지 마십시오. 사용자가 이미 확정한 파일을 덮어쓰지 마십시오(항상 별도 사본을 작성하십시오). 파워포인트의 복구 프롬프트를 트리거하는 파일을 제공하지 마십시오. 환자 수준 데이터를 작성자의 파일에서 복사하거나 웹 서비스로 보내지 마십시오(제자리에서 읽고 집계만 저장). </execution_context>
- 입력 수집: 초록 PDF (필수); 하우스 스타일을 위한 선택적 참조 포스터 (.pptx); 선택적 로고 파일; 업데이트된 데이터.
- 이해한 내용을 재진술한 후 게이트를 일괄 처리합니다(한두 번의
AskUserQuestion호출, 각 옵션에는 권장 기본값 표시). 권장 기본값은 대괄호 안에 있습니다:- 크기 / 장소: 먼저 장소의 ePoster 사양 확인 [기본값]; 그렇지 않으면 대부분의 온스크린 ePoster 뷰어와 일치하는 16:9 단일 슬라이드 (48x27 인치).
- 저자, 소속, 로고: 초록의 제출 블록이 아닌 작성자에 대해 확인합니다(종종 최종 버전이 아닙니다). 여러 기관은 여러 로고를 의미합니다 [어느 것인지 질문].
- 어조: 중간 수준의 학술적 완성도 [기본값]; 데이터와 결과는 절대 변경되지 않습니다.
- 인용: 클릭 가능한 DOI/URL이 있는 4-6개의 검증된 참고문헌 [기본값].
- 차트 엔진: 편집 가능한 네이티브 차트 [기본값]; 요청 시 다듬어진 이미지.
- 데이터가 최종인지, 아니면 더 추가될 예정인지? 진행 중인 경우 숫자를 쉽게 업데이트할 수 있도록(단일 데이터 블록) 빌드하고 잠정적인 프레이밍을 유지합니다.
- 단일 슬라이드 포스터인가요, 발표 데크인가요? "컨퍼런스용 파워포인트"는 둘 중 하나를 의미할 수 있습니다 [포스터].
- 작성자의 데이터 파일이 제공되고 초록과 일치하지 않는 경우: 어떤 숫자가 포스터에 들어가나요 [작성자의 분석 파일을 받으세요; 그렇지 않으면 data-integrity.md를 참조하여 재계산 및 재현].
- QR 코드 링크 (비디오, 전체 논문). 누락된 링크는 표시된 자리 표시자가 됩니다 [기본값].
- 업로드 마감일: 승인 이메일을 요청하세요; 마감일이 이미 임박했을 수 있습니다.
- 자율 모드: 기본값을 선택하고 명시한 후 진행합니다.
- 선택적으로 환경에 컴패니언 스킬이 있는 경우 사용합니다(문서/pptx 및 pdf, 데이터 시각화, 프론트엔드 디자인, 인용 관리, 과학 시각화). 이는 향상된 기능입니다. 아래 워크플로는 python-pptx, matplotlib 및 렌더러를 통해 자체 포함됩니다.
- 초록을 완전히 읽습니다:
pdfplumber로 텍스트(.docx는python-docx), 시각적 렌더링, OCR/이미지 검사를 통해 그림이 누락되지 않도록 합니다. 제목, 저자, 소속, 모든 숫자 및 각각의 n/N을 캡처합니다. - 작성자가 기본 데이터를 제공한 경우 값보다 먼저 그 구조를 읽은 다음, 초록의 모든 수치를 재현하는
analysis.py에서 이를 확인하고 집계를data.json에 씁니다. SD 대 SE, 쌍체 대 그룹 평균, 각 수치의 자체 n, 원래 노트에 대한 범주 레이블, 첫 번째 데이터 행을 확인합니다.references/data-integrity.md를 참조하세요. - 참조 포스터가 제공된 경우 하우스 스타일을 추출합니다: 슬라이드 크기, 팔레트(밴드 + 강조 채우기), 글꼴 및 크기, 섹션 막대 구조, 로고.
bash ${CLAUDE_SKILL_DIR}/scripts/render.sh로 렌더링하여 확인합니다.references/design-rules.md를 참조하세요. - python 종속성 확인:
pip install python-pptx matplotlib pdfplumber pypdfium2 pillow pypdf pymupdf.
- 학회 자체 페이지에서 올해의 ePoster 사양(화면비, 글꼴, 미디어, 업로드 공급업체, 마감일, 필수 공개 문구)을 확인하고 날짜를 기록합니다. 각 출처가 어떤 조직에 관한 것인지 확인합니다.
references/venues.md를 참조하세요. 이 문서는 기관의 공개 브랜드 키트에서 팔레트, 서체 및 로고를 가져오는 방법도 다룹니다. - 인용 확인 및 가져오기: 실제, PubMed/DOI 확인, 하이퍼링크 및 접속 날짜 포함; 저널뿐만 아니라 작성자가 실제로 사용하는 등록 및 회색 문헌 출처를 포함합니다.
references/citations.md를 참조하세요. 인용을 절대 조작하지 마십시오. - 서론에 필요한 배경 정보를 가져옵니다. 빌드할 때 최신 라이브러리 문서를 참조하십시오.
- 하우스 스타일 토큰, 컬럼 그리드, 명확한 시각적 계층 구조, 포스터 규모의 타이포그래피, 숨 쉬는 듯한 패딩, 강력한 대비를 설정합니다.
references/design-rules.md를 참조하세요. - 차트 유형을 정직하게 선택합니다: 도넛/파이 차트는 전체의 부분에만; 막대 차트는 독립적 또는 상호 배타적이지 않은 비율에; 큰 숫자 타일은 단일 수치에 사용합니다. 각 차트에 n/N을 레이블로 표시합니다.
references/build-and-charts.md를 참조하세요. - 모든 차트와 콜아웃을 구동하는 하나의 편집 가능한 데이터 블록을 정의합니다.
references/examples/build_poster_example.py(편집 가능한 네이티브 차트) 또는references/examples/make_charts_example.py(matplotlib 이미지)를 콘텐츠 및 하우스 스타일에 맞게 조정합니다.- PowerPoint 안전 스타일링으로만 네이티브 편집 가능한 차트를 빌드합니다. 유일한 절대 규칙: 도넛/파이 데이터 레이블 POSITION을 절대 설정하지 마십시오. 이 설정이 PowerPoint에서 차트를 복구 및 제거하도록 만듭니다. 슬라이스별 채우기, 범례, 백분율 레이블, 숫자 형식, 축 글꼴은 모두 안전합니다. 도넛 백분율을 범례와 구멍의 큰 숫자에 넣으십시오. 전체 레시피는
references/build-and-charts.md에 있습니다. - TDD 라이트: 저장하기 전에 표시된 모든 백분율이 소스 숫자로 재계산되는지 확인합니다.
- 0단계에 따라 저자, 소속 및 로고를 올바르게 가져옵니다.
- 가독성 게이트: 하나의 서체 배율 테이블(48인치 슬라이드에서 22pt 기준)에서 모든 크기를 설정하고, 모든 차트에
chart.font.size를 설정하며, 저장된 파일의 크기가 기준 미만이면 빌드를 실패로 종료합니다(scripts/check_fonts.py).references/design-rules.md를 참조하세요. - 준비 게이트: 확인되지 않은 항목(저자 목록, 소속, 공개 사항, 링크)을 빌드의 CONFIRMED 체크리스트에 유지합니다. 모두 True가 될 때까지 출력 이름을
..._DRAFT.pptx로 지정하고 포스터에 각 간격을 눈에 띄게 표시하고 아직 열려 있는 것을 출력합니다.
bash ${CLAUDE_SKILL_DIR}/scripts/render.sh <pptx> <out.pdf> <out.png> 1.7로 렌더링하고(LibreOffice 또는 macOS의 PowerPoint), PNG를 봅니다.- 네이티브 차트의 경우
python3 ${CLAUDE_SKILL_DIR}/scripts/check_charts.py <pptx>를 실행합니다: 도넛/파이 차트에 데이터 레이블 위치가 있으면 실패합니다. 이 설정은 PowerPoint에서 열 때 차트를 삭제하게 만듭니다. scripts/check_fonts.py <pptx>및scripts/check_overlap.py <rendered.pdf>를 실행한 다음, 렌더링을 1920x1080으로 다운스케일하고 가장 밀도가 높은 영역을 1:1 자르기로 봅니다. 렌더링에서 모든 QR 코드를 디코딩합니다.references/rendering-qa.md를 참조하세요.references/rendering-qa.md체크리스트에 따라 수정합니다: 넘침 또는 잘림 없음, 충분히 큰 서체, 숨 쉬는 듯한 패딩, 높은 대비, 정렬된 열, 올바른 숫자. 사용자에게 보여주기 전에 진정으로 좋아질 때까지 반복합니다.
- 명확하게 명명된 별도 사본을 작성합니다. 사용자가 확정한 파일을 절대 덮어쓰지 마십시오.
- .pptx, 제출용 PDF, 미리보기 PNG를 전달합니다.
- 필요한 경우 포스터 작업 디렉토리에서 git init을 수행하고 명확한 메시지와 함께 커밋합니다(기존 포스터를 반복할 때는 기준선을 먼저 커밋하여 이전 버전이 보존되도록 합니다).
- 중간 렌더링 및 임시 파일을 제거합니다. 재현 가능한 빌드 스크립트는 유지합니다.
<success_criteria>
- 결과물은 편집 가능한 .pptx와 일치하는 PDF(확인된 페이지 크기) 및 미리보기 PNG입니다.
- 차트는 네이티브 및 편집 가능하며(기본값) PowerPoint 열기 시 복구 프롬프트 없이 작동합니다.
- 모든 백분율이 소스 숫자로 재계산됩니다. n/N이 표시됩니다. 진행 중인 데이터의 경우 잠정적 프레이밍이 유지됩니다.
- 모든 인용은 실제이며 검증되었고 DOI/URL 하이퍼링크가 있습니다.
- 저자, 소속 및 로고가 사용자와 확인되었습니다.
- 초록에 명시된 모든 수치는 소스 데이터(데이터가 제공된 경우)에서 재현됩니다.
- 기준 미만 텍스트 없음(scripts/check_fonts.py), 겹치는 텍스트 없음(scripts/check_overlap.py), 1080p 뷰의 1:1 자르기에서 읽을 수 있음; 패딩은 숨 쉬는 듯하고, 대비는 강력하며, 열이 정렬됩니다.
- 모든 QR 코드가 렌더링에서 해당 링크로 정확히 디코딩됩니다. 자리 표시자는 파일을 DRAFT로 유지합니다.
- 하우스 스타일이 참조 포스터(제공된 경우)와 일치합니다.
- 별도 사본이 작성되었습니다. 사용자의 확정 파일은 그대로 유지됩니다.
… (원본에서 잘림)