Communitygithub.com

USTC-Astro/coffee_break_poster

MinerU 형식의 논문 디렉토리, PDF, arXiv URL 또는 직접 PDF URL로부터 한 화면짜리 천문학 커피 브레이크 포스터를 생성합니다. tools/ 아래의 결정론적 도구는 수집, 검사, 레이아웃 확인 및 렌더링에 사용하고, 에이전트는 요약, 그림 선택, 내러티브 디자인 및 HTML 편집에 사용하십시오.

coffee_break_poster란 무엇인가요?

이 스킬은 한 화면에 그림 중심의 천문학 커피 브레이크 포스터를 제작하는 도구 모음입니다. 빠른 arXiv 공유를 위해 설계되었으며, 독자가 15~30초 안에 논문의 핵심 요점을 파악할 수 있도록 합니다. 주요 목표는 논문을 축소하여 재현하는 것이 아니라, 왜 이 논문이 흥미로운지, 무엇을 주장하는지, 그리고 무엇을 얻을 수 있는지 전달하는 빠른 시각적 피치를 만드는 것입니다. 기본 청중은 광범위한 천문학 독자이며, 특별한 요청이 없는 한 전문가 전용으로 최적화하지 않습니다. 스킬은 `cbp` CLI를 통해 입력 정규화, 논문 인벤토리 검사, 포스터 스캐폴드 생성, 레이아웃 검사 및 렌더링을 수행합니다. 기본 포스터 구조는 배경, 지식 격차, 이 논문이 제시하는 것, 기억해야 할 주요 결과의 네 가지 텍스트 블록과 2~4개의 그림으로 구성됩니다. 에이전트는 논문의 내용을 선택적으로 읽고, 강력한 그림을 선택하며, 응집력 있는 내러티브를 구성하는 과학적/편집적 결정을 내려야 합니다. 또한 9:16 비율의 휴대폰 공유 카드도 지원하며, 이는 더욱 간결한 피치 형식을 취합니다. 최종 출력물은 검사 도구를 통과해야 하며, 레이아웃 문제가 있으면 반복적으로 수정합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add USTC-Astro/coffee_break_poster

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

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

문서

Coffee Break Poster

단일 화면의 그림 중심 천문학 커피 브레이크 포스터를 만듭니다.

이 스킬은 커피 브레이크 중 빠른 arXiv 공유, 저널 클럽, 세미나, 또는 복도 토론을 위한 것입니다. 목표는 논문을 축소판으로 재현하는 것이 아닙니다. 목표는 사람들이 멈춰 서서 보고, 왜 이 논문이 흥미로운지, 무엇을 주장하는지, 그리고 무엇을 얻을 수 있는지 기억하게 하는 것입니다.

기본 청중: 광범위한 천문학 독자. 사용자가 명시적으로 요청하지 않는 한, 전문가 전용으로 최적화하지 마십시오.

핵심 제품 목표

포스터는 논문에 대한 빠른 시각적 피치로 작동해야 합니다.

  • 독자는 15-30초 안에 핵심 요점을 이해해야 합니다.
  • 포스터는 완전하기보다 흥미로워야 합니다.
  • 주요 지적 작업은 판매 포인트 / 핵심 내용 / 이것이 중요한 이유를 드러내는 것이지, 방법론 세부 사항을 다시 말하는 것이 아닙니다.
  • 그림이 대부분의 정보를 전달해야 하며, 텍스트는 주의와 해석을 안내해야 합니다.

포스터를 다음으로 만들지 마십시오:

  • 기술 리뷰
  • 섹션별 논문 요약
  • 방법론 중심의 메모
  • 장식용 그림이 붙은 텍스트 벽

작업 디렉토리

  • 사용자가 작업 디렉토리를 제공하면 그 디렉토리를 사용하십시오.
  • 그렇지 않으면 /Users/chensj/repository/coffee_break_poster/work/<paper_slug>/를 사용하십시오.
  • 생성된 포스터를 설치된 스킬 디렉토리에 쓰지 마십시오.

전제 조건

이 스킬은 cbp CLI가 일반 패키지 설치 또는 이 리포지토리의 편집 가능 설치를 통해 PATH에서 사용 가능하다고 가정합니다.

예상 출력

단일 화면 16:9 HTML 포스터를 생성하여 확인하고 PNG/PDF로 렌더링할 수 있습니다.

WeChat/iPhone 스타일 공유의 경우, 대신 9:16 전화 공유 카드를 생성하십시오:

cbp scaffold PAPER_DIR --format phone --figure-count 1
cbp check PAPER_DIR/poster.html --format phone --json-out PAPER_DIR/layout.json
cbp render PAPER_DIR/poster.html --format phone --png --pdf

전화 형식은 완전한 논문 요약이 아닌 간결한 피치입니다. 하나의 주인공 그림과 1-2개의 보조 그림을 선호하고, 카피를 짧은 흥미 유발 문구, 왜 중요한가, 이 논문이 보여주는 것, 기억하세요로 다시 작성하십시오. 16:9 포스터의 텍스트를 세로 카드에 그대로 붓지 마십시오.

기본 포스터 구조는 정확히 다음 텍스트 블록으로 구성됩니다:

  1. 배경
  2. 지식 격차
  3. 이 논문이 제시하는 것
  4. 기억해야 할 주요 결과

더하기 2-4개의 그림과 짧은 캡션.

arXiv ID를 추론할 수 있는 경우, 오른쪽/헤더 메타데이터에는 클릭 가능한 arXiv 링크, 표준 arXiv DOI, 및 arXiv 초록 페이지로 연결되는 QR 코드가 포함됩니다.

실제로 왼쪽 텍스트 열은 하나의 간결한 주장처럼 읽혀야 합니다:

  1. 왜 사람들이 관심을 가져야 하는가?
  2. 이 논문 이전에 무엇이 빠져 있었는가?
  3. 이 논문은 무엇을 추가한다고 주장하는가?
  4. 어떤 증거가 그 주장을 기억할 만하게 만드는가?

워크플로우

1. 입력 정규화

cbp ingest INPUT --workdir work

2. 결정론적 논문 인벤토리 검사

cbp inspect PAPER_DIR --json

이를 사용하여 섹션, 이미지 파일, 치수 및 후보 캡션을 검사하십시오. 이 명령은 논문을 요약하지 않습니다.

3. 필요한 부분만 읽고 과학적/편집적 선택을 하십시오

paper.md를 선택적으로 읽으십시오. 전체 논문을 덤프하거나 의역하지 마십시오. 다음에 집중하십시오:

  • 초록과 결론
  • 핵심 주장을 이해하는 데 필요한 몇 문단
  • 사용할 그림 주변의 문맥

그런 다음 포스터 수준의 선택을 하십시오:

  • 주제만이 아니라 논문에서 배우는 것을 진술하는 헤드라인을 작성하십시오.
  • 흥미로운 천체물리학적 이해관계 또는 흥미 유발 요소를 구성하는 부제목을 작성하십시오.
  • 텍스트 블록이 하나의 일관된 이야기를 형성하도록 채우십시오.
  • 2-4개의 그림을 선택하십시오. 보통 기계적으로 슬롯을 채우기보다는 2-3개의 강력한 그림을 선택하십시오.
  • 신뢰에 필수적이지 않으면 방법을 짧게 유지하십시오.

4. 스캐폴드 및 편집

cbp scaffold PAPER_DIR

poster.html을 직접 편집하십시오. 기본 템플릿은 16:9이며, 왼쪽에 텍스트, 오른쪽에 그림이 있습니다.

이야기를 전달하는 그림만 사용하십시오. 약한 그림으로 슬롯을 채우지 마십시오. 포스터에 4개 미만의 그림이 필요한 경우, 빈 슬롯이나 약한 슬롯이 있는 2x2 그리드가 아니라 의도적으로 적은 수의 그림 레이아웃으로 스캐폴드하거나 수정하십시오:

cbp scaffold PAPER_DIR --figure-count 1
cbp scaffold PAPER_DIR --figure-count 2
cbp scaffold PAPER_DIR --figure-count 3

1-그림 템플릿은 하나의 큰 시각적 히어로를 사용합니다. 2-그림 템플릿은 주요 그림과 하나의 보조 패널을 사용합니다. 3-그림 템플릿은 하나의 큰 히어로 그림과 두 개의 보조 그림을 사용합니다. 선택한 그림이 4개의 슬롯으로 구성된 전체 그리드보다 과학적으로 더 강력할 때 이러한 모드를 사용하십시오.

전화 공유 카드의 경우, 명시적으로 세로 템플릿을 선택하십시오:

cbp scaffold PAPER_DIR --format phone --figure-count 2

사용자가 명시적으로 4개의 그림을 요청하는 경우에만 --figure-count 4를 전화 출력에 사용하십시오. 일반적으로 압축된 공유 이미지에는 너무 조밀합니다.

5. 검사 및 반복

cbp check PAPER_DIR/poster.html --json-out PAPER_DIR/layout.json

전화 출력의 경우, 형식을 인식하는 뷰포트를 사용하십시오:

cbp check PAPER_DIR/poster.html --format phone --json-out PAPER_DIR/layout.json

이것은 엄격한 게이트입니다. 검사에서 오버플로, 잘린 하위 요소, 너무 작은 그림, 깨진 이미지, 빈 그림 영역 또는 축소된 레이아웃 영역이 보고되면 poster.html을 편집하고 다시 실행하십시오. 도구는 레이아웃을 측정합니다. 에이전트는 내용, 그림 선택, 캡션 및 CSS를 조정해야 합니다.

무엇을 변경해야 하는지에 대한 간결한 설명을 보려면 다음을 실행하십시오:

cbp diagnose PAPER_DIR/poster.html

레이아웃 적응 순서:

  1. 산문과 캡션을 줄이십시오.
  2. 하나 이상의 그림이 부차적인 경우, 빈 슬롯을 채우는 대신 1-, 2-, 또는 3-그림 레이아웃으로 전환하십시오.
  3. 텍스트 크기, 캡션 크기, 헤더 높이, 그림 간격 또는 텍스트/그림 비율과 같은 CSS 변수를 조정하십시오.
  4. 이전 단계에서 측정된 문제가 해결되지 않는 경우에만 구조적 레이아웃을 변경하십시오.

6. 렌더링

cbp render PAPER_DIR/poster.html --png --pdf

전화 출력의 경우:

cbp render PAPER_DIR/poster.html --format phone --png --pdf

render는 먼저 레이아웃 검사를 실행하고 포스터가 통과하지 못하면 미리보기 출력을 덮어쓰지 않습니다. --force는 깨진 레이아웃을 디버깅할 때만 사용하고 최종 전달에는 절대 사용하지 마십시오.

편집 규칙

헤드라인

헤드라인은 논문이 우리에게 가르쳐주는 것을 말해야 합니다.

좋은 헤드라인의 특성:

  • 주제보다는 주장처럼 보임
  • 빠르게 훑어볼 수 있을 정도로 짧음
  • 비전문가 천문학 독자에게 기억에 남음
  • 논문의 가장 강력한 지식 증분에 기반을 둠

다음과 같은 헤드라인은 피하십시오:

  • 논문 제목을 다시 쓴 것
  • 모호한 주제 라벨
  • 실제 요점이 과학적 결과인데 방법 우선 프레임

부제목

부제목은 짧은 흥미 유발 문구여야 하며, 보통 한 문장입니다.

다음 중 하나에 답하는 데 사용하십시오:

  • 이 결과가 왜 놀라운가?
  • 어떤 더 큰 문제와 연결되는가?
  • 어떤 종류의 증거가 이 논문을 흥미롭게 만드는가?

긴 초록 같은 요약에 부제목을 사용하지 마십시오.

배경

배경은 다음에 답합니다:

  • 광범위한 천문학 청중이 왜 관심을 가져야 하는가?
  • 이것은 어떤 더 큰 천체물리학적 질문과 연결되는가?

실제 흥미 유발 요소가 아닌 한, 조사 이름, 표본 크기, 기기 세부 사항 또는 기술적 자격의 연쇄로 시작하지 마십시오.

지식 격차

지식 격차는 논문을 동기부여하는 정확히 빠진 조각이어야 합니다.

배경과 밀접하게 연결되어야 합니다. 좋은 격차는 이야기를 "이 영역이 중요하다"에서 "이 논문 이전에 우리가 여전히 설명하거나 확립할 수 없었던 것이다"로 날카롭게 합니다.

격차는 일반적으로 논문의 실제 기여 규모와 일치해야 합니다:

  • 사례 연구 논문 -> 사례 식별/해석 격차
  • 모집단 논문 -> 인구 통계/추세/비교 격차
  • 이론 논문 -> 메커니즘/일관성/예측 격차

포스터가 논문을 존재 증명 또는 방법 앵커로 명시적으로 구성하지 않는 한, 논문이 하나의 객체 증거만 제공하는데 모집단 수준의 질문을 하지 마십시오.

이 논문이 제시하는 것

이 섹션은 2-3 문장이어야 합니다.

다음에 답해야 합니다:

  • 논문이 우리에게 무엇을 믿도록 설득하려고 하는가?
  • 여기서 가장 강력한 지식 증분은 무엇인가?
  • 왜 이 논문이 커피 브레이크 동안 공유할 가치가 있는가?

이것은 리뷰 보고서가 아닙니다. 필요한 경우 완전히 가벼운 주의 사항을 포함할 수 있지만, 주요 임무는 논문의 가장 강력한 판매 포인트를 식별하는 것입니다.

기억해야 할 주요 결과

3-4개의 짧은 불릿을 사용하십시오.

각 불릿은 다음이어야 합니다:

  • 증거 중심
  • 기억할 수 있을 정도로 구체적
  • 판매 포인트와 명확하게 연결됨
  • 중요하지 않은 방법 세부 사항이 제거됨

"바쁜 독자의 핵심 내용"처럼 들리는 불릿을 선호하고, 노트북 조각처럼 들리는 불릿은 피하십시오.

이야기 논리: 섹션이 연결되어야 함

포스터는 네 개의 독립적인 요약이 아니라 하나의 주장으로 읽혀야 합니다.

필수 논리 체인:

  1. 배경은 왜 그 질문이 중요한지 설명합니다.
  2. 지식 격차는 이 논문 이전에 무엇이 빠져 있었는지 진술합니다.
  3. 이 논문이 제시하는 것은 논문이 무엇을 추가하거나 명확히 한다고 주장하는지 말합니다.
  4. 기억해야 할 주요 결과는 그 주장을 뒷받침하는 증거 또는 기억할 만한 결과를 제공합니다.

이야기가 그 순서로 흐르지 않으면 다시 작성하십시오.

피해야 할 일반적인 실패 모드:

  • 배경은 넓지만, 지식 격차는 다른 것에 관한 것입니다.
  • 판매 포인트는 일반적이며 명시된 격차에 답하지 않습니다.
  • 주요 결과는 논문의 사실이지만 판매 포인트를 뒷받침하지 않습니다.
  • 포스터가 한 질문을 하지만 다른 질문에 답합니다.
  • 텍스트가 기술적으로는 정확하지만 흥미롭지 않습니다.

그림 선택 규칙

독자가 이야기를 빨리 이해하는 데 도움이 되는 그림을 선택하십시오.

우선순위 순서:

  1. 대상, 표본 또는 문제를 정의하는 그림
  2. 주요 결과를 보여주는 그림
  3. 결과를 더 넓은 맥락 또는 비교에 두는 그림

보통 2-3개의 강력한 그림을 유지하십시오. 명확하게 서사적 가치를 더하는 경우에만 4번째 그림을 사용하십시오.

주로 다음인 그림을 피하십시오:

  • 방법 순서도
  • 모수 코너 플롯
  • 내부 검증
  • 너무 많은 설정이 필요한 전문가 진단

핵심 주장을 신뢰할 수 있게 만드는 유일한 방법이 아닌 이상 피하십시오.

그림 캡션

각 그림 캡션은 다음에 답해야 합니다:

  • 왜 이 그림이 여기 있는가?
  • 바쁜 독자가 이 그림에서 무엇을 기억해야 하는가?

캡션은 해석해야 하며 단순히 라벨을 붙이는 것이 아닙니다.

나쁜 캡션 스타일:

  • 요점을 말하지 않고 플롯 축을 설명
  • 패널 제목만 다시 말함
  • 과학적 의미가 아닌 절차적 세부 사항 설명

좋은 캡션 스타일:

  • 그림이 무엇을 확립하는지 말함
  • 왜 논문의 주요 주장에 중요한지 말함
  • 짧고 기억에 남는 표현 사용

방법: 기본 억제

방법 신뢰가 주장의 핵심이 아닌 이상 포스터 공간을 방법에 많이 할애하지 마십시오.

약간의 방법은 다음에 답할 때만 유용합니다:

  • 왜 이 해석을 신뢰해야 하는가?
  • 증거의 특별한 점은 무엇인가?
  • 이전 모호성을 깨는 것은 무엇인가?

방법이 그 부담을 지고 있지 않다면, 줄이십시오.

스타일

  • 제목 및 본문 글꼴 스택: Helvetica, Arial, sans-serif.
  • 부제목: 이탤릭체, 볼드체 아님, 동일한 Helvetica 스택 사용.
  • 지식 격차 / 강조 표시된 프롬프트는 "Gill Sans", "Gill Sans MT", Helvetica, Arial, sans-serif를 사용할 수 있습니다.
  • 긴 문단을 피하십시오.
  • 볼드체는 아껴서, 사람들이 실제로 기억해야 할 단어에만 사용하십시오.
  • 그림이 대부분의 정보를 전달해야 합니다.
  • 포스터는 스크롤 없이 하나의 일반적인 디스플레이에 맞아야 합니다.
  • 이미지 늘리기를 강제하지 마십시오. 그림의 종횡비를 유지하십시오.

렌더링 전 최종 자가 점검

렌더링 전에 다음을 확인하십시오:

  1. 논문을 읽지 않은 사람에게 포스터가 흥미로운가?
  2. 헤드라인이 실제 핵심 내용을 전달하는가?
  3. 배경과 지식 격차가 밀접하게 연결되어 있는가?
  4. 이 논문이 제시하는 것이 그 격차에 명확히 답하는가?
  5. 기억해야 할 주요 결과가 실제로 판매 포인트를 뒷받침하는가?
  6. 각 그림이 이야기의 특정 부분을 지원하는가?
  7. 독자가 15-30초 후에 논문의 핵심 요점을 설명할 수 있는가?
  8. 신뢰를 향상시키지 않는 방법 세부 사항을 제거했는가?
  9. 그림이 시각적으로 대부분의 정보를 전달하는가?
  10. check 후에 레이아웃이 깔끔하게 유지되는가?

어느 하나라도 '아니오'이면, poster.html을 수정하고 check를 다시 실행하십시오.

관련 스킬