diff --git a/README.md b/README.md index dccbb10..6a6159e 100644 --- a/README.md +++ b/README.md @@ -82,26 +82,28 @@ ppt-agent-skill/ svg2pptx.py # SVG → PPTX(OOXML 原生 SVG 嵌入) ``` -## 脚本用法 +## 使用方式 -```bash -# 合并预览 -python3 scripts/html_packager.py -o preview.html +在对话中直接描述你的需求即可触发,Agent 会自动执行完整 6 步工作流: -# HTML 转 SVG -python3 scripts/html2svg.py -o - -# SVG 转 PPTX -python3 scripts/svg2pptx.py -o output.pptx --html-dir +``` +你:"帮我做一个关于 X 的 PPT" + → Agent 提问调研需求(等你回复) + → 自动搜索资料 → 生成大纲 → 策划稿 → 逐页设计 HTML + → 自动后处理:HTML → SVG → PPTX + → 输出全部产物到 ppt-output/ ``` -## 触发方式 +**触发示例**: -在对话中,以下表达会触发此 Skill: +| 场景 | 说法 | +|------|------| +| 纯主题 | "帮我做个 PPT" / "做一个关于 X 的演示" | +| 带素材 | "把这篇文档做成 PPT" / "用这份报告做 slides" | +| 带要求 | "做 15 页暗黑风的 AI 安全汇报材料" | +| 隐式触发 | "我要给老板汇报 Y" / "做个培训课件" / "做路演 deck" | -- "帮我做个 PPT" / "做一个关于 X 的演示" -- "做 slides" / "做幻灯片" / "做汇报材料" -- "把这篇文档做成 PPT" / "做培训课件" / "做路演 deck" +> 全程无需手动执行任何脚本,所有后处理(预览合并、SVG 转换、PPTX 生成)由 Agent 在 Step 6 自动完成。 ## 许可证 diff --git a/README_EN.md b/README_EN.md index f7d624a..cc41f66 100644 --- a/README_EN.md +++ b/README_EN.md @@ -65,18 +65,28 @@ ppt-agent-skill/ svg2pptx.py # SVG → PPTX (OOXML native SVG embedding) ``` -## Script Usage +## Usage -```bash -# Merge preview -python3 scripts/html_packager.py -o preview.html +Just describe your needs in the conversation to trigger the skill. The Agent will automatically execute the full 6-step workflow: -# HTML to SVG -python3 scripts/html2svg.py -o - -# SVG to PPTX -python3 scripts/svg2pptx.py -o output.pptx --html-dir ``` +You: "Make a PPT about X" + → Agent interviews you for requirements (waits for your reply) + → Auto research → outline → planning draft → per-page HTML design + → Auto post-processing: HTML → SVG → PPTX + → All outputs saved to ppt-output/ +``` + +**Trigger Examples**: + +| Scenario | What to Say | +|----------|-------------| +| Topic only | "Make a PPT about X" / "Create a presentation on Y" | +| With source material | "Turn this document into slides" / "Make a PPT from this report" | +| With requirements | "15-page dark tech style AI safety presentation" | +| Implicit trigger | "I need to present to my boss about Y" / "Make training materials" | + +> No manual script execution needed. All post-processing (preview merge, SVG conversion, PPTX generation) is handled automatically by the Agent in Step 6. ## Technical Architecture