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
확인 사항:
- 모든 관계의 끝점은 선언된 엔터티입니다(연결되지 않은 화살표 없음).
- 모든 관계에는 출처 증명 또는 출처 인용이 있습니다.
- 차트 범례 레이블과 값이 소스 데이터와 정확히 일치합니다.
- SVG에
<text>(선택 가능) 및 최소 2개 레이어가 있습니다. - 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가 작성하며, 존재하면 함께 복사합니다
반드시 지켜야 할 규칙
- 엔터티는 자료에서 비롯됩니다. 조작된 유전자 이름, 농도 또는 시간 지점이 없어야 합니다. 모델이 추가하는 모든 것은 출처가 명시되고 표시되어야 합니다.
- 관계 방향은 데이터입니다.
A activates B는 A → B로 그리며, 절대 반대로 그리지 않습니다. 화살표 유형은 관계 유형을 따릅니다. - 범례 ⇄ 데이터 일관성. 범례 레이블과 색상은 막대와 동일한 배열에서 비롯됩니다. 데이터를 변경하면 범례도 변경됩니다.
- 편집 가능한 소스 + 규정 준수 내보내기. 항상 SVG(편집 가능)와 PDF/PNG(내보내기)를 함께 제공합니다.
- 내보내기는 확인되며, 가정되지 않습니다. 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가 필요합니다. 모델은 결정론적 추출기가 놓친 엔터티/관계를 항상 출처와 함께 채워야 합니다.