CeobeFA333/codex-scientific-diagram-visio

과학 모델 다이어그램 Visio

네이티브 편집 가능한 객체를 사용하여 Microsoft Visio로 과학적 아키텍처 그림을 생성하거나 수정합니다. 과학적 정확성, 읽기 쉬운 기하학, 편집 가능성을 각각 별도의 게이트로 취급하여, 세 가지 모두를 통과한 후에야 최종 결과물을 전달합니다.

모드 선택

• 전체 재구축: 검증된 모델 계약(contract)과 시각적 참조를 기반으로 요청된 페이지를 처음부터 구성합니다.
• 부분 수정: VSDX를 백업하고 명명된 스테이지, 심볼, 치수, 커넥터, 타이포그래피 또는 간격만 변경합니다.
• 감사/내보내기: 기존 VSDX를 검사하고, 승인된 결함만 수정한 후 다시 열어 PDF와 300 DPI PNG를 내보냅니다.

소스 로직이 코드, 설정, 원고, 기존 그림 전체에서 일치하지 않으면 먼저 scientific-model-diagram-prompting을 사용하거나 handoff-contract.md의 증거 통과(evidence pass)를 수행하세요. 절대 시각적 외형만으로 융합 연산(fusion operation)이나 텐서 차원을 추론하지 마십시오.

필수 작업 흐름

1. 대상 모델 확정

스테이지 순서, 모든 경계에서의 텐서 형태, 연산 의미론, 학습 가능한 파라미터, 융합 규칙, 분류기 너비, 클래스 개수, 정확한 라벨을 포함하는 모델 계약을 생성합니다. 코드나 원고가 있을 때는 소스 파일과 줄 번호를 인용하세요.

사용자가 명시적으로 다른 대상을 선택하지 않는 한 이 증거 우선순위를 적용합니다:

1. 성공적으로 구축되거나 실행된 모델;
2. 훈련 구현 및 실험 설정;
3. 원고의 방정식 및 방법 텍스트;
4. 기존 VSDX 또는 래스터 그림;
5. 생성된 시각적 참조.

그리는 도중에 아키텍처를 실질적으로 변경할 정도의 해결되지 않은 모순이 발견되면 중단하고 보고하세요. 필요한 핸드오프 스키마는 handoff-contract.md를 참조하세요.

2. 소스 보호 및 작업 파일 격리

• 편집 전에 원본 VSDX와 정확한 출력 경로를 확인합니다.
• 사용자의 명명된 작업 디렉토리를 사용합니다. 지정되지 않은 경우 형제 _visio_work 디렉토리를 만듭니다.
• 스크린샷, 참조 래스터, 타임스탬프가 있는 백업, 임시 내보내기, QA 렌더링, 도우미 출력물을 모두 해당 작업 디렉토리 안에 보관합니다.
• 첫 번째 변경 전에 원본 VSDX를 백업합니다. 유일한 복사본을 덮어쓰지 마십시오.
• 사용자가 승인하고 작업 로그에 페이지 이름을 기록한 경우에만 관련 없는 페이지를 제거합니다.

3. Microsoft Visio 의도적으로 제어

computer-use Windows 자동화 스킬을 사용 가능할 때 활용합니다. 새 세션의 첫 UI 작업 전에 런타임을 초기화하고 sky.documentation("guidance")를 읽습니다. 확인이 필요한 작업 전에는 sky.documentation("confirmations")를 읽습니다. 응용 프로그램/창 ID로 Visio 창을 대상으로 지정하고, 맹목적인 좌표 시퀀스 대신 스크린샷을 검사합니다.

VSDX를 Microsoft Visio에서 엽니다. 사용자가 Visio를 요청했을 때 Visio 실행을 래스터, SVG 스크린샷, PowerPoint 또는 일반 다이어그램 편집기로 대체하지 마십시오.

Visio를 제어하기 전에 visio-execution.md를 읽으세요.

4. 세부 사항보다 기하학 우선 구축

모듈을 배치하기 전에 페이지 크기, 방향, 여백, 레이어, 스테이지 컨테이너, 행 기준선, 커넥터 경로를 설정합니다. 좌표 계획과 반복되는 기하학을 사용하여 병렬 분기를 처리합니다.

반복되는 구성 요소에 대해 재사용 가능한 네이티브 마스터 또는 그룹화된 셰이프를 만듭니다. 피연산자, 연산자, 치수, 커넥터는 독립적으로 유지합니다. 3D 직육면체는 편집 가능한 앞/위/옆 면 그룹으로 유지되어야 합니다. 페이지를 평탄화(flatten)하지 마십시오.

레이아웃 토큰, 글꼴 크기, 직육면체 구성, 커넥터, 그룹화 및 사용자의 출판 표준에 대해서는 layout-and-style.md를 사용하세요.

5. 패스(pass)별로 그리기

다음 패스를 순서대로 수행합니다:

1. 페이지, 레이어 및 컨테이너;
2. 반복되는 행 가이드 및 커넥터 경로;
3. 모듈 및 재사용 가능한 직육면체;
4. 수학적 피연산자 및 독립 연산자;
5. 연결점에 접착된 커넥터;
6. 라벨, 치수, 범례 및 캡션;
7. 정렬, 분산 및 지역적 그룹화;
8. 미리보기 배율과 원본 세부 수준에서의 시각적 정리.

각 주요 패스 후에 작업 디렉토리에 스크린샷을 캡처합니다. 부분 수정 요청 시에는 영향을 받는 영역만 변경하고 해당 영역의 들어오고 나가는 연결을 다시 확인합니다.

6. 경로(Routing) 및 가독성 확보

• 완벽하게 수평인 분기선과 직각 굽힘을 선호합니다.
• 텍스트를 배치하기 전에 빈 커넥터 레인을 확보합니다.
• 모든 기능적 커넥터를 명시적 연결점에 접착합니다.
• 텍스트, 연산자, 직육면체, 플롯 카드 또는 다른 화살촉 위로 선을 절대 통과시키지 않습니다.
• 병렬 행의 높이와 간격을 동일하게 유지합니다. 눈대중보다는 정렬(Align) 및 분산(Distribute) 도구를 사용합니다.
• 텍스트를 최소 크기 이하로 줄이기 전에 라벨을 줄이거나 컨테이너를 넓힙니다.
• 전체 페이지 미리보기와 확대된 스크린샷을 모두 검사합니다. 확대했을 때만 읽을 수 있는 텍스트는 실패입니다.

7. 저장, 다시 열기 및 편집 가능성 확인

최종 VSDX를 요청된 경로에 저장하고 닫은 후 Visio에서 다시 엽니다. 적어도 다음 항목을 개별적으로 선택하고 편집합니다:

• 그룹화된 직육면체의 한 면;
• 하나의 수학 연산자 또는 기호;
• 하나의 커넥터와 접착된 양쪽 끝점;
• 하나의 스테이지 라벨.

참조 이미지가 제거되었거나 잠긴 Reference 레이어에 숨겨져 있는지, 요청 시 관련 없는 페이지가 없는지, 어떤 객체도 단일 전체 페이지 비트맵이 되지 않았는지 확인합니다.

저장 후 scripts/inspect_vsdx.py를 실행합니다. 이 정적 검사는 시각적 검사를 보완하지만 대체하지는 않습니다.

8. 내보내기 및 최종 QA 수행

Visio에서 PDF와 PNG를 내보냅니다. 16×9인치 페이지의 경우 300 DPI 래스터는 최소 4800×2700 픽셀입니다. 두 내보내기 파일 모두에서 잘림, 글꼴 대체, 얇거나 끊어진 선, 그림자 아티팩트, 페이지 경계 오류가 없는지 검사합니다.

전체 qa-checklist.md를 실행합니다. 과학적 충실도, 겹침, 커넥터, 텍스트 무결성, 내보내기 또는 편집 가능성 항목 중 하나라도 실패한 상태로 전달하지 마십시오.

부분 수정 규칙

• 영향을 받지 않은 셰이프, 스타일, 레이어 및 페이지 설정은 유지합니다.
• 편집 전에 백업하고 승인될 때까지 새 버전으로 수정본을 저장합니다.
• 영향을 받는 가장 작은 하위 그래프(들어오는 커넥터, 편집된 객체, 나가는 커넥터)를 진단합니다.
• 객체를 이동한 후 인접 커넥터의 경로를 다시 지정합니다.
• 전체 페이지 미리보기 QA를 다시 실행합니다. 국지적 수정이 전역적 충돌을 만들 수 있습니다.

필수 핸드오프

다음을 보고합니다:

1. 대상 아키텍처 및 증거 근거;
2. 소스, 백업, 작업 디렉토리 및 출력 경로;
3. 제거되거나 유지된 페이지;
4. VSDX, PDF 및 PNG 경로와 PNG 픽셀 크기/DPI;
5. 정적 VSDX 검사 요약;
6. 수행한 다시 열기/편집 가능성 테스트;
7. 남아 있는 불확실성.

파일이 저장되거나 내보내졌다는 이유만으로 성공했다고 주장하지 마십시오.