ppt-creator

---

name: chatppt-creator description: 专业级智能 PPT 全生命周期创作与增强套件。支持通过 yoo-ai API 自动生成、编辑与美化 PPT。当需要执行以下任务时使用此 Skill：(1) 【多源生成】：将简单主题、结构化大纲、本地文件（.docx, .txt）或 AI 编码项目（架构分析）转化为专业 PPT；(2) 【专家流】：需要“先审阅大纲、后生成内容”的高质量创作流程，支持对大纲进行增删改查；(3) 【后期增强】：为已有任务添加演讲稿（Speaker Notes）、在指定位置插入新页面、或更换全局风格（字体、颜色、模板）；(4) 【互动引导】：预览精美封面、实时追踪异步生成任务进度、以及针对“内容太少”或“格式错误”等生成失败情况进行自动诊断与修复；(5) 【绘图PPT】：生成视觉效果极佳但不可编辑的图片型 PPT。适用于“帮我做个 PPT”、“总结这个项目的架构”、“给 PPT 加演讲稿”等指令。

---

ChatPPT-Creator 智能 Skill 套件

这是一个基于意图识别的 PPT 处理工具集。Agent 应根据用户需求自动路由到相应的函数。

核心函数套件

> 注意: 在调用以下命令时，请确保使用脚本的完整路径（相对于项目根目录或绝对路径）。

1. PPT 创建 (Creation)

#### create_ppt_from_text 当用户提供主题或简单描述时调用。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js create_from_text --text "<主题>" --font_name "<字体>" --color "<颜色>" --language "<语言>" --report ""

可用字体: [黑体|宋体|仿宋|幼圆|楷体|隶书] (注意：不支持微软雅黑)。

注意: report 默认为 true，启用在线编辑报告模式。

#### create_ppt_from_custom_outline 当用户提供详细结构化大纲时调用。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js create_from_custom_outline --custom_data '' --font_name "<字体>" --color "<颜色>" --report ""

可用字体: [黑体|宋体|仿宋|幼圆|楷体|隶书]。

注意: report 默认为 true。

#### create_ppt_from_file (Agent 复合任务) 当用户提供本地文件（.txt, .docx 等）时： 1. 读取文件: 使用 Read 工具读取文件内容。 2. 大模型转换: 将内容转换为 create_ppt_from_custom_outline 所需的 JSON 格式。 3. 展示并确认 (关键): 必须将生成的结构化大纲（标题、章节、页面主题）以易读的格式展示给用户，并明确询问：“这是为您生成的大纲，您看是否满意？如果有需要调整的地方请告诉我。” 4. 调用函数: 仅在用户确认满意后，才执行 create_ppt_from_custom_outline。

#### create_ppt_from_file_with_review 使用专家级 Prompt 驱动的工作流，生成高质量 Markdown 大纲，解析为 JSON，供审阅与微调后再生成。

阶段一（生成 Prompt）

node {{SKILL_PATH}}/scripts/chatppt_creator.js create_from_file_with_review --file_path "<本地文件>" --user_prompt "<要求>" --count_1 5 --count_2 3 --language zh-CN 输出 [PROMPT_START]...[PROMPT_END]，请用 LLM 生成 Markdown 并保存到文件。

阶段二（解析与审阅）

node {{SKILL_PATH}}/scripts/chatppt_creator.js create_from_file_with_review --file_path "<本地文件>" --user_prompt "<要求>" --count_1 5 --count_2 3 --language zh-CN --markdown_path "" 输出 [OUTLINE_REVIEW_START]...[OUTLINE_REVIEW_END]。

用户确认 (强制): Agent 必须将输出的大纲内容呈现给用户，并等待用户确认或修改意见。严禁跳过此步骤直接生成。

应用修改（按用户反馈）

准备补丁 JSON（支持 remove_catalog/rename_catalog/remove_sub_catalog/rename_sub_catalog），执行： node {{SKILL_PATH}}/scripts/chatppt_creator.js apply_outline_patch --json_path "" --patch_path ""

最终生成

仅在用户明确表示“可以生成”后，执行： node {{SKILL_PATH}}/scripts/chatppt_creator.js generate_from_outline --json_path "" --font_name "<字体>" --color "<颜色>" --language "zh-CN" --report ""

可用字体: [黑体|宋体|仿宋|幼圆|楷体|隶书]。

注意: report 默认为 true。

#### create_ppt_from_project_analysis 自动分析当前 AI 编码项目的架构 and 技术栈，生成项目总结或汇报 PPT。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js create_from_project_analysis --project_path "<项目绝对路径>" --user_prompt "<汇报重点>"

适用场景: 当用户说“为这个项目写个汇报”或“总结一下我的代码架构”时。

工作流:

1. 脚本扫描项目（依赖、目录、入口点）。 2. 输出专家 Prompt，Agent 调用 LLM 生成 Markdown。 3. 脚本解析并展示大纲供用户审阅。 4. 确认后执行生成。

2. 修改与增强 (Modification)

#### add_speaker_notes_to_ppt 为已有任务生成演讲稿。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js add_notes --task_id "" --report ""

#### insert_page_into_ppt 在指定位置插入新页面。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js insert_page --task_id "" --slide_number "<页码>" --slide_type "<类型>" --text "<内容>" --report ""

#### regenerate_ppt_with_new_style 更换风格重新生成。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js regenerate --task_id "" --font_name "<字体>" --color "<颜色>" --cover_id "<模板ID>" --transition "<1/2>" --report ""

3. 模板与预览 (Template & Preview)

#### preview_ppt_covers 根据标题和风格偏好预览可选的 PPT 模板封面。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js preview_covers --title "<标题>" --style "<风格>" --color "<颜色>" --count 4

可用风格: 科技风, 商务风, 小清新, 极简风, 中国风, 可爱卡通。

#### check_task_status 查看历史任务或特定任务的实时生成进度。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js check_status --task_id ""

无参数调用: node {{SKILL_PATH}}/scripts/chatppt_creator.js check_status (显示最近 10 条记录)

4. 绘图PPT (Banana Style)

> 注意: 此功能生成的 PPT 为图片型幻灯片，拥有极佳的视觉效果，但不支持文本编辑。适用于对设计感要求高、无需二次修改的场景。

#### list_banana_styles 获取绘图PPT可用的风格或模板列表。

命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js list_banana_styles --type "