文档: README 用法部分改为对话驱动的 skill 通用用法描述

This commit is contained in:
sunbigfly
2026-03-21 04:02:58 +08:00
parent e860485ec8
commit de6da3acb4
2 changed files with 35 additions and 23 deletions

View File

@@ -82,26 +82,28 @@ ppt-agent-skill/
svg2pptx.py # SVG → PPTXOOXML 原生 SVG 嵌入)
```
## 脚本用法
## 使用方式
```bash
# 合并预览
python3 scripts/html_packager.py <slides_dir> -o preview.html
在对话中直接描述你的需求即可触发Agent 会自动执行完整 6 步工作流:
# HTML 转 SVG
python3 scripts/html2svg.py <slides_dir> -o <svg_dir>
# SVG 转 PPTX
python3 scripts/svg2pptx.py <svg_dir> -o output.pptx --html-dir <slides_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 自动完成。
## 许可证

View File

@@ -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 <slides_dir> -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 <slides_dir> -o <svg_dir>
# SVG to PPTX
python3 scripts/svg2pptx.py <svg_dir> -o output.pptx --html-dir <slides_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