lumiflare/ppt-agent-orchestrator skill 本地试跑：先分清编排器、Agent 和最终 PPTX

拿到 lumiflare/ppt-agent-orchestrator 后，需要把它理解成 Python 编排器示例，而不是单独的“PPT 生成 skill”。这个仓库把 Research Agent、Content Organizer Agent、Design Skill 和 PPTX Skill 串起来，从主题开始生成 research JSON、整理后的 content JSON、HTML preview，最后生成 PowerPoint 文件。

它真正适合用来学习 Claude sub-agent 与 skills 如何协作，也适合做一个轻量演示：输入主题、页数和风格，观察每一步在 output/ 下产出什么。第一个限制是环境要求比普通 skill 高：需要 Python 依赖、Anthropic API Key；搜索 API 没配时会走 mock search data，能跑流程，但不能代表真实调研质量。

先补 .env，不要急着跑 topic

仓库根目录提供了 .env.example。最少要复制成 .env，并填入 ANTHROPIC_API_KEY。SEARCH_API_KEY 和 SEARCH_ENGINE_ID 是搜索配置；不填时 QUICKSTART 写明会出现 warning，并使用 mock search data。

git clone https://github.com/lumiflare/ppt-agent-orchestrator.git
cd ppt-agent-orchestrator
cp .env.example .env

.env.example 里还写了 OUTPUT_DIR=./output、RESEARCH_AGENT_MODEL=claude-sonnet-4、ORGANIZER_AGENT_MODEL=claude-sonnet-4 和 MAX_TOKENS=4096。如果第一轮只是验证流程，先不要改太多配置；确认输出目录和 API Key 正常后，再调模型、日志和搜索。

依赖分 Python 和 Node 两层

README 要求 Python 3.8+、Node.js 16+ 和 Anthropic API Key。Python 依赖写在 requirements.txt，包括 anthropic、python-pptx、requests、beautifulsoup4、pydantic、python-dotenv、markitdown[pptx]、lxml、Pillow 等。

pip install -r requirements.txt

Node 侧依赖在 QUICKSTART 里标成可选，主要用于 HTML preview 相关能力：

npm install -g pptxgenjs playwright sharp

如果只想先验证主流程，可以从 Python 依赖和 ANTHROPIC_API_KEY 开始；如果后面要看 HTML 设计和 PPTX 转换细节，再补 Node 侧工具。

第一次试跑看 run.py，不要绕到内部模块

run.py 是快速入口，它会把 orchestrator/ 加入路径，然后调用 orchestrator.main。最小命令如下：

python run.py --topic "AI技術の最新トレンド" --slides 10

带参数时可以指定风格和输出文件名：

python run.py \
  --topic "クラウドコンピューティングの未来" \
  --slides 15 \
  --style modern \
  --output my_presentation.pptx

可选风格是 minimalist、modern、professional、creative。QUICKSTART 建议 10 到 15 页更合适；主题也尽量具体，比如“生成 AI 的企业活用事例”会比只写“AI”更容易组织内容。

结果检查要按四段产物看

运行后看 output/。Research Agent 应输出 output/research/_research.json；Content Organizer Agent 会整理成 output/design/_content.json；Design Skill 会生成 output/design/_design.html；PPTX Skill 会生成 output/presentations/.pptx。此外还有 workflow_summary.json，用于记录本次流程的结果路径。

如果 PPTX 没出现，排查时要沿着四段产物往前看：research JSON 是否为空，content JSON 是否有 slide 结构，HTML preview 是否已经生成设计。四段里哪一段断了，就回到对应 agent 或 skill 的配置，而不是直接改 PPTX 输出路径。

它更像学习编排，不是成品生产线

README 里对 Research Agent、Content Organizer Agent、Design Skill、PPTX Skill 的职责写得很直白：一个负责检索，一个负责组织故事和 slide 结构，一个负责 HTML/CSS/Tailwind 设计，一个负责 PowerPoint 生成。这个设计适合看多 Agent 之间如何交接数据，也适合改造成自己的 PPT 工作流。

但如果你要做严格品牌模板、逐页人工确认、复杂图表或商业交付级 PPT，还需要额外补上模板约束、页面检查、版本控制和人工审阅。这个仓库给了清晰骨架，真正落到生产环境时，不能只依赖默认 mock search、默认 style 和默认输出目录。

lumiflare/ppt-agent-orchestrator 的本地试跑顺序很简单：先填 .env，装好 Python 依赖，必要时补 Node 工具，再从 python run.py --topic ... 起步。跑完后按 research、content、design、presentations 四个目录检查产物，就能判断这套编排链是真通了，还是只跑到了某个中间阶段。