기술 PPT 빌더

기술 PPT 빌더은(는) 무엇을 하나요?

명시적인 계획, 시각적 디자인, 생성 및 검토 게이트를 통해 편집 가능한 PowerPoint 덱을 빌드하거나 개선합니다. 원본의 의미를 보존하고 사용자의 원본 파일을 절대 수정하지 않습니다.

경로 선택

• 새 덱의 경우, Brief -> Outline -> Visual Strategy -> Generator -> Review 순서를 따릅니다.
• 페이지 수, 순서, 템플릿 정체성 및 원본 의미가 고정되어야 하는 기존 덱의 경우, Beautifier -> Review 순서를 따릅니다.
• 요청된 변경 사항이 페이지를 추가/제거하거나, 시퀀스를 재설계하거나, 템플릿을 교체하거나, 핵심 메시지를 다시 작성하는 경우, 원본 덱을 승인된 자료로 사용하여 새 덱 경로를 사용합니다.
• 사용자가 Brief, Outline 또는 Visual Strategy만 요청하는 경우, 해당 단계의 완료 게이트를 통과한 후 중단합니다.
• PPTX를 생성하거나 수정하는 모든 작업에 대해 Review를 요구합니다.

전체 라우팅, 전환 게이트, 프로젝트 상태 모델, 명명 규칙 및 완료 기준에 대해서는 워크플로우를 읽으세요.

실행 모드 선택

• 기본적으로 지속적(Continuous) 모드를 사용합니다. 필요한 단계를 정기적인 중단 없이 완료하고, 각 단계 경계에서 프로젝트 상태를 업데이트하며, 차단 소스 격차, 자료 모호성 또는 사전 승인 외부의 결정이 있을 때만 일시 중지합니다.
• 사용자가 명시적으로 단계별 확인을 요청하는 경우에만 체크포인트(Checkpointed) 모드를 사용합니다. 새 덱의 경우 Brief, Outline 및 Visual Strategy 후에 일시 중지합니다. 미화의 경우 진단(Diagnosis) 및 미화 계획(Beautification Plan) 후에 일시 중지합니다. 마지막 계획된 체크포인트 후에는 생성 또는 실행과 Review를 지속적으로 완료합니다.
• 경로와 모드를 분리하여 유지합니다. 경로는 수행할 작업을 선택하고, 모드는 사용자가 결정에 참여하는 방식을 선택합니다.
• 사용자가 요청한 슬라이드 언어를 따릅니다. 지정되지 않은 경우, 지배적인 소스 언어를 사용합니다. 명시적으로 요청된 경우에만 이중 언어 덱을 만듭니다.

필요한 지침만 로드

• Brief를 읽어 청중, 목적, 소스 경계, 격차 및 가정을 설정합니다.
• Outline을 읽어 논증 및 페이지 시퀀스를 정의합니다.
• Visual Strategy를 읽어 실행 가능한 슬라이드 커뮤니케이션 계약을 생성합니다.
• 새 PPTX를 생성하기 전에 Generator를 읽습니다.
• 기존 PPTX를 개선하기 전에 Beautifier를 읽습니다.
• 생성되거나 미화된 덱을 검토 완료된 것으로 제시하기 전에 Review를 읽습니다.
• 공유 시각적 판단을 위해 Design System을 읽습니다.
• 덱 방향, 타이포그래피, 그리드, 계층 구조, 페이지 패밀리 또는 레이아웃 패턴이 중요한 경우 Visual Foundations를 읽습니다.
• 슬라이드에 아키텍처, 토폴로지, 프로세스, 분기, 루프, 경계, 공간, 병렬, 다대다 또는 다중 관계 의미가 포함된 경우 Diagram Rules를 읽습니다.
• 이미지, 아이콘, 생성된 시각 자료 또는 PNG 내보내기를 사용하는 경우 Visual Assets를 읽습니다.
• 템플릿, 렌더링, 구조 검사, 증거 및 전달 확인을 위해 Delivery and Quality를 읽습니다.

소스 파일 보존

• 사용자가 명시적으로 직접 변경을 승인하지 않는 한, 모든 사용자 제공 파일을 읽기 전용으로 취급합니다.
• 원본 PPTX 또는 지원 소스 파일을 절대 덮어쓰기, 이름 변경, 이동 또는 삭제하지 않습니다.
• 모든 생성 또는 미화 작업에 대해 새 작업 PPTX를 만듭니다.
• 대상 파일 이름이 이미 존재하는 경우, 해당 파일을 교체하는 대신 _v2, _v3 또는 다음 사용 가능한 버전을 추가합니다.
• Review 게이트를 통과한 후에만 파일 이름에 reviewed를 사용합니다.
• 사용자가 최종 전달을 명시적으로 승인한 후에만 final을 사용합니다.

출력물 배치

다음 우선 순위 순서를 적용합니다:

1. 사용자가 명시적으로 제공한 출력 경로를 사용합니다.
2. 하나의 소스 PPTX의 경우, 기본 PPTX 출력물을 해당 파일의 디렉토리에 배치합니다.
3. 하나의 디렉토리에 여러 소스 파일이 있는 경우, 기본 PPTX 출력물을 해당 공유 디렉토리에 배치합니다.
4. 다른 디렉토리에 소스가 있는 경우, 기본 소스의 디렉토리를 사용합니다. 기본 소스를 안전하게 결정할 수 없는 경우에만 질문합니다.
5. 로컬 소스가 없는 경우, 사용자가 선택한 작업 공간 또는 현재 작업 디렉토리를 사용합니다.
6. 선택한 디렉토리에 쓸 수 없는 경우, 중단하고 쓸 수 있는 위치를 요청합니다.
7. 더 높은 우선 순위의 호스트 작업 공간 규칙이 다른 출력 위치를 요구하는 경우 이를 따르고 실제 위치를 보고합니다.

기본 작업 및 검토 완료된 PPTX 파일을 소스 옆에 보관합니다. 영구 상태, 렌더링, 검사 및 QA 증거는 동일한 디렉토리의 technical-ppt-builder-work/<task>/ 아래에 저장합니다. 일회용 캐시는 운영 체제 임시 디렉토리에 저장합니다.

프로젝트 상태 유지

다단계 생성 또는 전체 덱 미화를 위해 하나의 presentation_state.md를 유지합니다. 경로, 모드, 소스 경계, 제약 조건, 결정, 가정, 증거 경로, 편차, 위험, 검토 결과 및 실제 아티팩트 경로를 기록합니다. 사용자의 작업 언어로 사람이 읽을 수 있는 상태를 작성하면서, 안정적인 기술 식별자는 유용한 경우 영어로 유지합니다.

제공된 프레젠테이션 런타임 사용

호스트 환경에서 사용 가능한 프레젠테이션 생성 스킬 또는 런타임을 구현 라이브러리, 작업 공간 설정, 렌더링 및 구조 검사의 권위 있는 소스로 사용합니다. 이미지 생성, 이미지 검색, Graphviz 및 SVG 변환을 PPTX 조립 런타임보다는 지원 프로듀서로 취급합니다.

편집 가능성을 유지합니다. 생성되거나 수정된 모든 덱을 렌더링하고, 구조를 검사하며, 반드시 수정해야 할 결함을 복구하고, 복구 후 증거를 새로 고칩니다.

작업 완료

다음 조건이 충족될 때만 완료합니다:

• 요청된 경로가 최종 단계에 도달했습니다.
• 프로젝트 상태가 실제 아티팩트 및 증거와 일치합니다.
• 생성되거나 미화된 모든 PPTX가 Review를 통과했습니다.
• 모든 반드시 수정해야 할 항목이 복구되고 재확인되었습니다.
• 원본 파일이 변경되지 않았습니다.
• 소스 고정 미화가 기록된 페이지, 템플릿, 콘텐츠 및 의미 제약 조건을 보존합니다.
• 전달된 파일 이름이 초안, 검토 완료 또는 최종 상태를 정확하게 나타냅니다.