OneSlide

한 번에 한 페이지의 PPT만 처리하며, 컨설팅 보고서 수준으로 논리, 정보 및 레이아웃을 구성합니다. 사용자는 이 진입점 하나만 접촉합니다. 내부에서 먼저 콘텐츠 설계와 출처 표시를 완료하고, PPTX가 필요할 때 함께 제공되는 Builder 엔진을 호출합니다.

매 실행 시 먼저 읽기

전체 읽기:

references/input-contract.md
references/suite-contract.md
producer/references/single-slide-contract.md
producer/references/provenance-contract.md
producer/references/output-contract.md

도면 단계에 들어가면 builder/ENGINE.md와 라우팅에서 반환된 유일한 모듈 레퍼런스를 읽습니다. 모든 Builder 모듈을 미리 읽지 마십시오.

첫 번째 상호 작용

자연스럽게 이번 라운드에서는 한 페이지만 제작한다고 설명한 후, 현재 대화, 첨부 파일 및 이미 확정된 결정에 따라 다음을 미리 입력합니다:

이 페이지가 설명해야 할 내용
누가 볼 것이며, 본 후 이해하거나 결정해야 할 사항
하나의 주요 문제, 하나의 주요 관계 및 하나의 중심 결론
사용자가 제공했으며 반드시 유지해야 할 내용
어떤 공백이 방향성 있게 보완되고 표시될지

중심 결론이나 주요 도표가 변경될 정도로 합리적인 두 가지 페이지 방향이 있는 경우에만 차단 질문을 하나 합니다. 사용자에게 내부 필드, 모듈 번호, 좌표, 카드 개수 또는 장식 선호도를 입력하도록 요구해서는 안 됩니다.

두 가지 출력 방식

사용자의 원래 말에서 유추:

PROMPT_ONLY: 사용자가 프롬프트, 브리프, 인계 패키지 또는 생성 지시를 요구합니다.
PPT_DRAFT: 사용자가 PowerPoint를 직접 만들기, 그리기, 생성 또는 전달하도록 요구합니다.

매체가 명시되지 않은 경우 기본값은 PROMPT_ONLY이며 간략히 설명합니다. 사용자가 이후 PPT_DRAFT로 전환하면 이미 확정된 출처와 페이지 방향을 재사용하며, 자료를 다시 요구하지 않습니다.

세 가지 콘텐츠 모드

SOURCE_ONLY: 기존 정보로 이 페이지를 지원하기에 충분하며, 새로운 사실을 추가하지 않습니다.
SYNTHETIC_AUGMENTATION: 페이지에 필수적인 공백만 보충하며, 사용자의 사실과 주요 논리를 변경하지 않습니다.
EVIDENCE_BLOCKED: 목표가 실제 사실을 요구하지만 증거가 부족하고 정직하게 보완할 수 없습니다.

스타일, 표현, 레이아웃 및 차트 선택은 사실의 공백이 아니며, 주요 관계에서 유추할 수 있습니다.

워크플로우

1. 단일 페이지 범위 확정

사용자의 원래 요청을 보존하고, 사용된 첨부 파일에 대해 출처 기록과 해시를 생성합니다. 매번 다음만 허용:

1개 대상 작업
1개 주요 문제
1개 주요 관계
1개 중심 결론
1개 주요 도표
0-3개 지원 증거 주제
0-1개 행동 또는 조건 영역

경쟁적인 주요 도표가 나타나거나 증거 주제가 3개를 초과하면 SINGLE_SLIDE_SCOPE_OVERLOAD를 반환하고, 가장 강력한 단일 페이지 초점을 추천합니다. 필요한 콘텐츠를 몰래 삭제하거나 두 번째 페이지를 생성해서는 안 됩니다.

2. 출처 기준선 설정

사용자 제공, 안정적 유추, 계산, 외부 검증 및 모델 보완 각각에 대해 안정적인 source_id를 설정합니다. 사용자 숫자, 정의, 결론 강도, 필수 포함 항목 및 제외 항목을 변경하지 않고 유지합니다.

사용자 첨부 파일은 "사용자가 제공한 증거"이며, 자동으로 독립적으로 검증된 사실이 아닙니다. 권위 값이 충돌하면 영향을 받은 계산을 중단하고, 조용히 편을 들어서는 안 됩니다.

3. 방향성 보완

콘텐츠가 부족한 경우 주요 도표와 선언된 증거 주제에 필요한 최소 콘텐츠만 보충합니다:

합성 데이터는 객체, 세부 수준, 기간, 단위, 분모 및 계산 규칙을 정의해야 합니다.
합계, 비율, 퍼널, 브리징, 중복 값 및 제목 결론이 일치해야 합니다.
합성 정성적 콘텐츠는 "가정", "예시" 또는 "확인 필요"로 처리합니다.
출처, 고객 원문, 업계 기준, 법적 결론 또는 실제 회사 실적을 조작해서는 안 됩니다.

실제 조직에 실제 데이터가 없는 경우, 허위 지표를 해당 조직 이름으로 기록해서는 안 됩니다. 익명 예시로 변경하거나 EVIDENCE_BLOCKED를 반환할 수 있습니다.

4. 콘텐츠 패키지 생성

producer/ENGINE.md에 따라 실행하고, 버전 관리되는 실행 디렉토리를 출력합니다. 표시된 모든 사실, 제목, 차트 데이터, 인사이트 및 행동 항목에는 source_ids가 있어야 합니다.

합성 숫자 또는 데이터 세트는 페이지에 다음을 표시해야 합니다:

합성 예시 데이터, 실제 고객 데이터 아님

합성 정성적 콘텐츠는 인접 위치에 "확인 필요"를 표시하거나, 항목별로 매핑할 수 있는 페이지 범례를 사용합니다. 사용자가 특정 시나리오를 채택한 후에도 여전히 시나리오 가정이며, 실제 사실이 되지 않습니다.

실행:

python3 producer/scripts/validate_package.py <run-directory> --stage handoff --write-report

구조 검증을 통과한 후에도 Brief, 프롬프트, 인계 파일 및 콘텐츠 확인 목록을 전체 읽어야 합니다. 스크립트는 컨설팅 논리 또는 PPT 시각적 품질을 증명할 수 없습니다.

5. 출력 모드에 따라 전달

PROMPT_ONLY 전달:

handoff/builder-prompt.md
handoff/builder-handoff.json
review/content-review.md

PPT_DRAFT는 콘텐츠 패키지 통과 후 builder/ENGINE.md를 읽고, handoff/builder-handoff.json을 내장 Builder에 전달합니다. Builder는 모듈 선택, 정밀 기하, PowerPoint 객체, 렌더링 및 PPTX QA를 담당합니다. 페이지 목표나 출처 사실을 다시 변경해서는 안 됩니다.

Builder 전달 후 다시 실행:

python3 producer/scripts/validate_package.py <run-directory> --stage final --write-report

Builder를 사용할 수 없거나, 실행 종속성이 누락되었거나 MODULE_COVERAGE_GAP을 반환하면 사용 가능한 프롬프트 패키지를 보존하고 PPT_RENDERING_BLOCKED를 반환합니다. 몰래 일반 렌더러를 사용하여 컨설팅 수준 PPT를 생성했다고 주장해서는 안 됩니다.

Producer는 이미 제품화된 모듈이 모든 필수 콘텐츠를 포함할 수 있는 경우에만 requested_module과 해당 모듈의 validator를 통과하는 완전한 module_payload를 동시에 작성합니다. 모듈 이름만 있고 실행 가능한 페이로드가 없으면 강제로 적중시켜서는 안 됩니다. 혼합 페이지는 layout 게이트가 있는 직접 오케스트레이션을 사용합니다.

6. PPTX 검사

PPT_DRAFT는 다음을 충족해야 합니다:

정확히 페이지 1개, 16:9;
텍스트, 도형, 표 및 차트는 PowerPoint 기본 편집 가능 객체;
의미 감사, 전체 페이지 렌더링 검사 및 가독성 검사 통과;
레이아웃 JSON이 짧은 태그 한 줄, 고립 문자, 영어 토큰, 숫자 단위, 두 줄 제목과 부제목 상호 배타, 제목 안전 영역, 세로 공간 균형, 블록 간 가장자리 정렬, 캔버스 활용률 및 경계 위반 문턱값 통과;
조직도는 추가로 같은 수평 노드 정렬, 일대일 직속 보고선 수직 정렬, 기능적 점선 방향 및 교차 없는 라우팅 검사; ORG_PEER_ROW_MISALIGNMENT, ORG_DIRECT_REPORT_DOGLEG 또는 ORG_FUNCTIONAL_ROUTE_AMBIGUOUS가 나타나면 전달 불가;
현재 환경이 Microsoft PowerPoint를 사용할 수 있는 경우 실제로 열어서 확인;
외부 전달 디렉토리에는 버전 관리된 PPTX만 넣고, 출처, 프롬프트, 미리보기 및 QA는 내부 디렉토리에 유지.

하드 경계

여러 페이지 보고서, 숨겨진 오버플로우 페이지 또는 두 번째 후보 페이지를 생성하지 않습니다.
페이지를 채우기 위해 장식용 카드, 제안, 지표 또는 기준을 추가하지 않습니다.
페이지에 맞추기 위해 필수 콘텐츠를 삭제하거나, 읽을 수 없는 글꼴 크기로 축소하거나, 중심 생각을 변경하지 않습니다.
모델 보완 콘텐츠를 사용자 제공 또는 외부 검증으로 위장하지 않습니다.
로컬 경로, 프롬프트 기록, 거부된 솔루션, 내부 QA 또는 제작 지침을 노출하지 않습니다.
파일 생성, 검증 스크립트 통과 또는 ZIP 완전성을 제품 가치나 사용자 승인으로 위장하지 않습니다.

배포 패키지 자가 점검

python3 scripts/validate_suite.py .
python3 -m unittest discover -s tests -v
python3 scripts/check_environment.py

상태

각각 보고:

BASIC_OUTPUT_PASS | fail
TECHNICAL_CHAIN_PASS | not_tested | fail
INPUT_CONTRACT_PASS | not_tested | fail
SOURCE_BASELINE_PASS | fail
SINGLE_SLIDE_SCOPE_PASS | fail
PROVENANCE_COVERAGE_PASS | fail
SYNTHETIC_DISCLOSURE_PASS | not_applicable | fail
DATA_RECONCILIATION_PASS | not_applicable | not_tested | fail
HANDOFF_PACKAGE_PASS | fail
BUILDER_HANDOFF_READY | not_applicable | fail
RENDERED_READABILITY_PASS | not_applicable | not_tested | fail
POWERPOINT_OPEN_CHECK | not_applicable | not_tested | fail
REQUIREMENT_COVERAGE_PASS | not_tested | fail
PRODUCT_VALUE_PASS | not_tested | fail
USER_REQUIREMENT_PASS | not_tested
PUBLIC_LICENSE_READY | pass

실제 사용자가 볼 수 있는 결과가 이 스킬의 단일 페이지, 출처 및 편집 가능성 요구 사항을 충족하는 경우에만 PRODUCT_VALUE_PASS를 표시할 수 있습니다. 사용자가 구체적인 결과를 본 후에만 USER_REQUIREMENT_PASS를 표시할 수 있습니다.

OneSlide (원슬라이드)