Community이미지github.com

schemdraw

편집 가능하고, 출처 추적이 가능한 과학적 개요도 및 차트를 생성합니다: 자료에서 엔터티와 방향 관계를 추출하고, 이를 계층적 SVG로 그리며 텍스트를 선택 가능하게 만들고, 차트 범례/색상을 원본 데이터에 매핑하며, 저널 해상도로 PDF+PNG를 내보내고, 모든 요소가 출처로 거슬러 올라가는지 검증합니다.

schemdraw란 무엇인가요?

이 스킬은 과학적 개요도와 차트가 **정확성, 편집 가능성, 내보내기 규정 준수**라는 세 가지 핵심 요구사항을 충족하도록 설계되었습니다. 주요 기능은 (1) 텍스트 또는 제공된 목록에서 엔터티와 관계를 추출하고, (2) 엔터티를 계층적 SVG로 배치하며 텍스트 레이블을 선택 가능하게 유지하고, (3) 동일한 소스 데이터로 차트와 범례를 구성하여 불일치를 방지하며, (4) 출판 준비가 완료된 해상도로 PDF 및 PNG로 내보내고, (5) 모든 엔터티, 관계 및 내보내기 조건이 충족되었는지 검증하는 파이프라인으로 구성됩니다. Claude Code, Cursor, Codex 등 플랫폼과 무관하게 사용할 수 있으며, 명령줄 스크립트를 통해 재현 가능한 방식으로 작동합니다. 실패 조건(예: LibreOffice 누락)을 명시적으로 보고하고, 검증 단계를 통과해야만 유효한 출력으로 간주됩니다. 과학적 출처 추적 가능성, 차트-범례 일관성, 벡터 내보내기 지원이 중요한 연구자 및 출판 준비 작업에 특히 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iakRulan/schemdraw/tree/HEAD

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

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

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

문서

schemdraw — 출처 추적이 가능한 편집 가능한 과학 개요도

스크립트 경로: 이 스킬은 /skills/weekly-skill/에 설치되어 있으며, 스크립트의 절대 경로는 /skills/weekly-skill/scripts/입니다(작업 디렉토리는 /app/work이므로 상대 경로를 사용하지 마십시오).

정확하고, 편집 가능하며, 내보내기 규정을 준수하는 그림을 생성합니다: 모든 엔터티/관계는 자료로 추적 가능하고, 범례는 데이터와 일치하며, 텍스트는 선택 가능한 상태로 유지되고, 내보내기는 목표 해상도를 충족합니다. 이 스킬이 방지하고자 하는 실패 모드는 다음과 같습니다: 잘못된 엔터티 관계, 조작된 유전자 이름이나 농도, 데이터와 불일치하는 범례, 편집할 수 없는 비트맵 전용 출력이 포함된 예쁜 그림.

한 줄 요약 방법: 자료에서 엔터티/관계 추출 → 계층적 SVG로 배치(그룹화, 선택 가능한 텍스트, 관계 유형에 따른 화살표 방향) → 동일한 소스 데이터로 명시적 범례/색상 맵을 사용한 차트 구성 → PDF+PNG 내보내기 → 추적 가능성 및 내보내기 계약 검증.

사용 시기

  • 입력: 과학 자료, 선택적 엔터티/관계 목록, 차트 데이터 및 내보내기 사양이 포함된 케이스 파일(기본값 /input/case.json)
  • 출력: /app/output 아래 — figure.svg, chart.svg, figure.pdf, figure.png, entities.json, export_report.json, validation.json, result.json
  • SVG는 편집 가능한 소스이며, PDF/PNG는 내보내기 결과물입니다.

파이프라인 (순서대로 실행)

1단계 — 추출 및 그리기

python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
  • 각 자료(텍스트/Markdown)를 읽고, 제공된 entities/relations를 패턴에서 추출된 관계와 병합합니다: X activates|promotes|enhances Y, X inhibits|suppresses|blocks Y, X -> Y, X --| Y, X binds|interacts with Y, X contains|includes Y.
  • 모든 관계는 provenance(text-pattern + 출처 인용)를 가지거나 제공된 목록에서 가져옵니다.
  • entities.json과 계층적 figure.svg를 작성합니다: <g id="arrows">(data-source/data-target/data-type 포함), <g id="nodes">(엔터티당 하나의 그룹과 <text> 레이블 포함). 화살표 색상/대시는 관계 유형을 인코딩합니다(초록 = 활성화, 빨강 = 억제, 점선 = 포함).
  • 케이스에 차트 데이터가 있으면 chart.svg를 작성하며, 막대에는 data-label/data-value가 있고 범례는 막대와 동일한 팔레트 인덱스를 사용합니다.

2단계 — 내보내기

python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300

LibreOffice headless가 SVG → PDF로 변환(벡터, 선택 가능한 텍스트)하고, PyMuPDF가 PDF를 요청된 DPI로 PNG로 래스터화합니다. export_report.json을 작성합니다. LibreOffice가 없으면 보고서에 명시되고 상태가 partial이 됩니다 — 절대 자동 실패 처리가 아닙니다.

3단계 — 검증

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work

확인 사항:

  1. 모든 관계의 끝점은 선언된 엔터티입니다(연결되지 않은 화살표 없음).
  2. 모든 관계에는 출처 증명 또는 출처 인용이 있습니다.
  3. 차트 범례 레이블과 값이 소스 데이터와 정확히 일치합니다.
  4. SVG에 <text>(선택 가능) 및 최소 2개 레이어가 있습니다.
  5. PDF 및 PNG 내보내기가 존재하며 PNG가 의심스러울 정도로 작지 않습니다.

4단계 — 결과물 복사

mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
   /app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json은 validate.py가 작성하며, 존재하면 함께 복사합니다

반드시 지켜야 할 규칙

  1. 엔터티는 자료에서 비롯됩니다. 조작된 유전자 이름, 농도 또는 시간 지점이 없어야 합니다. 모델이 추가하는 모든 것은 출처가 명시되고 표시되어야 합니다.
  2. 관계 방향은 데이터입니다. A activates B는 A → B로 그리며, 절대 반대로 그리지 않습니다. 화살표 유형은 관계 유형을 따릅니다.
  3. 범례 ⇄ 데이터 일관성. 범례 레이블과 색상은 막대와 동일한 배열에서 비롯됩니다. 데이터를 변경하면 범례도 변경됩니다.
  4. 편집 가능한 소스 + 규정 준수 내보내기. 항상 SVG(편집 가능)와 PDF/PNG(내보내기)를 함께 제공합니다.
  5. 내보내기는 확인되며, 가정되지 않습니다. DPI, 글꼴 포함 및 파일 존재 여부가 기록되며, 실패한 내보내기는 보고됩니다.

예외 처리

상황동작
자료 없음 / 비어 있음빈 엔터티 목록; SVG는 여전히 제목과 함께 작성됨
관계 끝점을 알 수 없음entities에 유지(패턴에서 추가됨)되고 그려짐
차트 데이터 없음chart.svg 건너뜀; entities.json.chart_svg = null
LibreOffice 없음PDF/PNG 누락, export_report.status = partial, 제한 사항 기록
관계 없음노드만 있는 SVG; 검증에서 0개의 관계를 기록

자체 점검

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"

valid: true가 필요합니다. 모델은 결정론적 추출기가 놓친 엔터티/관계를 항상 출처와 함께 채워야 합니다.

관련 스킬