Flow Diagram (플로우 다이어그램)

Flow Diagram (플로우 다이어그램)은(는) 무엇을 하나요?

Flow Diagram은 실행 가능한 시스템 및 프로세스 다이어그램을 위한 제작 스킬입니다. 한 번 작성한 후 재생, 임베딩, 검사, 내보내기가 가능합니다.

설명과 소스 자료를 시각적 설명으로 변환합니다: 구조, 관계, 프로세스를 명확하게 보여주는 정적 또는 애니메이션 다이어그램. 목표는 소스의 의미를 보존하고 독자가 사물이 어떻게 구성되고 연결되며 시간이 지남에 따라 어떻게 변화하는지 이해하도록 돕는 것입니다.

작업 선택

이 스킬은 다이어그램 자산을 생성합니다. PPTX 파일 및 네이티브 PowerPoint 도형은 범위를 벗어납니다.

작업 유형, 사용할 입력, 프로세스 진입점 또는 재개 지점을 식별합니다.

요청	시작점
새로운 다이어그램 또는 작성/수정할 JSON 가져오기	환경설정 사전 점검을 완료한 후 다섯 단계를 모두 따릅니다. 필요한 경우 변경되지 않은 가져온 바이트를 보존합니다.
내보내기 또는 검사를 위한 변경되지 않은 JSON 가져오기	내보내기 또는 진단 진입점을 사용합니다. 환경설정 사전 점검을 건너뛰고 입력 디자인을 유지합니다.
완성된 다이어그램 수정	기존 다이어그램과 최종 보고서를 읽습니다. 요청된 변경 사항과 범위를 설정하고 환경설정 사전 점검을 완료한 후 5단계 프로세스를 따릅니다. 유효한 디자인 결정을 재사용합니다. 사용자가 변경하지 않는 한 요청된 형식을 유지합니다.
내보내기 형식만 추가	기존 다이어그램을 변경하지 않고 3단계부터 시작합니다. 드래프팅, 스타일링, 측정, 레이아웃 변경을 건너뛰고 요청된 파일을 검사 및 마무리합니다.
미완료 작업 계속	작업 기록을 읽고 계속할 저장된 리비전을 선택합니다. 완료되지 않은 단계 또는 변경의 영향을 받는 단계에서 재개합니다.
검증 또는 진단만	구조적 검사를 위해 validate를 사용합니다. 시각적 진단이 요청된 경우 4단계의 해당 검사 워크플로를 따릅니다. 수행된 검사, 그 한계, 발견된 문제를 보고한 후 중지합니다.

독립적인 저장, 변경 또는 재설정 요청의 경우 프로젝트 환경설정을 따르고 다이어그램을 생성하지 않고 작업을 보고합니다.

기존 다이어그램에서 가져오기, 수정 또는 내보내기의 경우 입력 및 부모 선택을 읽습니다. 작업 파일을 생성하기 전에 작업 공간 요구 사항을 읽고, 검증 명령 및 보고 상태에 대해 런타임 및 결과 계약을 읽습니다.

입력, 승인된 변경 사항, 프로세스 진입점이 명확해지면 진행합니다.

프로세스

0. 디자인 환경설정 초기화

새로운 드래프트 및 수정된 드래프트의 경우 1단계 전에 프로젝트 환경설정을 따릅니다. 관련 시각적 선택 사항을 해결하고 그 출처를 기록하여 사전 점검을 완료합니다. 요청된 저장을 완료하거나 실패를 공개합니다. 독립적인 환경설정 관리 요청은 해당 참조를 사용하고 작업을 보고한 후 중지합니다. 순수 내보내기, 검증, 진단 작업은 기존 진입점을 유지합니다. 미완료 작업은 기록된 결정을 사용하여 재개하며, 관련 선택 사항이 변경될 때만 사전 점검을 다시 수행합니다.

1. 설명 목표 정의

독자의 질문으로 시작합니다: 다이어그램을 본 후 독자가 무엇을 이해해야 합니까? 이 질문을 사용하여 이후 콘텐츠, 레이아웃, 애니메이션 결정을 안내합니다.

• 질문 정의. 주제와 독자가 사용자의 요청에서 이해해야 할 내용을 식별합니다.

• 사실 확립. 사용자가 지정한 출처 또는 승인된 범위 내의 기존 다이어그램을 읽습니다. 관련 객체, 관계, 프로세스, 상태 변화를 식별합니다. 알려진 사실과 명확화가 필요한 정보를 구분하고 소스 메타데이터를 통해 출처를 기록합니다.

  코드 저장소 탐색과 같은 광범위한 조사의 경우 서브 에이전트를 생성하여 독자의 질문과 관련된 부분을 조사합니다. 서브 에이전트에게 질문과 승인된 소스 범위를 제공합니다. 관련 객체, 관계, 프로세스, 상태 변화를 소스 위치 및 해결되지 않은 질문과 함께 요청합니다. 그 결과를 사용하여 설명에 필요한 사실을 확립합니다.

  소수의 기사, 소량의 참고 자료, 또는 "RAG 워크플로를 플로우차트로 설명해줘"와 같은 짧은 요청의 경우 현재 세션에서 사실을 확립합니다.

• 요구 사항 기록. 사용자가 이미 지정한 대상, 사용 컨텍스트, 전달 요구 사항을 캡처합니다. 누락된 전달 컨텍스트를 따라 알려진 선택 사항을 재사용하고 관련 격차를 한 번 수집하며 지오메트리를 선택하기 전에 채택된 가정을 기록합니다.

독자의 질문을 한 문장으로 말할 수 있고 그 답을 뒷받침하는 사실을 식별할 수 있을 때 진행합니다. 다이어그램의 의미를 변경할 정보 격차는 드래프팅 전에 명확히 합니다. SDK가 요청을 충실히 표현할 수 없는 경우 한계를 설명하고 사용자의 선택을 기다립니다.

2. 시각적 설명 설계

독자가 1단계에서 정의된 질문에 답할 수 있도록 주제를 제시하는 방법을 선택합니다.

새로운 또는 수정된 드래프트의 경우 캔버스와 밀도를 선택하기 전에 전달 컨텍스트를 읽습니다. 목적을 모르는 경우에도 마찬가지입니다. 기능 목록, 책임, 리소스 상태, 요청 및 응답, 상태 전이, 데이터 처리, 아키텍처에 대해 독자 질문 선택 테이블을 사용합니다.

• 콘텐츠 선택. 설명에 필요한 객체, 관계, 프로세스, 상태를 선택합니다. 콘텐츠를 생략하거나 집계하거나 알 수 없는 소스 정보를 제시하는 방법을 결정하기 전에 소스 충실도 및 정보 선택을 읽습니다. 이러한 선택에서 소스의 의미를 보존합니다.
• 콘텐츠를 표면에 할당. 다이어그램 지오메트리 전에 콘텐츠 배치를 따라 페이지 도입부, 다이어그램 바운드 레이블, 캡션 및 보조 산문을 할당합니다. 할당과 각 요청된 형식에 필요한 컨텍스트를 기록합니다.
• 구조 구성. 독자가 주요 포인트를 식별하고 그 관계를 따를 수 있도록 그룹, 계층 구조, 읽기 순서를 정의합니다.
• 시각적 방향 설정. 시각적 디자인을 따라 사용 컨텍스트에 맞는 방향을 선택합니다. 사이드바가 있는 계층 구조, 분기 또는 리턴이 있는 프로세스, 더 긴 콘텐츠가 있는 반복 카드의 경우 적용 가능한 구성 레시피를 선택합니다. 생산에 필요한 구체적인 선택 사항을 기록합니다.
• 정적 다이어그램 또는 애니메이션 선택. 구조와 관계를 설명하려면 정적 레이아웃을 사용합니다. 애니메이션의 경우 지속적 관계 흐름, 주의 집중 및 단계별 변경을 구분합니다. 흐르는 선에 대한 요청은 전체 다이어그램을 보이게 유지할 수 있습니다.
• 애니메이션 내러티브 계획. 애니메이션을 사용하는 경우 애니메이션 리듬 및 시각적 연속성을 따라 각 단계의 설명 목표, 상태 변화, 전환, 읽기 일시 중지를 정의합니다.

계획에 선택된 콘텐츠, 그 전달 표면, 그룹, 읽기 순서, 시각적 선택 사항, 정적 또는 애니메이션 프레젠테이션이 기록되면 진행합니다. 애니메이션의 경우 단계 계획을 포함합니다.

3. 다이어그램 생성

2단계의 설계를 구현하고 4단계의 검사에 필요한 아티팩트를 생성합니다.

Node 20+ 및 npm을 사용합니다. 사용자가 선택한 작업 디렉터리에서 node <skill-directory>/scripts/flowsvg.mjs를 실행합니다. 필요한 경우 경로를 따옴표로 묶습니다. 이 설치된 스킬 내에서 도구 및 작업 리소스를 해결합니다. CLI는 애플리케이션 종속성을 변경하지 않고 자체 고정 SDK 런타임을 준비합니다.

• 관련 제작 지침 읽기. 새 또는 수정된 드래프트의 경우 문서 모델 및 레이아웃 지침을 읽고 선택된 디자인 레시피를 구현합니다. 지오메트리를 배열하기 전에 렌더링 함정을 확인하여 긴 레이블이 있는 짧은 경로, 사이드바, 테두리 없는 텍스트, 좁은 카드 또는 모든 언어의 줄 바꿈 위험, 짧은 레이블의 광학 정렬, 공유 읽기 가장자리, 변경된 콘텐츠 크기를 확인합니다. 애니메이션의 경우 장면, 상속된 상태 및 타이밍도 읽습니다. 요청된 SVG, PNG 또는 GIF 파일의 경우 내보내기 옵션 및 한계를 읽습니다.
• 다이어그램 문서 빌드. 새 또는 수정된 드래프트의 경우 계획된 객체, 그룹, 연결, 텍스트, 애니메이션 단계를 구현합니다. 소스 언어와 선택된 시각적 방향을 보존합니다. 방향이 지정되지 않은 새 다이어그램의 경우 밝은 테마와 둥근 그룹으로 시작합니다. 전체 드래프트에서 텍스트를 측정하고 반복되는 지오메트리에 계획이 필요한 경우 레이아웃 계획 워크플로를 따릅니다. 모든 객체, 관계 방향, 부모 경계 및 상태 변화를 소스와 비교합니다. 승인된 변경 사항을 새 작업 공간 드래프트에 저장합니다. 변경되지 않은 가져오기 또는 내보내기의 경우 선택된 입력 바이트를 직접 사용합니다.
• 검증 및 수정. 반복 중에 읽기 전용 validate를 사용하고 모든 진단을 읽습니다. 다이어그램 리비전을 생성하지 않고 정확한 입력 ID와 유한한 검사를 반환합니다. 작업 드래프트를 유지합니다. 현재 승인 내에서 수정 사항을 적용하며 진단 및 수정 결정을 따릅니다. 설명의 의미를 변경할 수정 사항은 사용자에게 확인합니다.
• HTML 페이지 작성. 새 또는 수정된 HTML 설명의 경우 다이어그램 외부에 할당된 콘텐츠에 대한 페이지 HTML/CSS를 작성하고 편집 가능한 HTML 페이지를 통해 제출합니다. 기존 결과의 경우 페이지 연속을 따라 디자인을 보존하고 의도된 다이어그램 변경 사항을 명시적으로 동기화합니다. 유용한 경우 새 페이지에 설치된 스타터를 재사용합니다. 관리되는 플레이어 영역을 유지하고 작업 공간에 전체 페이지를 보관합니다.
• 검사 아티팩트 생성. 브라우저 캡처 또는 미리보기 샘플 수 선택 전에 브라우저 준비 및 샘플링을 읽습니다. author를 사용하여 필요한 오프라인 HTML, 필요한 미리보기 및 요청된 내보내기 파일을 생성합니다. 중간 HTML만 필요한 경우 author --browser none을 사용합니다. 여러 명명된 정적 상태의 경우 명명된 배치 내보내기를 따릅니다. 매니페스트를 바인딩하기 전에 사용자와 실제 컴파일된 비트에서 선택된 시간을 확인합니다. 설정, SDK 호환성 및 보고서 필드에 대해 런타임 및 결과 계약을 따릅니다. CLI 명령 옵션은 --help를 사용합니다.

드래프트가 계획을 구현하거나 변경되지 않은 입력이 보존되고, 차단 오류가 해결되고, 남은 진단에 처리 결정이 기록되고, 검사에 필요한 모든 파일이 완료되면 진행합니다. 내보내기 실패 시 아래 복구 규칙을 따르고 완료된 파일과 미완료 파일을 별도로 보고합니다.

4. 결과 검사

전달된 SVG/PNG의 경우 온디맨드 아티팩트 증거를 따릅니다: 명시적으로 저장된 대상에 대해 evidence를 실행한 후 이미지를 보고 독립적으로 검토합니다. 기존 유효 조건은 재사용되고 새 조건은 검사될 때까지 보류 상태로 유지됩니다.

생성된 다이어그램을 보고 주제를 정확하고 명확하게 설명하는지 확인합니다.

• 의미적 정확성 확인. 객체, 관계 방향, 그룹 경계, 상태 변화를 소스와 비교합니다. 생략 및 집계가 소스 의미를 보존하는지 확인합니다.
• 시각적 가독성 확인. 의도된 표시 크기에서 실제 렌더링된 이미지를 봅니다. 텍스트, 간격, 가림, 읽기 순서를 검사합니다. 각 관련 연결을 소스에서 굴곡 및 교차점을 거쳐 화살촉까지 추적합니다. 포트, 레이블, 관련 없는 노드와의 여유 공간을 확인합니다.
• 시각적 디자인 평가. 시각적 디자인 검사를 따라 가시적 결함을 식별하고 사용자의 최종 디자인 판단을 위한 관찰 사항을 기록합니다.
• 애니메이션 설명 확인. 애니메이션의 경우 초기 상태, 주요 변경 사항, 최종 상태를 단계 계획과 비교합니다. 샘플링된 상태에 대해 미리보기 검사를 따릅니다. 페이싱 평가 시 실제 재생을 사용합니다. 샘플 전용 검사는 본 상태로 제한됨을 보고합니다.
• 전달된 파일 확인. 도구를 사용하여 실제 저장된 오프라인 HTML을 열고 초기 일시 중지 상태, 컨트롤, 오프라인 요청, 관련 재생 상태를 확인합니다. HTML 검사 워크플로를 통해 캡처된 이미지를 봅니다. 요청된 내보내기 파일을 있는 그대로 검사합니다. 최종 SVG/PNG 파일에 대해 대상 크기 아티팩트 검사를 사용합니다.

리뷰를 제출하기 전에 완전한 리뷰 입력 계약 및 템플릿 워크플로를 읽습니다. 명시적 다이어그램 대상에서 review-template을 사용하여 보지 않은 양식을 생성하고, 별도의 공식 증거를 위해 --evidence-from을 사용한 후 독립적인 review를 사용하여 HTML, 미리보기 및 공식 SVG/PNG 관찰 사항을 기록하고 실제 본 이미지에 대해서만 ID, 해시, 관찰 사항, 문제를 기록합니다. 반복적인 리뷰 제출은 다른 다이어그램 버전을 요구하지 않습니다. 브라우저 또는 이미지 뷰어를 사용할 수 없는 경우 수행되지 않은 검사와 그 영향을 명시적으로 기록합니다.

발견된 문제에 대해 3단계로 돌아가 승인된 수정 사항을 적용하고 아티팩트를 다시 생성한 후 영향을 받는 파일과 상태를 다시 검사합니다. 진단 및 수정 결정을 참조하여 문제를 기록하거나 사용자에게 명확히 합니다.

…

[번역을 위해 잘림]