생물학적 공정 단계 그림 — 컴파운드 플레이북
생물학, 생체재료, 조직공학 및 실험실 공정 단계에 대한 정확한 독립형 그림을 생성합니다.
신뢰 경계: 소스 검증된 매핑 카드만이 과학적 주장을 도입할 수 있습니다. 렌더 검사는 매핑 카드에 대한 픽셀 적합성을 확인하며, 소스 주장을 업그레이드하거나 생성할 수 없습니다. 스타일 및 참조 이미지는 과학을 결정하지 않습니다.
구조: 원자 → 분자 → 이 플레이북
이 스킬은 컴파운드(플레이북)입니다. 절차 자체를 포함하지 않으며, 분자(컴포지트)를 오케스트레이션하고, 분자는 명시적으로 원자(기능)를 체이닝합니다.
compounds (이 플레이북): 모드 선택, 분자 실행, 판단 유지
└─ composites/: 범위가 지정된 워크플로우, 명시적 원자 순서 (각 2-6개 원자)
└─ capabilities/: 단일 목적 프리미티브, 거의 결정론적
깊이는 의도적으로 두 수준으로 제한됩니다. 분자가 원자를 직접 호출하고, 원자는 다른 원자를 호출하지 않으며, 플레이북은 분자 이상으로 내려가지 않습니다. 더 깊은 그래프는 에이전트 신뢰성이 무너지는 지점입니다.
- 원자 (
capabilities/): 하나의 목표, 하나의 아티팩트, 기계적. 오케스트레이션에 대한 판단 없음. - 분자 (
composites/): "원자 X 호출 후 원자 Y 호출"과 같은 명시적 지침이 있는 범위가 지정된 태스크. 런타임 의사 결정을 최소화합니다. - 이 플레이북: 모드 선택, 순서 지정, 에스컬레이션 및 모든 것을 무효화하는 불변 규칙.
분자 맵
| 분자 | 파일 | 체이닝 원자 |
|---|---|---|
| analyze-project | composites/analyze-project.md | extract-source-text → analyze-entities → build-material-bible → extract-style-sheet (참조 이미지 있는 경우) |
| plan-step | composites/plan-step.md | write-mapping-card → check-mapping-card → 게이트 1 |
| render-step | composites/render-step.md | assemble-prompt → render-image → run-probe (예산 내에서 반복) |
| finalize-step | composites/finalize-step.md | fit-labels (+ build-evidence-package 요청 시) |
인테이크 — 시작 전 질문
태스크 시작 시, 질문 도구(ask)를 사용하여 사용자 설정 옵션을 한 라운드로 명확히 하고 파일을 건드리기 전에 진행합니다.
- 태스크 유형 — 워크플로우를 라우팅합니다 (아래 표).
- 태스크 모드 —
quick(탐색, DRAFT 상태 유지) 또는verified(최종 결과물). - 게이트 1 모드 —
strict_verified(인간 소스 확인) 또는agent_draft(인간 게이트 없음). - 소스 — 특허 / 논문 / 프로토콜 / DOCX / PDF / 붙여넣은 텍스트; 경로 또는 파일.
- 참조 이미지 — 제공됨 (스타일 전용) 또는 없음.
- 단계당 반복 예산 (기본값 5회 렌더).
- 결과물 — PNG만, PNG + 라벨, 또는 PNG + 라벨 + 증거 패키지.
- 모델 — 기본값
qwen-image-3.0-pro또는 카탈로그 조회 (capabilities/list-image-models.md,scripts/list_image_models.py) 후 사용자 선택;model_choice.json에 기록.
사용자가 한 라운드로 답변할 수 있는 옵션을 추측하지 마십시오. 기존 프로젝트를 계속할 때는 이전 답변을 재사용하십시오.
오케스트레이션
태스크 유형 → 워크플로우 라우팅
| 태스크 유형 | 실행할 분자 | 참고 |
|---|---|---|
| 단일 새 단계 그림 | plan-step → render-step (+ finalize-step (verified 모드인 경우)) | 프로젝트 바이블이 아직 없을 때만 analyze-project 실행 |
| 전체 그림 세트 (다중 단계) | analyze-project → 각 단계별: plan-step → render-step → finalize-step | 전체 파이프라인 |
| 기존 단계 렌더 수정 | render-step만 | 검증된 카드 재사용; 카드가 변경된 경우에만 게이트 1 재실행 |
| 승인된 렌더 재라벨링 | finalize-step (fit-labels만) | 재렌더링 없음 |
| 증거/감사 패키지 | finalize-step (build-evidence-package만) | 기존 아티팩트 인덱싱 |
| 스타일 탐색/스케치 | plan-step (agent_draft, 최소) → render-step | 출력은 DRAFT/UNVERIFIED 상태 유지 |
모드
quick— 탐색: 최소 매핑, agent_draft, 인간 게이트 없음, 라벨 없음, 증거 패키지 없음. 출력DRAFT/UNVERIFIED.verified— 최종 결과물: 전체 분석, strict_verified 게이트 1, 라벨링, 게이트 3, 선택적 증거 패키지.
각 분자는 명명된 아티팩트와 검증 상태로 끝납니다. 분자의 필수 출력을 절대 건너뛰지 마십시오. DRAFT/UNVERIFIED 출력 시: 명시적으로 상태를 밝히고 검증된 것으로 제시하지 마십시오.
필수 입력
- 과학적 소스 (특허 / 논문 / 프로토콜 / DOCX / PDF 텍스트 또는 사용자 설명) — 작업, 정체성, 상태에 대한 권위.
- 선택적 참조 이미지 (스타일 전용).
- 태스크 모드 및 게이트 1 모드.
필수 출력
생성된 각 단계에 대해 워크플로우는 다음을 반드시 생성해야 합니다.
| 파일 | 분자 | 내용 |
|---|---|---|
project_material_bible.yaml | analyze-project | 0단계 분석 (프로젝트당 한 번) |
stepN_mapping.yaml | plan-step | 매핑 카드 + 검증 상태 |
stepN_prompt.txt | render-step | 최종 프롬프트 원문 |
stepN_vXX.png + .json | render-step | 버전당 후보 하나 + 메타데이터 |
stepN_probe.yaml | render-step | 게이트 2 탐침 결과 |
stepN_labeled.png | finalize-step | 게이트 3 이후 (verified 모드) |
게이트
| 게이트 | 위치 | 검증 내용 |
|---|---|---|
| 게이트 1 | plan-step | 매핑 카드 ↔ 오픈 소스 (인간, 엄격 모드) |
| 게이트 2 | render-step | 렌더 ↔ 매핑 카드 (고정 탐침) |
| 게이트 3 | finalize-step | 라벨 ↔ 출시 픽셀 |
이 워크플로우의 다른 아티팩트는 진실 게이트가 아닙니다. 그 외 모든 것은 문서화, 위생 또는 실행 가능한 기반입니다.
필수 불변 규칙
- 소스는 작업, 정체성, 상태에 대해 권위적입니다.
- 구성을 위해 발명된 작업이나 과학적 개체는 없습니다.
- 반복되는 개체: 프로젝트당 하나의 표준 설명자; 정체성 토큰은 선언된 전환이 드리프트를 정당화하지 않는 한 안정적입니다.
- 불확실한 속성은 일반 또는 OPEN 상태로 유지되며, 조용히 해결되지 않습니다.
- 스타일 바이블 / 참조 이미지 ≠ 과학적 증거.
- 토폴로지는 검증된 매핑 카드에서 비롯됩니다.
- 라벨과 출시 픽셀이 일치합니다.
- API 성공 ≠ 시각적 또는 과학적 수용.
- 소스 검사를 건너뛰면
DRAFT/UNVERIFIED가 생성되며, 검증된 주장이 생성되지 않습니다.
저장소 구조
SKILL.md 이 플레이북 (컴파운드)
composites/ 분자
capabilities/ 원자
schemas/ 재료 바이블 / 매핑 카드 / 렌더 메타데이터 / 탐침용 JSON 스키마
adapters/ 렌더러별 계약 (dashscope.md)
scripts/ 일반 렌더러 (generate_image.py)
examples/ 작업된 아티팩트 (hydrogel_patent/)
.env.example 키 템플릿; 로컬에서 .env로 복사
확장
- 새로운 단일 목적 작업 →
capabilities/*.md추가, 기계적으로 유지, 스크립트나 스키마가 하나라면 하나만 제공. - 새로운 범위 지정 태스크 → 기존 원자를 체이닝하는
composites/*.md추가; 새 원자보다 기존 원자 재사용 선호. - 새로운 최상위 작업 → 이 플레이북 (또는 새 플레이북)에서 분자 구성.
- 다른 원자를 호출하는 기능은 정의상 분자입니다. 원자 계층을 더 깊게 만들지 마십시오.