DashiAI PPT
DashiAI PPT는 정적 HTML 가로 넘김 PPT를 생성합니다. 이 스킬을 사용할 때는 먼저 사용자의 자연어 요청을 JSON 계획으로 정리한 다음, 로컬 프로젝트 생성기를 호출하여 index.html 및 assets/를 출력합니다.
버전
현재 버전: 0.1.26
사용자 요청을 완료하고 최종 답변을 준비하기 전에 다음을 실행하세요:
node <skill-root>/scripts/check_latest_version.mjs
스크립트에 출력이 있으면 해당 내용을 최종 답변 끝에 첨부하여 사용자에게 업데이트를 알립니다. 스크립트에 출력이 없거나 검사에 실패하면 조용히 넘어가고 버전 검사를 언급하지 마세요.
Skill 디렉토리
현재 SKILL.md가 있는 디렉토리가 Skill 루트 디렉토리이며, 아래에서는 <skill-root>로 표기합니다.
내장 생성기 디렉토리:
<skill-root>/project
렌더링 스크립트:
<skill-root>/scripts/render_goal_deck.sh
버전 검사 스크립트:
<skill-root>/scripts/check_latest_version.mjs
생성 원칙
이 Skill은 템플릿 오케스트레이터입니다. 기본 목표는 등록된 페이지 컴포넌트에 사용자 요구 사항을 빠르고 안정적으로 적용하여 오프라인에서 열 수 있는 HTML PPT를 출력하는 것입니다.
기본 모드는 "템플릿 잠금 및 텍스트 채우기"입니다: 선택한 페이지 컴포넌트의 원래 시각적 요소, 구조, 개수, 표시 여부, 강조, 색 구성표, 차트 유형 및 이미지 슬롯을 유지하고, 보이는 텍스트 콘텐츠만 교체합니다. 사용자가 명시적으로 페이지 속성 조정을 요청하지 않는 한, 비텍스트 props를 변경하지 마세요.
기본적으로 시각적 세부 조정, 스크린샷 미적 판단, 또는 일반적인 줄바꿈이나 부분적인 레이아웃 불완전함으로 인한 반복적인 재작업을 수행하지 않습니다. 사용자가 명시적으로 "시각적 세부 조정", "100% 점검", "만족할 때까지 조정"을 요청한 경우에만 시각적 QA 프로세스를 진행합니다.
사용 규칙
- 생성기를 실행하려면 Node.js 18+ 및 npm이 필요합니다. 첫 번째 생성 시 렌더링 스크립트가 Skill 내장
project/디렉토리에 종속성을 설치합니다. - 스타일 선택 질문: 사용자에게 보이는 답변에는 반드시
<skill-root>/assets/skill/theme-style-grid.png의 Markdown 이미지가 포함되어야 하며, 먼저 절대 경로를 펼쳐야 합니다. 이는 답변 표시용 내장 스타일 차트이며goal.json이나 media 필드에 기록해서는 안 됩니다. 현재 선택 가능한 스타일과 간단한 "적합 대상/사용자 그룹"을 나열하고, 내부 진행 알림에서만 스타일 차트를 언급해서는 안 됩니다. - 작업 시작 전 두 가지 확인: 테마 스타일, 이미지/비디오 필요 여부. 사용자가 명시적으로 표현하지 않았고 전체를 위임하지 않은 경우 먼저 질문하고 답변을 기다리며, 대신 선택해서는 안 됩니다. 질문할 수 없는 환경(스크립트/일괄 처리)에서만 자체 선택하고, 전달 시 선택 사항과 근거를 명시합니다.
- 위임 모드: 사용자가 전체를 명시적으로 위임("모두 네가 정해", "묻지 말고 그냥 해")하는 경우에만 테마를 자체 선택하고, 기본값 HTML을 사용하며, 기본적으로 image-gen을 사용하지 않고, 최종 가정을 설명합니다. 사용자가 내용/카피를 "임의로", "자체 작성"이라고만 말한 경우, 내용만 자체 작성합니다. 스타일, 페이지 수, 미디어 등 이미 주어진 것은 임의로 변경하지 말고, 주어지지 않은 것은 위 규칙에 따라 먼저 질문합니다.
- 비대화형/일회성 실행(질문 불가능)의 경우: 지정된 스타일이 없으면 콘텐츠 주제에 따라 이미 승인된 테마를 자체 선택합니다. 실제 자료가 없고 이미지 생성이 불가능하면 미디어가 없는 페이지를 우선 선택하고, image-gen을 호출하지 않습니다. 최종적으로 모든 가정을 설명합니다.
- 전달 형식: 기본값 HTML; "PPT 생성", "PPT 만들기", "PPT 하나 만들어 줘", "제작 ppt"는 PPT 표현 형태를 의미합니다. 명시적으로
PPTX,PowerPoint,편집 가능한 PPTX,PPTX 내보내기,PPT 형식또는 "형식/파일 유형이 PPT/PPTX"인 경우에만 PPTX 파일을 전달합니다. - PPTX 파일: 여전히 먼저 HTML을 생성하고 로컬 미리보기 서비스를 시작한 다음, 로컬 HTTP 내보내기 서비스를 호출합니다. 최종적으로는 PPTX 파일 경로나 다운로드 결과만 제공합니다.
- 현재 선택 가능한 스타일:
theme01미니멀리스트,theme02그라디언트 퍼플 그린,theme03다크 코드,theme04글래스 캔디,theme05크로마토그래프 차트,theme06다크 그라프,theme07콜드 화이트 리서치,theme08블랙 골드 익스페리멘탈,theme09딥 블루 매거진,theme10골드 인덱스,theme11하이 에너지 그로스,theme12사운드웨이브 네온. - 일반 자동 선택 시
theme10을 선택하지 마세요. 사용자가 명시적으로 지정하거나, 금융/투자 지수 콘텐츠와 매우 관련이 있고 inspect를 통해 입력 가능함을 확인한 경우에만 사용하세요.
theme01미니멀리스트 | 적합: 제품 소개 / 기업 보고 | 대상: 스타트업 팀 / 제품 관리자theme02그라디언트 퍼플 그린 | 적합: 기술 발표회 / AI/자율주행/로봇 주제 | 대상: 기술 회사 창업자 / 기술 책임자theme03다크 코드 | 적합: 기술 제안서 / 개발자 컨퍼런스 | 대상: 엔지니어 / 기술 관리자theme04글래스 캔디 | 적합: 젊은 브랜드 / 소비재 | 대상: 브랜드 팀 / 디자이너theme05크로마토그래프 차트 | 적합: 데이터 보고서 / 시장 분석 | 대상: 데이터 분석가 / 컨설턴트theme06다크 그라프 | 적합: 고밀도 데이터 표시 / 전략 분석 | 대상: 전략 팀 / 투자자theme07콜드 화이트 리서치 | 적합: 조사 보고서 / 백서 | 대상: 연구 기관 / 컨설팅 팀theme08블랙 골드 익스페리멘탈 | 적합: 고급 런칭 / 브랜드 제안 | 대상: 고급 브랜드 / 크리에이티브 디렉터theme09딥 블루 매거진 | 적합: 브랜드 스토리 / 인물 인터뷰 | 대상: PR 팀 / 미디어 편집자theme10골드 인덱스 | 적합: 금융 데이터 / 투자 보고서 | 대상: 투자 기관 / 금융 분석가theme11하이 에너지 그로스 | 적합: 성장 리뷰 / 비즈니스 계획 | 대상: 창업자 / 성장 팀theme12사운드웨이브 네온 | 적합: 음악 엔터테인먼트 / 트렌디 이벤트 | 대상: 엔터테인먼트 브랜드 / 이벤트 기획자
- 이전 토큰, 이전 테마, 이전 미디어 슬롯, 이전 스타일 브랜치 또는 이전 등장 애니메이션 제어를 사용하지 마세요.
- 페이지 선택은 먼저 다음을 사용하세요:
npm --prefix <skill-root>/project run layout:query -- --theme <themePack> --role <role> --limit 8. 미디어 슬롯이 필요한 경우--needs-media,--planned-images <n>,--provided-images <n>또는--image-gen을 추가하세요. - 필드가 불명확하거나, 객체/배열/count, 이미지/미디어인 경우: 먼저
npm --prefix <skill-root>/project run inspect:layout -- --compact <layout...>를 실행하세요. 객체, 배열, 개수 또는 이미지 props를 작성할 때:props:safe를 실행하고, 전체 goal은props:safe -- --goal <file> --write를 사용하세요. layout:query/inspect:layout의 JSON을 프로그램에 파이프로 전달할 때는node <skill-root>/project/scripts/layout-query.mjs/node <skill-root>/project/scripts/inspect-layout.mjs를 대신 사용하세요.npm run은 stdout 앞에 수명 주기 배너를 출력하여 JSON을 오염시킵니다.- 긴 데크의 경우: 먼저
npm --prefix <skill-root>/project run goal:scaffold -- --title <title> --goal <goal> --theme <themePack> --pages <n> --chunk-size 5 --out output/<deck-name>/goal.json을 사용하여 고유 레이아웃 뼈대와goal.fill-plan.json을 생성한 다음,fillPlan에 따라 청크별로 props를 채웁니다. - 텍스트 길이와 배열 개수:
fillPlan.text[].maxChars,fillPlan.arrays[].visibleCount,fillPlan.arrays[].nestedArrays를 우선적으로 따르세요.display/metric필드는 짧은 단어, 짧은 문장 또는 숫자만 작성하세요. - Html 필드(예:
headlineHtml/quoteHtml)는 줄바꿈에<br>과 인라인 강조에<b>/<em>만 사용하고,<span>등의 자유로운 HTML은 금지합니다. 테마 기본값의<span class>는 테마 CSS에 의존하는 단순한 자리 표시자이므로 그대로 복사하지 마세요.validate:goal-spec이 자유 HTML을 차단합니다. - 보이는 배열 항목은 실제 텍스트를 작성해야 합니다. count/표시 여부로 숨겨진 마지막 항목은 "텍스트를 입력하세요"와 같은 자리 표시자를 유지할 수 있습니다.
- 요소 등장 애니메이션은 페이지 컴포넌트에 내장된 기본 효과를 사용합니다.
- 페이지 전환 애니메이션은 미리보기 제어판에서 조정할 수 있습니다.
- 사용자에게 전달되는 데크는 기본적으로 스타일/테마 전환 옵션을 표시하지 않습니다. 스타일 전환은 내부 디버그 데모 페이지에서만 유지됩니다. 사용자가 명시적으로 테마 전환 유지를 요청한 경우에만 goal 최상위에
preview: {"themeSwitcher": true}를 작성하세요. - 자유 HTML 슬라이드를 직접 작성하지 마세요. 사용자에게 전달되는 모든 페이지는
layout+props를 작성해야 합니다.role은 초안 단계에서 페이지 선택을 돕는 용도로만 허용되며, 렌더링 전에 구체적인layout으로 변경해야 합니다. - 각 테마의 처음 5개 페이지
themeXX_page001~themeXX_page005는 모두 표지 후보입니다. 하나의 데크는 처음 5개 페이지 중에서 1개만 표지로 선택할 수 있으며, 여러 표지 페이지를 동시에 사용하지 마세요. 본문 페이지는 6페이지 이후에서 선택합니다. - 동일한 PPT 세트 내에서 반복되는 페이지 컴포넌트를 사용하지 마세요. 최종
slides[].layout은 고유해야 합니다. 페이지를 선택할 때 이미 사용된layout을 기록하고, 다른 내용 페이지에는 동일한 테마의 다른 후보를 사용하며, 같은 layout을 텍스트만 변경하여 재사용하지 마세요. - 사용자에게 전달되는 데크는
role만 작성하고 페이지 기본 텍스트에 의존해서는 안 됩니다. 사용자가 명시적으로 기본 데모를 요청하지 않는 한, 모든 페이지의 보이는 내용은 사용자 주제에 해당하는props텍스트를 작성해야 합니다. - 우선적으로
layout:query/inspect:layout가 노출하는 텍스트 필드만 작성하세요. 필드가 객체나 배열인 경우fillPlan과propShapes에 따라 내부 키를 채웁니다.copyKeys는 중첩 경로(예:copy.quote,items[].label)를 이미 펼쳐 놓았으므로, 나열된 경로에 따라 직접 작성합니다. inspect:layout가contentLocked: true로 표시된 페이지의 본문은 컴포넌트에 고정되어 props로 채울 수 없습니다. 본문을 채울 수 있는 다른 레이아웃의 페이지로 교체하거나, 사용자가 기본 본문을 수락하는 경우에만 사용합니다. 배열은fillPlan.arrays[].visibleCount에 따라 보이는 항목을 채웁니다.decorativeKeys는 장식용이므로 채우지 마세요.- 콘텐츠를 채우기 위해 페이지 메타데이터, 컴포넌트 소스 코드, className, CSS, 스타일 필드 또는 기본 시각적 구조를 변경하지 마세요.
props내에서만 콘텐츠와 사용자가 명시적으로 요청한 페이지 속성을 작성합니다. - 최상위
text를 사용하여 보이는 텍스트 슬롯을 덮어쓸 수 있지만, 텍스트 콘텐츠를 교체하는 용도로만 사용하세요. 일반 생성 시 브라우저를 시작하여 전체 페이지 텍스트 슬롯을 일괄 추출하지 마세요. 사용자가 명시적으로 "모든 기본 템플릿 텍스트 완전 제거/페이지별로 보이는 텍스트 교정"을 요청한 경우에만 런타임 슬롯 추출을 수행합니다. output/에 있는 기존의 오래된goal.json이나 HTML을 재사용하지 마세요. 각 요청마다 새로운 출력 디렉토리와 JSON 계획을 생성합니다.- 출력 디렉토리는 현재 세션 작업 디렉토리에 작성하고,
<skill-root>/project/output에 작성하지 마세요. - HTML 전달: 사용자에게는 미리보기 주소만
http://127.0.0.1:<port>/(https 또는 .local 변형은 안 됨)로 제공하세요. 로컬 HTTP는 HTML/PDF/PPTX를 내보낼 수 있지만, 로컬 HTML 또는file://은 편집 가능한 PPTX를 내보낼 수 없습니다.theme-preview를 반환하지 마세요. 내장 브라우저가 있는 Agent APP(예: Codex)에서 생성할 때는 사용자에게 PDF/PPTX 내보내기 전에 해당 주소를 시스템 브라우저에서 열도록 알리세요. - PPTX 전달:
/api/export-editable-pptx를 호출합니다. 최종적으로는 PPTX 파일 경로나 다운로드 결과만 제공합니다. - 브라우저 세션 부재, 스크립트 직접 호출, 또는 미리보기 내보내기 API가 403/5xx를 반환하는 경우: 대신
npm run export:pptx -- <deck>/ppt <out.pptx>(PDF는export:pdf)를 사용하여 직접 파일을 생성하고, 먼저 브라우저 세션을 시작할 필요가 없습니다. - 출력 본문에 사용자 주제와 관련 없는 기본 텍스트(예: AI Capital / 투자 조달 / SoundWave / 사운드 웨이브 / Key Metrics / Roadmap / End of Report 등)가 나타나면 JSON을 다시 작성하고 다시 렌더링해야 하며, 전달해서는 안 됩니다.
미디어 워크플로우
- 미디어 필드는
mediaSlots[].canPresetMedia: true인 슬롯만 작성하고, 해당 슬롯의presetProp/fieldPath에 따라 경로를 작성합니다.goal.json은 데크 내 상대 미디어 경로만 참조하고, 임시 디렉토리, 외부 절대 경로,file://또는 원격 URL을 참조해서는 안 됩니다. - 시각 자료 작업은 먼저 의도를 판단합니다: 이미지가 없지만 시각 자료가 필요한 경우 먼저 이미지 슬롯을 남겨둘 것인지 질문합니다. 실제 자료가 없고 이미지 생성이 불가능하면 미디어가 없는 페이지를 우선 선택합니다. 사용자가 자료 라이브러리/자료 디렉토리 경로를 제공하면 이미지가 있는 의도로 간주합니다: 최소 2개의 미디어 슬롯이 있는 페이지를 선택하고 적절한 자료를 채웁니다. 자료 경로에 접근할 수 없는 경우 미디어가 없는 페이지로 변경하고 전달 시 그 사실을 알리며, 페이지 내에 안내 텍스트를 남기지 않습니다. 사용자가
--planned-images <n>/--needs-media에 동의하면, 사용자가 자료를 제공하면--provided-images <n>/--provided-media를 사용하고, 사용자가 명시적으로 독창적인 시각 자료/이미지 생성을 요청하면 Codex 환경에서 image-gen을 사용하여 이미지를 생성하고--image-gen을 추가합니다. 명시적으로 이미지 생성을 요청하지 않은 경우 먼저 사용자에게 질문합니다.plannedImages/needsVisual/imageGen은 페이지 선택 의도만 나타냅니다. 사용자가 명시적으로 빈 슬롯을 남겨두기로 선택하지 않는 한, 전달 전에 실제 미디어 경로를 작성해야 하며, 빈 미디어 슬롯이나 가짜 경로를 전달해서는 안 됩니다. - 사용자 로컬 이미지/비디오는 먼저
npm --prefix <skill-root>/project run media:stage -- <deck-output-dir-or-ppt-dir> <media-file...>를 실행하고, 반환된relative경로를 사용합니다. AVIF는 브라우저에서 사용 가능한 형식으로 변환됩니다. image-gen 출력도 먼저 현재 데크 디렉토리에 저장됩니다. - 렌더링 후 goal이 참조하는 각 이미지/비디오를 확인합니다:
ppt/<relative>가 존재하고 HTML에 파일 이름이 포함되어 있는지 확인합니다. 누락된 경우 최종ppt/assets만 보충하고 검증을 다시 실행합니다. 이미지/비디오 자료는 각각 최대 한 번만 사용됩니다. 자료를 모두 사용한 후에는 미디어 슬롯을 비워두거나 미디어 슬롯이 없는 페이지를 선택합니다. 사용자가 명시적으로 요청하지 않는 한, 동일한 자료를 반복해서 채우지 마세요. - image-gen으로 2개 이상의 독립적인 이미지를 생성해야 하는 경우, 여러 subagent를 사용하여 병렬로 생성하고, 직렬로 하나씩 기다리지 마세요. 각 이미지는 독립적으로 생성하고, 하나의 콜라주/자료 보드를 만든 다음 분할하지 마세요. subagent는 이미지 생성에만 사용하고, 주제 선정, 텍스트 작성, 페이지 선택 또는 검증에는 사용하지 마세요.
워크플로우
- 사용자 목표 추출:
title,goal,audience,owner, 페이지 수, 내용 핵심 및 최종 산출물 형식. 사용자가 페이지 수를 지정하지 않은 경우 기본적으로 약 10페이지, 최소 8페이지입니다. themePack확인. 사용자가 지정하지 않은 경우 먼저 스타일에 대해 질문합니다. 사용자가 선택한 후randomSeed를 생성합니다(예:<테마>-<날짜>-<3자리 랜덤 단어>), 랜덤 페이지 선택이 재현 가능하도록 합니다.- 이미지 의도 판단: 이미지가 없지만 시각 자료가 필요한 경우 먼저 이미지 슬롯을 남겨둘 것인지 질문합니다. 사용자가 로컬 자료를 제공하면 먼저
media:stage를 수행합니다. 명확하게 이미지 생성을 요청하면 image-gen을 사용합니다. layout:query를 사용하여 후보를 선택합니다. 객체/배열/count/이미지 props는inspect:layout+props:safe를 사용합니다.- 각 페이지는 하나의 주요 정보 역할만 담당합니다. 안전하게 덮어쓸 수 없는 페이지는 우선적으로 layout을 변경하고, 스타일 필드를 수정하여 억지로 맞추지 마세요.
- JSON을 현재 작업 디렉토리의
output/<deck-name>/goal.json에 작성합니다. 렌더링 전에npm --prefix <skill-root>/project run props:safe -- --goal output/<deck-name>/goal.json --write및 goal spec 검증을 실행합니다.--write후 출력된layoutChanges를 확인합니다. 교체에 동의하지 않으면 되돌리고 페이지를 변경합니다. - 차트 페이지에 자신의 데이터를 채운 후, 페이지 내 insight/그래프 읽기/결론 관련 텍스트 필드는 새로운 데이터에 따라 함께 다시 작성해야 하며, 기본 결론을 유지하지 않습니다.
- 렌더링 스크립트를 실행하여
output/<deck-name>/ppt/index.html을 출력합니다. 스크립트는 Skill 내장 생성기를 사용하므로 외부 프로젝트 디렉토리로 전환하지 마세요. - 렌더링 후 자료 경로를 확인하고, 누락된 경우 최종
ppt/assets를 보충합니다. - 스크립트가
validate:swiss및validate:goal-copy검증을 완료했는지 확인합니다. node <skill-root>/scripts/check_latest_version.mjs를 실행하여 자동 버전 검사를 수행합니다.- 렌더링 스크립트는 로컬 HTTP 미리보기 서비스를 시작하고
http://127.0.0.1:<port>/를 출력합니다. 포트를 지정해야 하는 경우DASHI_PPT_PREVIEW_PORT를 설정한 후 스크립트를 실행합니다(포트는 5200-5999 범위 사용, 4178/4300/4400은 사용자 예약 포트이므로 사용 불가). 미리보기 서비스에서 편집하면index.html본문에 자동 저장됩니다.file://로 연 로컬 파일은 자동 저장되지 않으므로 전달 전에 내보내야 합니다. - 전달 형식에 따라 답변합니다: HTML은
http://127.0.0.1:<port>/만 제공합니다. PPTX는/api/export-editable-pptx를 호출한 후 파일 경로나 다운로드 결과만 제공합니다.
재작업 및 브라우저 검사
다음 경우에만 재작업합니다: 렌더링 실패, validate:swiss 실패, validate:goal-copy 실패, 출력에 사용자 주제에 속하지 않는 명백한 템플릿 텍스트가 나타나는 경우, 사용자가 특정 페이지 내용에 문제가 있다고 명시적으로 지적한 경우.
기본적으로 최대 2회 수정합니다. 그래도 실패하면 차단 원인을 설명하고 무제한으로 시도하지 마세요.
기본적으로 브라우저를 열지 않고, Chrome 프로필을 생성하지 않으며, 전체 텍스트 슬롯을 추출하지 않습니다. 생성기/미리보기 템플릿/내보내기 로직을 수정했거나, 사용자가 명시적으로 페이지 효과 확인을 요청했거나, 이전 실행에서 props가 기본값으로 덮어쓰여지는 문제가 발생한 경우에만 브라우저 smoke check를 한 번 수행합니다.
브라우저 smoke check는 페이지가 열리는지, 페이지 수가 올바른지, 첫 페이지와 마지막 페이지가 비어 있지 않은지만 확인합니다. 기본적으로 스크린샷을 찍거나 세부 조정하지 않으며, 일반적인 줄바꿈 문제로 반복적으로 원고를 수정하지 마세요.
예제 명령:
<skill-root>/scripts/render_goal_deck.sh \
output/client-review/goal.json \
output/client-review/ppt/index.html
JSON 구조
{
"title": "미국 AI 투자 조사",
"goal": "투자 팀에게 2024-2026년 미국 AI 대규모 투자 구조, 자본 흐름 및 향후 판단 보고",
"audience": "투자 팀 / 산업 연구 팀",
"owner": "연구 팀",
"randomSeed": "ai-funding-20260609-a7k",
"pageCount": 8,
"themePack": "theme01",
"slides": [
{"layout": "theme01_page001", "props": {"kicker": "투자 조사 · VOL.01", "titleTop": "미국 AI", "titleBottom": "투자 조사", "lead": "자본 규모, 섹터 구조 및 대표 기업을 중심으로 이번 AI 투자 사이클 분석."}},
{"layout": "theme01_page006", "props": {"kicker": "핵심 숫자", "value": "970", "unit": "억 달러", "sub": "2024년 미국 AI 벤처 투자 규모가 사상 최고치를 기록했습니다."}},
{"layout": "theme01_page010", "props": {"kicker": "# 연구 방법", "title": "횡종 분석법", "cn": "시간 차원과 섹터 차원을 교차하여 투자 변화 식별."}},
{"layout": "theme01_page030", "props": {"kicker": "# 대표 사례", "title": "이정표 · 선도 기업 투자 리듬"}},
{"layout": "theme01_page084", "props": {"kicker": "# 부록", "title": "데이터 출처 및 연구 설명"}}
]
}
slides가 비어 있으면 pageCount는 임시 초안 미리보기에만 적합합니다. 사용자에게 전달하기 전에 반드시 구체적인 layout + 해당 props로 변경해야 합니다.
페이지 역할
role은 초안 페이지 선택에만 사용되며, 최종 JSON은 반드시 구체적인 layout으로 확정되어야 합니다. 역할 설명은 references/layout-roles.md를 참조하세요. 실제 후보는 layout:query 출력을 기준으로 합니다.
cover는 현재 테마의 처음 5개 페이지만 선택할 수 있습니다. image / media 후보는 실제 mediaSlots를 기반으로 하며, 페이지 제목 키워드가 아닙니다. 동적 배경 페이지는 ambient를 분위기 페이지 또는 챕터 페이지로 사용할 수 있습니다.
페이지를 직접 지정할 수 있습니다:
{"layout": "theme01_page030", "props": {"title": "대표 사례"}}
제공 기능
생성된 미리보기 페이지는 페이지 넘기기, 사이드바를 열어 텍스트 편집, 페이지 props 조정, 컴포넌트가 노출하는 이미지/비디오 미디어 슬롯 교체, 페이지 전환 애니메이션 전환, HTML/PDF/PPTX 내보내기를 지원합니다. 사용자에게 전달되는 페이지 하단에는 페이지 번호 표시, 페이지 넘기기 안내, 점 탐색 또는 색인 힌트가 표시되지 않습니다.
페이지 속성 계약
일반 생성 시 layout-manifest.json을 읽지 마세요. 먼저 layout:query가 출력한 후보 요약을 사용하세요. 더 세부적인 계약이 필요한 경우에만 npm --prefix <skill-root>/project run inspect:layout -- --compact <layout...>를 사용하여 페이지 계약을 확인하세요:
copyKeys: 안전하게 다시 쓸 수 있는 텍스트/데이터 필드.copyBudgets: 텍스트 길이 예산.display/metric이 너무 길면 goal spec이 차단합니다.propShapes:copyKeys/ 배열 필드의 내부 형태.copy,cells,items,rows등 객체 필드를 작성할 때는 여기에 나열된 키만 사용하세요.mediaSlots: 이미지/비디오 기록 필드, count 키, 기본 개수 및 최대 개수.countBindings: 개수 매개변수와 배열 필드의 바인딩.fillPlan에서 숫자 필드는numericBounds를 보고 숫자를 채웁니다:enforced:false는 힌트이며 실제 데이터가 초과할 수 있음,enforced:true는 반드시 준수해야 함,semantics:'normalized'는 0-1 비율로 채움. 고정 길이 중첩 배열은fixedLength/fixedLengths를 보고 인덱스에 따라 채우며, 시행착오를 하지 마세요.controlKeys: 오른쪽 패널에서 조작 가능한 필드로, 일반 콘텐츠 채움 목록이 아닙니다. 사용자가 명시적으로 페이지 속성 조정을 요청한 경우에만 사용합니다. 기본적으로는copyKeys, 보이는 배열 및 실제 미디어 슬롯만 채웁니다.
검증
- 렌더링 전에 반드시
validate:goal-spec을 실행해야 합니다. - 출력 후 반드시
validate:swiss를 실행해야 합니다. - 출력 후 반드시
validate:goal-copy를 실행해야 합니다. - 데모 디스플레이를 변경한 후
npm run showcase:update를 실행하세요.