演示文稿
xiaobei-skill-academic-paper-to-ppt
Use for 小北在读研 / XiaoBei academic paper-to-PPT workflows: generate thesis-defense or project-report decks from uploaded papers, literature, reports, technical documents, and optional PPTX visual templates. Produces a source-grounded outline, an imagegen visual scheme, one complete bitmap per slide, an imagegen provenance manifest, and an image-only PPTX. Do not use when the user needs editable slide text or native editable charts.
xiao24bei · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add xiao24bei/xiaobei-skill --skill xiaobei-skill-academic-paper-to-ppt技能说明
name: xiaobei-skill-academic-paper-to-ppt description: "Use for 小北在读研 / XiaoBei academic paper-to-PPT workflows: generate thesis-defense or project-report decks from uploaded papers, literature, reports, technical documents, and optional PPTX visual templates. Produces a source-grounded outline, an imagegen visual scheme, one complete bitmap per slide, an imagegen provenance manifest, and an image-only PPTX. Do not use when the user needs editable slide text or native editable charts."
小北在读研 · Academic Paper to PPT
Core Behavior
When this skill is triggered, execute the workflow in this exact order:
- Analyze the uploaded source document
- If the user provides a PPT/PPTX template, analyze the template's visual style and page structure
- Create
ppt_outline.md - Generate one complete visual preview scheme based strictly on
ppt_outline.mdusing$imagegen, then immediately display that image inline in the chat - Generate every slide page as a full-page image using
$imagegen; immediately display each completed page image inline in the chat before waiting for the whole deck - Create
imagegen_manifest.jsonrecording the selected$imagegengeneration method and every generated asset - Assemble the generated slide images into a
.pptxfile where each image fills one complete slide - Validate that required output files exist and match the imagegen manifest
Never skip stages unless the user explicitly requests only one stage.
Strict image-only contract:
- A final slide image means the whole finished PPT page is baked into one bitmap, including Chinese title, body text, labels, diagrams, tables, and page visual design.
- The final
.pptxmust contain one full-slide image per slide and no editable visible text boxes. - Background-only slide images are invalid. Do not generate text-free templates, blank layout backgrounds, placeholder panels, blank areas for later text, or editable-text overlays.
- Prompts for final slide images must not include phrases such as
text-free,no readable words,background template,blank areas,editable Chinese text,text to be added later, or equivalent wording. - If
$imagegencannot generate complete page images with the required text, retry with shorter full-page prompts or switch to the other allowed$imagegenmode. If complete page images still cannot be produced, stop at image generation and report the failed stage. Do not assemble a fallback PPT.
Chat-visible image contract:
- Apply this contract to both built-in
image_genand CLI generation. Changing the image backend must not make generated images invisible to the user. - Stage 2 produces one visual-scheme image. As soon as it exists, show it in the chat with local-image Markdown using its absolute path, for example
. - During Stage 3, show each completed slide image individually as soon as it is available. Label it briefly as
第 X/N 页, then render that page with its absolute local path. A text-only progress message such as “已生成 6 页” does not satisfy this requirement. - Do not wait until all pages finish before showing them. Do not replace per-page visibility with only a contact sheet, folder path, file count, or final PPTX link.
- In CLI mode, run generation in a monitorable process and poll for newly completed files. After each poll, display every newly completed
slide_XX.pngindividually before continuing to wait. Limited concurrency is allowed, but the chat must expose each completed page rather than hiding the batch until completion. - In built-in mode, the tool result may render automatically; still add the brief
第 X/N 页label and preserve/copy the selected image into the workspace for manifesting and PPT assembly. - After all pages are visible, optionally add a complete contact sheet for convenient overview, then provide the final PPTX.
Required image-generation dependency:
- The visual preview and full-slide generation stages must load and follow the installed
$imagegenskill. - Use built-in
image_genfirst when the user does not specify a generation mode. - Use CLI mode when the user explicitly requests it or when a real built-in attempt is unavailable or fails, but only through the runtime, endpoint, and credential mechanism authorized in the current user's
$imagegenworkflow. - Do not hardcode a maintainer's workstation path, account name, private endpoint, or credential source. Never display, log, or persist credentials.
- In CLI mode, write generated image files under
outputs/imagegen/and record methodimagegen_cli_fallbackinimagegen_manifest.json. - Use a Python environment with the packages in
requirements.txtfor PowerPoint assembly and validation. - Do not replace
$imagegenwith textual visual suggestions, SVG/vector/code-native drawings, HTML/CSS/canvas mockups, manual diagrams, or a generic image-generation placeholder. - When built-in mode is used, copy the selected generated files from
$CODEX_HOME/generated_images/...or the workspace intooutputs/imagegen/generated_slides/, and record methodbuilt_in_image_geninimagegen_manifest.json. - If an explicitly selected CLI attempt fails to generate real files, try built-in
image_genunless the user asked for CLI only. If the default built-in attempt fails, use CLI only when the current environment authorizes and supports that fallback. - If neither CLI fallback nor built-in
$imagegencan generate real image files, stop at that stage and report the incomplete stage. Do not assemble a PPT from non-imagegen substitutes. - A visual preview generated with
$imagegenis not enough. Every final slide image recorded inimagegen_manifest.jsonmust also be generated with$imagegen. - If CLI fallback fails only for long Chinese prompts, that is not permission to generate text-free backgrounds. First shorten each prompt while preserving the requirement that the final image contains the slide title and key visib