From de6da3acb4497d6703f220f8f04d2870a0373d0a Mon Sep 17 00:00:00 2001 From: sunbigfly Date: Sat, 21 Mar 2026 04:02:58 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3:=20README=20=E7=94=A8?= =?UTF-8?q?=E6=B3=95=E9=83=A8=E5=88=86=E6=94=B9=E4=B8=BA=E5=AF=B9=E8=AF=9D?= =?UTF-8?q?=E9=A9=B1=E5=8A=A8=E7=9A=84=20skill=20=E9=80=9A=E7=94=A8?= =?UTF-8?q?=E7=94=A8=E6=B3=95=E6=8F=8F=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 30 ++++++++++++++++-------------- README_EN.md | 28 +++++++++++++++++++--------- 2 files changed, 35 insertions(+), 23 deletions(-) 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