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 "<true/false>"
• 可用字体: [黑体|宋体|仿宋|幼圆|楷体|隶书] (注意：不支持微软雅黑)。
• 注意: report 默认为 true，启用在线编辑报告模式。

create_ppt_from_custom_outline

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

• 命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js create_from_custom_outline --custom_data '<JSON大纲>' --font_name "<字体>" --color "<颜色>" --report "<true/false>"
• 可用字体: [黑体|宋体|仿宋|幼圆|楷体|隶书]。
• 注意: 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 "<markdown文件路径>"

  输出 [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 "<outline.json>" --patch_path "<patch.json>"

• 最终生成

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

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

• 注意: 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 "<ID>" --report "<true/false>"

insert_page_into_ppt

在指定位置插入新页面。

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

regenerate_ppt_with_new_style

更换风格重新生成。

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

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 "<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 "<style/template>"
• 参数: type 默认为 style。

create_banana_ppt

创建绘图PPT。

• 命令: node {{SKILL_PATH}}/scripts/chatppt_creator.js create_banana_ppt --text "<主题>" --style "<风格ID>" --complex "<1/2/3>"

• 参数:

  • text: PPT 主题或简要描述。
  • style: 风格 ID (通过 list_banana_styles 获取)。
  • complex: 复杂度 (1-简单, 2-中等, 3-复杂)，默认为 1。
  • import_image: 参考图 URL (可选，当不指定 style 时使用)。

• 交互:

  • Agent 必须在调用前明确告知用户：“绘图PPT生成的幻灯片无法编辑文本，但视觉效果更好。确认要使用此模式吗？”
  • 如果用户选择此模式但未指定 style 或 import_image，Agent 应主动询问：“您是想从【预设风格列表】中选择一个，还是提供一张【参考图】来定制风格？”
  • 结果反馈 (强制): 当任务完成（脚本输出 [TASK_COMPLETED]）时，Agent 必须主动 向用户报告：“您的绘图 PPT 已生成并下载到本地：[文件路径]”。严禁保持沉默等待用户询问。
  • 风格选择流程: 若用户选择“预设风格”，Agent 必须 主动调用 list_banana_styles 展示所有可用风格（含ID与预览图），然后等待用户选择 ID。
  • 参考图流程: 若用户选择“参考图”，Agent 必须提示用户：“请提供图片的 网络链接 (URL)。目前仅支持公网可访问的图片链接，暂不支持直接上传本地图片。”获取 URL 后使用 --import_image 参数生成。

5. 绘图PPT 风格知识库 (Style Knowledge Base)#

Agent 应利用以下内置知识，根据用户描述（如“可爱”、“商务”、“简约”）主动推荐风格 ID。

风格ID名称关键词预览图URLdzgSKy现代波普风通用https://image.yoojober.com/upload-m/2025-12/694b8d00a930e.png``pBUWQj小狗绘本风卡通, 动漫https://image.yoojober.com/upload-m/2025-12/694b8e2e93b69.png``QPQPrk极简弥散光感风极简, 商务https://image.yoojober.com//users/2025-12/694d0e4b187ff.jpg``kbgWaR法式浪漫水粉插画风艺术, 手绘https://image.yoojober.com//users/2025-12/694d26085101d.jpg``ptCVxw复古摩登艺术画廊风复古, 艺术, 手绘https://image.yoojober.com/upload-m/2025-12/694b8ef638ed0.png``9mc6qh栅栏极简主义风极简, 商务https://image.yoojober.com/upload-m/2025-12/694b8f4f8665f.png``XPd6kB3D黏土3Dhttps://image.yoojober.com/users/2025-12/694ca476a98fc.jpg``7eFV4p点阵涂鸦风通用https://image.yoojober.com/upload-m/2025-12/694b9042214d0.png``GTG4ZT水墨风国风https://image.yoojober.com//users/2025-12/694ceb081bdfb.jpg``RAzjZZ橙色国风美学风国风https://image.yoojober.com/upload-m/2025-12/694b909651380.png``DUUkcN梦幻水彩风艺术, 手绘https://image.yoojober.com/upload-m/2025-12/694b9054a89ca.png``m526yq线稿插图风通用https://image.yoojober.com//users/2025-12/694d26d0bf718.jpg``4WuSkQ复古双色Riso印刷插画风复古, 艺术, 手绘https://image.yoojober.com/upload-m/2025-12/694b8fa58790f.png``BEY52Y治愈系蜡笔手绘风艺术, 手绘, 可爱, 治愈https://image.yoojober.com/upload-m/2025-12/694b8fe3ec997.png``CKejSY北欧风复古水粉插画风复古, 艺术, 手绘https://image.yoojober.com//users/2025-12/694d31dd3e785.jpg``NKdGBE热血漫画风卡通, 动漫https://image.yoojober.com//users/2025-12/694d278f8fec3.jpg``Evc69b未来科技抽象渐变风科技, 未来https://image.yoojober.com/upload-m/2025-12/694b9030156ac.png``EhRqGC独立漫画涂鸦黄风卡通, 动漫https://image.yoojober.com/upload-m/2025-12/694b908e3bb0f.png``zUJpC3复古波普奶油风复古https://image.yoojober.com/upload-m/2025-12/694b90a423caf.png``DF7VsS现代几何扁平风扁平https://image.yoojober.com/upload-m/2025-12/694b90bb7b2b5.png``hTh7ev暗黑几何杂志风暗黑, 酷炫https://image.yoojober.com/upload-m/2025-12/694b983b878c5.png``wZxfcW环保拼贴手账风通用https://image.yoojober.com//users/2025-12/694cbc420a978.jpg``uKeTY3复古电影手账风复古https://image.yoojober.com//users/2025-12/694d0b9117d4c.jpg``h7upNw复古报纸版式风复古https://image.yoojober.com/users/2025-12/694cad551094e.jpg``95CDPf绿色智慧工业风通用https://image.yoojober.com/upload-m/2025-12/694b97ebbf329.png``JCBCM8创意白板手绘风艺术, 手绘https://image.yoojober.com/upload-m/2025-12/694b97bd7a821.png``yc4xdn千禧数码像素波普风科技, 未来https://image.yoojober.com/upload-m/2025-12/694b96b0ab08d.png``BaPbZD3D乐高风3Dhttps://image.yoojober.com//users/2025-12/694cdeacc330e.jpg``NkXPB2酸性绿独立杂志风通用https://image.yoojober.com/upload-m/2025-12/694b97a20cb64.png``bE35kC课堂笔记本风通用https://image.yoojober.com/upload-m/2025-12/694b957809262.png``QjymSk蓝调喷枪极简风极简, 商务https://image.yoojober.com//users/2025-12/694cbd456a062.jpg``X4wwxk粉色怪诞字体波普风通用https://image.yoojober.com/upload-m/2025-12/694b955cb5c90.png``sk5YQf3D流体玻璃拟态风3Dhttps://image.yoojober.com//users/2025-12/694d2d68ab32e.jpg``yMNSMB充气膨胀风通用https://image.yoojober.com//users/2025-12/694ce97d1524c.jpg``6xwPyv立体毛毡风通用https://image.yoojober.com/upload-m/2025-12/694b94b90737c.png``3f9VWn温暖梦幻风通用https://image.yoojober.com/upload-m/2025-12/694b94a624c6b.png``HemEtk磨砂立体几何风通用https://image.yoojober.com/upload-m/2025-12/694b947866636.png``9RrScC马蒂斯猫咪风通用https://image.yoojober.com/upload-m/2025-12/694b942937313.png``TFGzHR锦鲤图纹风通用https://image.yoojober.com/upload-m/2025-12/694b941a62698.png``ADmBu4以梦为马主题风通用https://image.yoojober.com//users/2025-12/694d282e1b7d6.jpg``uzEnzz水彩晕染马年主题风艺术, 手绘https://image.yoojober.com/upload-m/2025-12/694b93c31776e.png``wsNHz9极简水彩插画风极简, 商务, 艺术, 手绘https://image.yoojober.com/upload-m/2025-12/694b939c1163a.png``92WGRw山海绘卷风通用https://image.yoojober.com//users/2025-12/694cb541e1d3c.jpg``hxERQw治愈童趣风可爱, 治愈https://image.yoojober.com/upload-m/2025-12/694b932137083.png``Sydy3t东方插画风艺术, 手绘, 国风https://image.yoojober.com/users/2025-12/694bf5d001f32.jpg``f58YXJ抽象花卉风通用https://image.yoojober.com/upload-m/2025-12/694b92ec7a958.png``R4Z72Q暗黑Y2K液态金属风暗黑, 酷炫https://image.yoojober.com//users/2025-12/694d28e46456d.jpg``4SMNee90年代复古系统界面风复古https://image.yoojober.com/upload-m/2025-12/694b924922730.png``jBSqcBSaaS极简风极简, 商务https://image.yoojober.com//users/2025-12/694d3522557c5.jpg``2p9Z79Chikawa风通用https://image.yoojober.com/upload-m/2025-12/694b91d0e1718.png``3WXC5Z蜡笔小新风通用https://image.yoojober.com/upload-m/2025-12/694b919d2c366.png``pfudeP任天堂游戏风游戏https://image.yoojober.com/upload-m/2025-12/694b918772109.png``NrQVUC3D西游记风3Dhttps://image.yoojober.com/upload-m/2025-12/694b98b417bff.png``SRJmXq我的世界像素风格科技, 未来, 游戏https://image.yoojober.com/upload-m/2025-12/694b98c12ce45.png``bZ6Xkp中国年画风国风https://image.yoojober.com/upload-m/2025-12/694b98ceb97cf.png``mc4Xj9美式漫画风格卡通, 动漫https://image.yoojober.com/upload-m/2025-12/694b99300be89.png``RAPQvH哆啦A梦风通用https://image.yoojober.com/upload-m/2025-12/694b993e8311e.png``YRNyXV猫和老鼠风通用https://image.yoojober.com//users/2025-12/694cec7c8e726.jpg``TFBqB6小黄人风通用https://image.yoojober.com/users/2025-12/694caad600eed.jpg``jvHgwB圣诞风通用https://image.yoojober.com/upload-m/2025-12/694b99b042c4a.png``rDYGqb阿凡达风通用https://image.yoojober.com/upload-m/2025-12/694b99dab2c09.png``ktvf5H纪念碑谷风通用https://image.yoojober.com/upload-m/2025-12/694b9a40516fe.png``XbQQSt疯狂动物城风通用https://image.yoojober.com//users/2025-12/694d2a5094ee4.jpg``AUfyVT马里奥像素风科技, 未来, 游戏https://image.yoojober.com/upload-m/2025-12/694b9b01b3872.png``wxPbdm鬼灭之刃风通用https://image.yoojober.com/users/2025-12/694d0abe3aaa0.jpg``efqRjR名侦探柯南风通用https://image.yoojober.com/upload-m/2025-12/694b9b1c604e3.png``K4HTNR3D Pingu风3Dhttps://image.yoojober.com/upload-m/2025-12/694b9b68b41db.png``mSpQqYloopy风格通用https://image.yoojober.com/upload-m/2025-12/694b9bb91ed40.png``dTWkfh三丽鸥风格通用https://image.yoojober.com/upload-m/2025-12/694b9bc594323.png``JXrGsT星之卡比风通用https://image.yoojober.com/users/2025-12/694bfffb46cea.jpg``wdxmJ7雪王可爱风可爱, 治愈https://image.yoojober.com/upload-m/2025-12/694b9c5fa1ddb.png``craTgk王者荣耀风通用https://image.yoojober.com/upload-m/2025-12/694b9c6d5674d.png``7kEbnBLOL风通用https://image.yoojober.com/upload-m/2025-12/694b9c7a2da76.png``NKhYbh彩铅尼克风通用https://image.yoojober.com/upload-m/2025-12/694b9c91a5e5b.jpg``xh5HzJ怀旧撕纸拼贴风复古https://image.yoojober.com/upload-m/2025-12/694b9ce097b81.png``JPuXDR牛皮贴纸风通用https://image.yoojober.com/upload-m/2025-12/694b9cef60c25.png``4c7NDA复古航空信笺风复古https://image.yoojober.com/upload-m/2025-12/694b9cfda7801.png``2aPM69MBB咨询精英汇报风商务, 专业https://image.yoojober.com//users/2025-12/694d2c335521e.jpg``JdC6wU空灵禅意山水风通用https://image.yoojober.com/upload-m/2025-12/694b9da985ea5.png``9yvrzC新春祥瑞红金风通用https://image.yoojober.com/users/2025-12/694ca846e69a8.jpg``rgRcCT大字报风通用https://image.yoojober.com/users/2025-12/694ca9bf34f27.jpg``9FX5DZ暗黑弥散风暗黑, 酷炫https://image.yoojober.com//users/2025-12/694cd77806948.jpg``fXUkzh辛普森风格通用https://image.yoojober.com//users/2025-12/694cd8ce63ef7.jpg``meshdF吉卜力风通用https://image.yoojober.com//users/2025-12/694cdbda134be.jpg``Rmhdpu梦幻水彩手绘风艺术, 手绘https://image.yoojober.com/upload-m/2025-12/694b9e3720af4.png``US59E8拼豆风通用https://image.yoojober.com/upload-m/2025-12/694b9f22ef20d.png``AQQmPN格林童话风通用https://image.yoojober.com/upload-m/2025-12/694b9f33dd8e9.png``GBKsgV昭和漫画风通用https://image.yoojober.com/upload-m/2025-12/694b9f43a95f0.png``BUT5VW90s樱桃小丸子风通用https://image.yoojober.com/upload-m/2025-12/694b9f520538e.png``C9k8jQ80年代复古波普像素风复古, 科技, 未来https://image.yoojober.com/upload-m/2025-12/694b9f7066aea.png``eQxdvMGoogle Material风通用https://image.yoojober.com/upload-m/2025-12/694ba05572cdf.png``J6peZh利希滕斯坦风通用https://image.yoojober.com//users/2025-12/694d2cb5bc36b.jpg``aFRBmf花生漫画风卡通, 动漫https://image.yoojober.com/upload-m/2025-12/694ba16242cbd.png``ReURBp小王子极简绘本风卡通, 动漫, 极简, 商务https://image.yoojober.com/upload-m/2025-12/694ba21a63481.png``75XqKz3D纸雕风3Dhttps://image.yoojober.com/upload-m/2025-12/694ba24f1e771.png``67pB84蓝晒印相风通用https://image.yoojober.com/upload-m/2025-12/694ba35c63da5.png``BWmPKkX光透视风通用https://image.yoojober.com/upload-m/2025-12/694ba3687d402.png``jxNyKt微缩积木风通用https://image.yoojober.com/upload-m/2025-12/694bf4247f41e.png``EFF93n极致简洁极简, 商务https://image.yoojober.com//users/2025-12/694d32b94c004.jpg``T4GX4a黑板报风通用https://image.yoojober.com//users/2025-12/694d2df3d3569.jpg``Z6fgKuINS风软萌插画艺术, 手绘, 可爱, 治愈https://image.yoojober.com/upload-m/2025-12/6951ef9dc837b.png``tPzYXg拟人潮玩风通用https://image.yoojober.com//users/2025-12/6951efd8a8910.png

推荐策略:

1. 主动推荐: 当用户询问“有哪些风格”时，Agent 应从上述知识库中挑选 3-5 个涵盖不同类型（如：1个商务、1个可爱、1个国风、1个3D/创意）的风格进行展示。

2. 语义匹配:

   • 想要“专业、正式、汇报用” -> 推荐 2aPM69 (MBB咨询) 或 EFF93n (极致简洁)。
   • 想要“可爱、童趣、给孩子看” -> 推荐 XPd6kB (3D黏土) 或 pBUWQj (小狗绘本)。
   • 想要“中国特色、古典” -> 推荐 GTG4ZT (水墨风) 或 Sydy3t (东方插画)。
   • 想要“酷炫、有设计感” -> 推荐 yMNSMB (充气膨胀) 或 R4Z72Q (暗黑Y2K)。

3. 展示要求: 必须输出 风格名称、 ID 和 预览图（使用 Markdown 图片语法展示预览图，让用户直观看到效果）。

4. 兜底引导: 如果知识库中没有用户想要的风格，或者用户表示“不喜欢这些推荐”，Agent 必须 主动提示：“如果您有自己喜欢的风格图片，可以直接提供图片的网络链接 (URL)，我可以根据您的参考图来生成专属风格的 PPT。”

交互准则#

1. 意图识别与模式路由 (Intent & Routing)#

Agent 应从自然语言中提取参数，并在执行前确认用户偏好的 生成模式。

场景 A: 用户仅提供主题 (Text-to-PPT) 当用户指令为“生成一个关于[主题]的PPT”且未明确指定模式时，Agent 严禁直接调用 create_from_text，必须先询问用户选择哪种模式：

1. 标准模式 (Standard): 生成可编辑的 PPT 页面，包含文本框和图形。适用于需要后续修改内容、调整大纲的场景。（对应 create_from_text）
2. 绘图模式 (Banana/Image-based): 生成 不可编辑 的图片型 PPT，视觉效果极佳，支持指定风格或上传参考图。适用于追求设计感、无需修改文字的场景。（对应 create_banana_ppt）

话术示例: "为您准备了两种生成模式：

1. 标准模式：生成可编辑的普通 PPT，适合需要修改内容的文档。
2. 绘图模式：生成精美的图片型 PPT（不可编辑文本），支持指定风格或参考图，视觉效果更好。 请问您想使用哪种模式？"

场景 B: 高质量/长文档需求

• 对于 高质量、专业性强 的汇报需求，Agent 必须 优先引导用户使用 create_ppt_from_file_with_review 或 create_ppt_from_project_analysis 流程。
• 基本的 create_from_text 仅适用于极其简单的草稿需求，内容会非常简略。

2. 参数传递约束 (Parameter Whitelist)#

重要: 为了避免 API 报错，Agent 必须严格遵守以下参数规定：

1. 禁止推测字体: 绝对禁止自行推测或默认添加 --font_name "微软雅黑"。
2. 静默政策: 如果用户没有在指令中明确要求特定字体（例如：“用宋体”），你 绝对禁止 在生成的命令中包含 --font_name 参数。
3. 字体白名单: 仅允许使用以下字体： 黑体、 宋体、 仿宋、 幼圆、 楷体、 隶书。如果用户要求的字体不在名单内（如微软雅黑），请忽略该要求或引导用户选择白名单内的字体。

3. 立即反馈，后台处理#

启动任何生成任务后，脚本会立即输出 [EDITOR_URL_START]url[EDITOR_URL_END] 作为“实时工作台”。 Agent 动作:

1. 立即提取此链接。
2. 告知用户：“任务已成功启动，正在后台异步处理。您可以点击此处 [进入在线工作台] 实时观看 PPT 的渲染生成过程。生成完成后我会自动为您下载到本地。”
3. 严禁在任务未完成前阻塞用户。

4. 分开输出与链接约束 (Output Constraints)#

重要: 为了保持交互的清晰度，Agent 必须 强制执行 以下输出规范：

1. 严禁混合输出: 在线工作台链接（任务开始时）和本地下载成功的确认信息（任务完成下载后） 绝对禁止 在同一次对话回复中同时展示。

2. 禁用 Markdown 链接: 不要使用 [文本](链接) 语法。必须将 URL 放置在 代码块 中，或以 纯文本 形式展示。

3. 识别标记:

   • 实时工作台: 识别 [EDITOR_URL_START] 和 [EDITOR_URL_END]。
   • 最终编辑链接: 任务完成后再次确认 [EDITOR_URL_START]。
   • 预览图片: 识别 [IMAGE_URL_START] 和 [IMAGE_URL_END]。

4. 分阶段展示:

   • 任务启动后：仅展示“实时工作台链接”。
   • 任务完成后：仅展示“下载路径”和“编辑链接”。

5. 错误诊断与协议 (Error Handling & Protocol)#

如果接口调用返回 400 错误，或运行报错：

1. 任务失败 (-1/3):

   • Agent 禁止 仅复读错误信息。
   • 必须从脚本输出中提取失败原因，并主动调用 node {{SKILL_PATH}}/scripts/chatppt_creator.js validate_outline --json_path "<path>" 进行诊断。
   • 反馈示例：“生成中断了，原因是‘内容长度不足’。我已经找到了问题，是否需要我为您补充内容后重新生成？”

2. API Key 缺失:

   • Agent 应主动询问用户：“我发现您还没有配置 yoo-ai 的 API Key。如果您已有 Key，请告诉我，我将为您自动创建配置文件。如果您还没有 Key，可以前往 yoo-ai 官网获取。”
   • 获取 Key 后，调用 Write 工具将 Key 写入 {{SKILL_PATH}}/config.json，格式为 {"API_KEY": "用户提供的KEY"}。

3. JSON 校验失败:

   • Agent 应调用 node {{SKILL_PATH}}/scripts/chatppt_creator.js validate_outline --json_path "<path>" 来获取具体的错误列表。

4. 重试: 修复后，再次运行 generate_from_outline。

6. 异步追踪 (Asynchronous Tracking)#

如果用户关闭了对话或链接失效，Agent 应引导用户使用：

• node {{SKILL_PATH}}/scripts/chatppt_creator.js check_status --task_id "<ID>" 找回任务状态及最新链接。

7. 主动引导 (Proactive Guidance)#

重要: 每次任务完成（看到 [TASK_COMPLETED] 标记）后，Agent 必须 主动询问用户是否需要进一步修改，例如：

"您的 PPT 已生成并下载。需要我为您做进一步的修改吗？例如 添加演讲稿、 更换主题色或模板，或者 插入新的页面？"

如果在开始前用户对风格不确定，可以引导：

"在生成之前，您想先看看几种不同风格（如商务风、极简风）的 模板封面 吗？"

配置#

确保 config.json 中已配置 API_KEY。参考 config.json.template。