Community이미지github.com

scientific-figure

참고 자료나 과학적 설명을 이해하여 깔끔하고 독립적으로 편집 가능한 SVG 객체로 다시 그립니다. 호스트의 비전 및 추론 기능과 결정론적 형상/렌더링/편집 도구를 사용하며, 추가 모델 API나 GUI가 필요하지 않습니다.

scientific-figure란 무엇인가요?

Scientific Figure Reconstruction & Drawing 스킬은 주어진 참고 이미지나 자연어 설명을 분석하여 고품질의 편집 가능한 과학적 그림(SVG 및 PNG)을 생성하는 독립적이고 공급업체 중립적인 스킬입니다. Claude Code, Cursor, Codex와 같은 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 호스트의 비전 및 추론 능력과 `figure-cli` 도구를 활용하여 결정론적 형상 생성과 렌더링을 수행합니다. 주요 기능으로는 참조 재구성, 자연어 기반 설계, 폰트 사전 검사, 레이아웃 감사(QA), 미리보기 루프, 및 최종 SVG 변형 내보내기가 있습니다. 사용자는 자율 모드와 대화형 모드 중 선택하여 작업할 수 있으며, 스킬은 기본적으로 3회의 대상 수정 라운드를 수행합니다. 호스트는 Python 또는 JavaScript로 그리기 프로그램을 작성하고, 엔진 유효성 검사, 렌더링 및 프로젝트 트랜잭션을 통해 생성된 씬(Scene)/계획(Plan) 후보를 검증합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/w1-23/scientific-figure/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

문서

Scientific Figure Reconstruction & Drawing

호스트가 무엇을 그릴지 결정하는 독립적이고 공급업체 중립적인 스킬입니다. 엔진은 선언된 형상, 채색, 레이어링, 편집 및 내보내기를 실행합니다. SVG와 해당 SVG에서 렌더링된 PNG를 제공합니다. Anaconda ScientificFigure_skill 환경과 설치된 figure-cli를 사용하세요.

0.10 가이드: 두 가지 작업, 하나의 호스트와 씬(Scene)

현재 Engine 0.10.0은 0.9 기반 위에 결정론적 레이아웃 QA(layout-audit), 경계 레이아웃 수정(--fix) 및 폰트 프로필 사전 검사를 추가했습니다. FigurePlan 0.1 및 Scene 0.3은 변경되지 않았으며, 0.8 실행, 편집 및 렌더링 기반은 유지됩니다. 호스트는 이미 해석 및 시각적 검토를 수행하는 모델이므로 두 번째 모델이나 에이전트를 추가하지 마십시오. 0.10 계획 및 QA 계약을 참조하세요. 0.9 계획, 0.8 기능 및 의미론적 계획/새로운 CLI 워크플로우는 아래의 모든 내용에 대해 여전히 유효합니다. 워크플로우 페이지는 구현된 진입점과 정확한 파일 계약을 정의합니다. 배송 노트는 실제 검증 및 한계를 기록합니다.

복잡한 그림을 구성하기 전에 작업 가이드를 선택하세요:

  • 참조 재구성: 참조 재구성을 읽으세요. 형상 작업 전에 정보 구조와 읽기 순서, 필수 부분, 관계 및 구체적인 불확실성을 확립하세요. 개체, 프로세스 화살표, 주석 지시선, 확대 보기, 범례 및 장식을 분리하세요. 주제 지식으로 읽을 수 없는 영역을 채우지 마십시오.
  • 자연어 설계: 텍스트 설계를 읽으세요. 사용자가 명시한 내용, 설계 선택 및 과학적 가정을 분리하세요. 요청된 메커니즘을 중심으로 계층을 설계하세요. 준비, 관리 또는 실험 조건을 임의로 만들지 마십시오.
  • 두 작업 모두: 방법이 불확실한 경우 구성 선택을 사용하세요. 필요한 모양, 부품, 반복, 구멍, 폐색 및 스타일에 따라 선택한 다음 실제 사용 가능한 리소스를 비교하세요. 단순한 평면 개체는 짧은 의도/불확실성 메모에서 바로 형상 및 미리보기로 이동할 수 있습니다. 필수적인 검색이나 여러 계획 파일이 필요하지 않습니다.

기본적으로 자율적으로 작업; 요청 시에만 일시 중지

모드시작 시점호스트 동작
autonomous (기본값)사용자가 그림을 요청하거나 완료하라고 말할 때그리고, 검사하고, 수정하고, 전달합니다. 각 단계에서 승인을 위해 일시 중지하지 마십시오.
interactive사용자가 샘플을 보거나 각 페이지를 확인하거나 참여하고 싶다고 요청할 때합의된 체크포인트를 게시하고 피드백이나 승인을 기다립니다.
  • 검토 페이지를 열어도 일시 중지가 강제되지는 않습니다. 자율 모드에서는 다음 안전한 체크포인트에서 새로운 피드백을 읽습니다. 사용자가 중지를 요청하면 후보 게시를 중단하고 먼저 사용자의 편집 내용을 처리합니다.
  • 대화형 모드에서는 첫 번째 합의된 페이지를 완료하여 게시하고, 기다렸다가 계속합니다. 다중 페이지 작업의 경우, 첫 번째 승인된 페이지가 공유 타이포그래피, 간격, 카드 스타일 및 팔레트 규칙을 수정합니다. 이후 페이지는 해당 규칙을 공유하지만 강제로 동일한 레이아웃을 따르지는 않습니다.
  • 이미지를 읽을 수 없는 호스트는 형상 및 구조적 검사를 사용할 수 있지만 시각적 검토는 not_executed로 남겨두어야 합니다.
  • 하나의 SVG 버전을 승인하는 것은 과학적 검토가 아니며 이후 버전을 승인하지 않습니다.

기본값: 이해, 선택, 구성, 검사, 수정

  1. 목적, 의도된 표시 크기, 모듈 및 읽기 순서를 명시합니다. 개체, 필수 내부 부품, 편집 가능한 단위, 레이블, 색상 의미 및 관계를 나열합니다. 해결되지 않은 콘텐츠는 명시적으로 남겨둡니다. 복잡한 그림의 경우, 광범위한 형상을 작성하기 전에 이 초안을 검사 가능하게 만드십시오. 유용한 경우 기존 FigurePlan 모듈/개체/관계를 사용하십시오. 선택되지 않은 구성은 unresolved로 남을 수 있습니다. 이는 다른 씬 트리가 아닌 하나의 계획 입력 단계입니다.
  2. 결정에 영향을 미치는 로컬 질문만 하십시오. 예를 들어, 창백한 영역이 구멍인지 표면인지, 또는 지시선이 끝나는 위치 등입니다. 원본 및 관련 자르기를 검사하고 필요한 경우에만 소스 기반 증거를 사용하십시오. ROI 및 좌표 매핑을 유지하십시오. 측정 및 유사도 점수는 개체 ID 또는 과학적 신뢰도가 아니라 관찰 결과입니다. 암시적 OCR은 없습니다.
  3. 구조와 스타일에 따라 레시피/에셋/직접/프로그램을 선택합니다. 실제 레시피 매개변수 및 편집 가능한 부품 키 또는 에셋 권리 및 가져오기 제한을 확인하십시오. 카탈로그에는 15개의 레시피 제품군, 두 개의 심볼 제품군 메타데이터 항목 및 하나의 Twemoji 레몬 에셋이 있습니다. 마우스/플라스크/아바타 레시피를 임의로 만들지 마십시오. 레시피에 필수 부품이 누락된 경우 해당 구성을 거부하고 자유 프로그램으로 대체하고, 선택적으로 적합한 하위 부품을 결합합니다. 로컬 좌표, 곡선, 변환, 기존 그리기 함수 및 성숙한 라이브러리를 사용하십시오. 직접 씬, 레거시 의미론적 Plan 0.3 및 SceneBuilder는 여전히 유효합니다. 그리기 전에 대규모 수동 JSON을 요구하지 마십시오.
  4. 먼저 주요 구조와 필수 내부를 구축한 다음, 커넥터와 레이블을 구축합니다. 안정적인 개체/파트 ID를 유지합니다. 채워진 표면, 획, 실제 구멍, 경계 마스크/폐색, 반복 및 그래디언트를 적절히 사용합니다. 플랫 아트에 볼륨 조명을 추가하지 마십시오. 호스트는 일반 도구를 통해 명시적으로 프로그램을 실행하고 생성된 씬 조각을 제공합니다. 확인/컴파일 및 프로젝트 로딩은 저장된 소스를 실행하지 않습니다. 새 후보를 편집된 프로젝트와 별도로 유지하고 수락 전에 B/U/C 병합을 사용하십시오.
  5. 의도된 표시 크기로 실제 preview.png를 읽고 주요 확대 영역을 검사합니다. 모듈 및 연결 → 실루엣/비율/구멍 → 필요한 내부 구조 → 색상/레이어 → 텍스트를 확인합니다. 동일한 규모로 참조를 비교합니다. 이전 그림을 대체할 때는 참조/이전/새 그림을 함께 비교합니다. 유효한 계획, 명명된 경로 또는 통과 테스트는 의도된 구조가 올바르게 그려졌음을 확립할 수 없습니다.
  6. 각 발견 사항을 ID와 구체적인 조치에 연결합니다: 구성 방법 변경, 후보 교체, 형상/매개변수 조정, 로컬 증거 획득 또는 불확실성 유지. 현재 개정판에 대해 패치를 적용하거나 후보를 재생성하여 병합하고, 다시 렌더링하고 검사합니다. 기본적으로 최대 3번의 대상 수정 라운드를 수행합니다. 승인된 개체와 사용자 편집을 유지합니다. 시각적 평가를 현재 씬/미리보기에 바인딩합니다. 변경된 형상, 리소스 또는 렌더링은 이전 평가를 만료시킵니다. 누락된 부분과 실행되지 않은 검토를 보고합니다. 과학적 검토는 별도로 유지되며 요청되지 않은 경우 실행되지 않습니다.

성공은 잘 그려지고 구조적으로 명확하며 주요 부품을 독립적으로 편집할 수 있는 그림을 의미합니다. 테스트는 엔지니어링 동작을 설정하며 그리기 품질을 설정하지 않습니다. 독립 호스트 절제, 비공개 벤치마크 캠페인, 인간 패널, 도메인 인증, 런타임 통합, 교차 버전 템플릿 마이그레이션 및 실험적 오프셋/가변 너비 개발은 현재 작업 범위를 벗어납니다. 이를 필수 조건이나 원치 않는 다음 작업으로 만들지 마십시오. 실제 재사용을 외부 아트워크, 드로잉 코드 재사용 및 형상/렌더링 라이브러리 재사용으로 별도로 보고합니다. 레지스트리에 에셋이 있다고 해서 이 그림이 그것을 사용했다는 의미는 아닙니다.

호스트는 Python 또는 JavaScript 드로잉 프로그램을 작성할 수 있습니다. 일반 변수, 함수, 로컬 좌표, 변환, 반복 및 성숙한 형상 라이브러리를 사용하여 모양을 계산합니다. 사용 가능한 경우 안정적인 엔진 헬퍼를 사용합니다. 그림별 드로잉 프로그램은 허용됩니다. 몇 개의 참조 그림을 주제별 엔진 알고리즘으로 만들거나 예제 계획을 과학적 템플릿 라이브러리로 취급하지 마십시오. 생성된 씬/계획 후보를 엔진 유효성 검사, 렌더링 및 프로젝트 트랜잭션을 통해 보냅니다. 편집된 프로젝트에 대해 다시 실행할 때는 변경 사항을 수락하기 전에 마지막으로 생성된 기준선, 현재 씬 및 새 후보를 비교합니다. 사용자 편집을 유지하고 충돌을 보고합니다. 사용 가능한 구성 헬퍼 및 생성 프로토콜을 사용합니다: generation diff PROJECT --candidate SOURCE --output DIFF, 제안된 미리보기 및 충돌을 검사한 다음 generation accept PROJECT --candidate DIFF --base-revision N. 저장된 소스는 비활성 상태입니다. 수락은 병합을 다시 계산하고 현재 개정판/콘텐츠/영수증을 확인합니다. 순수 스크립트 출력으로 편집된 프로젝트를 덮어쓰지 마십시오. 래스터 이미지를 포함하거나, 모든 텍스처를 작은 경로로 추적하거나, 누락된 구조를 매력적인 채우기로 대체하지 마십시오.

제공된 참조의 재구성과 허용된 리소스 재사용 중에서 그리기 전에 선택합니다. 별도로 공개합니다: 외부 아트워크(출처, 라이선스, 버전/해시 및 수정 사항), 재사용된 드로잉 코드(자신의 함수를 포함하여 파일/버전, 재사용된 부분 및 변경 사항), 형상/렌더링 라이브러리(실제 라이브러리/버전 및 역할). 로컬로 작성된 함수는 외부 에셋이 아니며 라이브러리 호출은 차용된 아트워크가 아닙니다. 방법 영감을 복사된 코드와 별도로 기록합니다. 복사된 외부 코드에는 고정된 소스 개정판, 파일, 라이선스 및 고지 사항이 필요합니다. 명시적으로 고정된 래스터 비교의 경우 공식 소스 SVG를 절대 대체하지 마십시오. 동일한 수정 예산 내에서 실제 미리보기에서 주요 구조, 형상/구멍/폐색, 스타일/텍스트를 검사합니다. 배경색 덮개 패치는 실제 구멍이나 편집 가능한 인터레이싱을 설정하지 않습니다. 프로그램 소스는 재현성 입력입니다. 승인된 씬만이 유일한 현재 편집 가능한 권위자입니다. 프로젝트나 번들을 열면 드로잉 프로그램이 실행되어서는 안 됩니다.

파일로 실행, 모델 서비스 없이

conda run -n ScientificFigure_skill figure-cli doctor --json

소스 크기/해시에 대해 inspect reference.png를 사용합니다. 소스 바운드 계획은 SHA-256, 크기 및 ROI를 선언합니다. 레거시 Plan 0.3 의미론적 실행은 암시적으로 컬러 분할, 픽셀 후보 검색 또는 골격 분석을 실행하지 않습니다. 이전 Plan 0.1/0.2 입력은 동작을 유지합니다.

conda run -n ScientificFigure_skill figure-cli reconstruct reference.png --plan plan.json --output work/figure

초안 미리보기 루프 및 단계 타이밍

draw 및 reconstruct는 --preview를 허용합니다: figure.svg, preview.png 및 preview.json만 작성하고, --scale이 달리 지정하지 않는 한 축척 1에서 렌더링하며, 이전 미리보기를 대체할 수 있습니다. 프로젝트나 인도물이 아닙니다(영수증, 객체 매니페스트, QA 레코드, 검토 바인딩 또는 참조 비교 없음). 따라서 첫 번째 보기와 각 수정 라운드에 사용하고, 구조가 올바르면 --preview 없이 동일한 명령을 한 번 실행하십시오.

conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview

두 경로 모두 timings을 초 단위로 반환합니다: validate, to_svg, render, inventory, qa, publish, total; 미리보기는 전달 단계를 생략하며 영수증은 동일한 사전 게시 단계를 기록합니다. 이 호스트에서 501개 객체 씬은 미리보기로 약 0.33초, 전체 프로젝트로 약 1.16초가 소요되며, 대부분의 차이는 축척 1 대 3에서 PNG 렌더링에서 발생합니다. 엔진은 모델 측 시간을 볼 수 없습니다: 재구성을 측정할 때 이러한 숫자와 함께 호스트의 첫 번째 추론, 출력 토큰 및 수정 라운드를 기록하고 엔진 초를 모델 지연 시간이나 그 반대로 절대 귀속시키지 마십시오.

복잡한 구성 전에 텍스트 및 폰트 확인

그림이 그릴 모든 문자열(레이블, 수식, 단위, 축 텍스트, 범례)을 하나의 요청으로 수집하고 형상 작업 전에 이것을 실행하십시오:

{"schema_version": "0.1", "texts": ["세포막", "H₂O → O₂", "细胞膜"]}
conda run -n ScientificFigure_skill figure-cli font-probe texts.json --output work/fonts

status: ok는 하나의 실제 로컬 폰트를 선택하고 font-probe.json 및 font-probe-sample.png를 작성합니다. needs_input은 누락된 문자와 얼굴별 적용 범위를 나열합니다. --font PATH는 특정 파일을 추가합니다. --profile(기본 이름 scientific-default)은 추가로 패키징된 권장 사항(Times New Roman / Microsoft YaHei / Cambria Math)을 설치된 폰트에 대해 해결하고 각 역할의 경로, 얼굴, 다이제스트 및 누락된 샘플 문자를 보고합니다. 누락된 제품군은 누락된 것으로 보고되고 대체되지 않습니다. 엔진은 하나의 제품군을 렌더링하므로 혼합 폰트 대체를 주장하지 마십시오. SCIENTIFIC_FIGURE_FONT를 직접 선택한 경로로 설정하거나 텍스트를 단순화하십시오. 여러 페이지의 경우, 페이지 1 전에 모든 페이지의 합집합을 한 번 프로브하십시오. 누락된 글리프는 마지막 순간 내보내기 오류가 아니라 구성 결정입니다.

그리는 동안 그림 표시

conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
conda run -n ScientificFigure_skill figure-cli review-serve work/quick --open
conda run -n ScientificFigure_skill figure-cli review-status work/quick-review

review-serve는 가장 최근에 성공적으로 게시된 figure.svg를 127.0.0.1에서 임의의 토큰과 함께 제공하고 URL을 출력한 후 차단합니다. 페이지는 다시 로드해도 확대/축소, 이동 및 전송되지 않은 핀을 유지하며, 사용자가 개체 ID나 빈 공간에 주석을 고정할 수 있도록 합니다. review-status는 피드백 로그를 읽습니다. --wait --timeout N을 추가하여 새 라운드가 도착할 때까지 차단합니다. 그렇지 않으면 Ctrl-C로 중지합니다. 서버는 그림을 읽고 피드백을 작성만 합니다. 프로젝트를 편집하지 않습니다.

피드백은 <preview>-review/feedback.json에 저장되며, 교체 가능한 미리보기 디렉토리 외부에 있으며, 모든 제출은 표시된 SVG SHA256 및 개정판에 바인딩됩니다. 이전 버전의 제출은 HTTP 409로 거부되며, 절대 자동으로 적용되지 않습니다. 승인된 댓글은 일반 패치 또는 생성 병합을 통해 적용한 다음 새 미리보기를 게시합니다. 로컬 페이지는 브라우저 폴백입니다. VS Code 사이드바를 생성하지 않으며, 포함된 호스트는 여전히 피드백을 이 버전 관리 파일로 처리해야 합니다.

그래픽 전용 및 최종 SVG 제공

conda run -n ScientificFigure_skill figure-cli export-variants work/figure --output deliverables/figure

이것은 하나의 검증된 프로젝트를 읽고 figure.final.svg 및 figure.graphics.svg(텍스트 없음)와 variants.json을 작성합니다. 둘 다 동일한 씬에서 제공되므로 공유 ID는 동일한 형상과 스타일을 유지합니다. 다시 그려지지 않습니다. 최종 SVG는 전체 프로젝트 인도물입니다. 그래픽 전용 SVG는 출판사 호환 텍스트 없는 그림, 해상도 독립적 참조 자료 및 대체 기계 판독 가능 표현을 위해 사용됩니다. 기본 좌표계는 왼쪽에서 오른쪽, 위에서 아래로이며, 뷰박스는 사회 과학 저널의 최대 8.5인치 너비 텍스트 영역에 맞는 612×792(Letter) 또는 595×842(A4)에서 시작합니다. 포스터, 슬라이드, 태블릿 초상화, 배너, 긴 패널 및 관례적으로 조정된 말풍선은 허용되며 완전히 정의되었습니다. 그리기 전에 축척을 선택합니다. 미리보기 축척 제한을 넘어 확대/축소하면 동일하지 않은 모양을 생성합니다.

변형은 var_readme.json에 설명된 키로 읽습니다. 읽는 사람은 표시 및 필요에 맞는 변형을 선택하고, SVG 인라인 렌더링이 figure.graphics.svg에서 텍스트를 안정적으로 생략하는지 확인합니다. 일반적으로 최종 SVG를 인라인 SVG로 포함하고, 별도로 수집된 그래픽 SVG와 var_readme.json 사본을 제공합니다. variants.json 매니페스트는 페이지 ID, 사용된 폰트, 용지 크기 및 페이지당 미리보기 썸네일 경로를 기록합니다.

~/.scientific_figure/rc 구성

호스트는 이 규칙을 작성하고 inspect ~/.scientific_figure/rc를 사용하여 읽습니다. 스킬이 시작될 때 존재하는 모든 것을 읽습니다.

[fonts]
SCIENTIFIC_FIGURE_FONT = "/usr/share/fonts/truetype/times.ttf"
[fc]
SCIENTIFIC_FIGURE_FONT_MONO = "Fira Code:style=Regular"
[paths]
SCIENTIFIC_FIGURE_DATA = "/home/user/data/scientific_figure"

구축 확인

figure-cli doctor --json

다음을 포함한 진단을 생성합니다:

  • figure_cli_version
  • engine_version
  • fonts: status (ok/partial/missing), installed_fonts, profiles
  • python_version
  • node_version
  • screenshot_capable: true (원격 호스트는 거짓)
  • xvfb_available
  • conda_env
  • disk_space_mb_free
figure-cli construct --list

사용 가능한 구성 유형을 나열합니다:

  • recipe
  • asset
  • symbol
  • program

정확성이나 적용 가능성에 대한 주장 없이. program은 항상 존재합니다(제한 없음). recipe 및 asset은 특히 적용 가능한 것으로 선택됩니다. symbol에는 적용 가능한 메타데이터가 필요합니다. 존재하는 모든 것을 나열하는 것은 무의미합니다.

문제 해결

증상가능한 원인해결 방법
generate --help가 예상치 못한 옵션을 표시함0.7 이전 엔진conda run -n ScientificFigure_skill pip install --upgrade figure-cli
font-probe가 needs_input을 반환함누락된 폰트/문자다른 폰트를 사용하거나 --font로 추가하거나 텍스트 단순화
미리보기가 실제 그림과 일치하지 않음축척이 다른 렌더링미리보기에 --scale 사용
프로젝트를 열 수 없음손상된 프로젝트 또는 버전figure-cli doctor --json 실행
review-serve가 연결을 거부함이전 포트/토큰프로세스 중지, 디렉토리 정리, 재시도

엔진 제한을 하나의 진단 로그만으로 동작 제한으로 착각하지 마십시오. 위의 매개변수가 정상인데도 문제가 지속되면 엔진의 개체 수 제한 또는 형상 복잡성 임계값을 초과한 것일 수 있습니다. 최종 SVG의 개체 및 경로 수를 확인하는 것은 그리기 전 검증의 일부가 아닙니다.

관련 스킬