前言¶
做汇报或培训时，常见做法是在幻灯片里从零排版：先列大纲，再逐页填标题和要点。交给通用对话模型写稿，往往还要自己整理成可演示的 .pptx，结构和版式仍要手工收尾。
下面介绍 SkillHub 上的 openclaw-new（坐标 @user_c3f30014/openclaw-new）。它把「主题 → 结构化演示文稿」写成 Agent 可执行的 Skill 约定：先对主题做语义压缩，再按固定命令触发生成，面向商务、技术与培训等需要成稿演示的场景。
这是什么¶
openclaw-new 是社区来源（community）的办公效率类 Skill，当前版本 1.0.0，由 SkillHub 用户 user_c3f30014 发布，分类为 office-efficiency。官方简介为：
Generate professional, structured PowerPoint presentations from optimized topic keywords.
（从优化后的主题关键词生成专业、结构化的 PowerPoint 演示文稿。）
Skill 元数据指向讯飞星火 PPT 相关文档（https://www.xfyun.cn/doc/spark/PPTv2.html），执行前需配置 XF_PPT_APP_ID、XF_PPT_API_SECRET 等环境变量；SkillHub 标签标明 requires_api_key=true。在 SkillHub 页面可见评分 100000、下载 738、安装 0（统计以页面/接口展示为准）。
Skill 包内 frontmatter 中的内部名称为 ppt-generator，与商店展示名 openclaw-new 并存；安装与搜索时以坐标 @user_c3f30014/openclaw-new 为准。
核心功能¶
依据 Skill 包中的 SKILL.md，已写明的能力包括：
- 自动幻灯片大纲：根据优化后的主题生成完整 deck 的结构层次。
- 逻辑层级：强调清晰的章节与页面组织，便于汇报使用。
- 商务向版式：输出描述为「presentation-ready」、多层级页面与商务标准排版（具体版式以讯飞 PPT 服务实际返回为准）。
- 单次确定性生成：一次调用生成一份完整 PPT，不鼓励把原始口语需求直接丢给脚本。
Skill 还要求调用方在触发前对主题做 语义压缩优化（见下文「典型用法」），而不是把用户的原话未经整理传入。
安装与启用¶
安装 SkillHub CLI¶
若本机尚未安装 skillhub，可先按官方安装说明检查或安装：
command -v skillhub && skillhub --version
未安装时，可使用官方推荐的一键脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 openclaw-new¶
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被当前客户端识别。官方页面给出的安装提示为：参考 https://skillhub.cn/install/skillhub.md，安装 @user_c3f30014/openclaw-new。
命令行安装示例（命名空间与 SkillHub 搜索结果一致）：
skillhub install openclaw-new --namespace user_c3f30014 --dir <你的 Agent skills 目录>
常见客户端 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，按所用客户端要求重启或刷新 Skill 列表，使 Agent 能加载新 Skill。
环境与 API¶
SKILL.md 要求：
- 系统 PATH 中可用 Python；
- 配置环境变量：
export XF_PPT_APP_ID=your_app_id
export XF_PPT_API_SECRET=your_api_secret
密钥需自行在讯飞开放平台申请并与星火 PPT 能力对应；Skill 文档未替代官方账号与计费说明，开通与配额以讯飞文档为准。
典型用法¶
1、先优化主题，再调用¶
Skill 对「最终主题」有硬性约定：
- 约 5–10 个词（英文场景为词；中文场景按 Skill 示例使用简短报告式标题）；
- 正式报告式标题，领域明确；
- 不要口语化、不要完整长句。
文档中的对照示例：
| 用户原话 | 优化后的主题 |
|---|---|
| 帮我做一个关于人工智能发展现状的PPT | 人工智能发展现状 |
| 我要介绍一下公司今年的技术规划 | 公司年度技术规划 |
| 做一份给新员工的Java培训PPT | Java新员工培训 |
Agent 在启用本 Skill 后，应先把用户意图收敛为上表这类短语，再进入生成步骤。
2、执行生成命令¶
SKILL.md 规定的调用方式为（{baseDir} 为 Skill 安装目录）：
python {baseDir}/scripts/index.py generate_ppt "<optimized-topic>"
英文示例：
python {baseDir}/scripts/index.py generate_ppt "Artificial Intelligence Industry Trends"
经过上面的步骤，一次调用对应一份完整 PPT 文件；文档列出的输出特征包括结构化页面、多级组织与可直接用于演示的内容布局。
3、在对话里怎么用¶
向已加载该 Skill 的 Agent 说明演示场景与受众，并确认主题已按 Skill 约定压缩。例如：「请按 openclaw-new 规则，把主题定为『公司年度技术规划』，生成汇报用 PPT。」Agent 应检查环境变量与 Python，再执行文档中的 generate_ppt 流程。
适用场景与注意¶
适合谁
- 需要快速从「已定主题」落到
.pptx的业务汇报、战略规划、技术分享、内部培训或学术摘要等场景； - 已在用 Cursor、Claude Code、Codex 等支持 Skill 的客户端，并愿意配置讯飞 PPT 相关密钥的团队或个人。
限制与注意
- API 依赖：无
XF_PPT_APP_ID/XF_PPT_API_SECRET无法按文档执行；SkillHub 标记需要 API Key。 - 主题契约：禁止把用户原始长句直接传给生成脚本，否则与 Skill 设计不符，结构质量也无法保证。
- 单次输出：一次调用只生成一份 deck；文档提到的页数、语言、主题皮肤等扩展能力标注为后续可能增强，当前版本以
SKILL.md正文为准。 - 安装包内容：通过
skillhub install拉取的 1.0.0 包在本地仅包含SKILL.md时，需自行确认是否另有scripts/index.py或需从发布者更新包；执行前应在 Skill 目录下检查scripts/是否存在，避免命令路径落空。
结尾¶
openclaw-new 把「主题优化 + 命令式生成」写进 Skill，让 Agent 在办公场景里按同一套契约产出结构化 PowerPoint，而不是只输出大纲文本。安装、路径与环境变量按 SkillHub 与 SKILL.md 配置即可接入。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_c3f30014/openclaw-new
- API 坐标页：https://api.skillhub.cn/user_c3f30014/openclaw-new
