https://godvvvzzz.github.io/tags/productivity/Recent content in Productivity on VvVzzz BlogHugo -- gohugo.iozh-cnWed, 09 Sep 2026 20:20:00 +0800https://godvvvzzz.github.io/p/pptx-generator/Wed, 09 Sep 2026 20:20:00 +0800https://godvvvzzz.github.io/p/pptx-generator/ <blockquote> <p>收录于：<a class="link" href="https://godvvvzzz.github.io/p/awesome-open-source-repos/" >开源仓库收藏夹</a></p> </blockquote> <p><strong>技能路径</strong>：<a class="link" href="https://github.com/MiniMax-AI/skills/tree/main/skills/pptx-generator" target="_blank" rel="noopener" >MiniMax-AI/skills · pptx-generator</a><br> <strong>所在仓库</strong>：<a class="link" href="https://github.com/MiniMax-AI/skills" target="_blank" rel="noopener" >MiniMax-AI/skills</a> · <strong>许可</strong>：MIT</p> <h2 id="它是什么"><a href="#%e5%ae%83%e6%98%af%e4%bb%80%e4%b9%88" class="header-anchor"></a>它是什么 </h2><p><code>pptx-generator</code> 是 MiniMax 官方 skills 集合里的一项 <strong>Agent Skill</strong>，覆盖 PowerPoint 全流程：</p> <table> <thead> <tr> <th>任务</th> <th>做法</th> </tr> </thead> <tbody> <tr> <td>读 / 分析现有 PPT</td> <td><code>python -m markitdown presentation.pptx</code></td> </tr> <tr> <td>基于模板编辑</td> <td>XML 工作流（见 <code>references/editing.md</code>）</td> </tr> <tr> <td>从零创建</td> <td><strong>PptxGenJS</strong>，按页面类型生成 slide 模块再编译</td> </tr> </tbody> </table> <p>它不是「让模型随便画几页」，而是一套<strong>有约束的生成规范</strong>：设计系统、五类页面、主题契约、页码规则、QA 流程都写死在 skill 里。</p> <h2 id="为什么值得看"><a href="#%e4%b8%ba%e4%bb%80%e4%b9%88%e5%80%bc%e5%be%97%e7%9c%8b" class="header-anchor"></a>为什么值得看 </h2><h3 id="1-五类页面--视觉多样性"><a href="#1-%e4%ba%94%e7%b1%bb%e9%a1%b5%e9%9d%a2--%e8%a7%86%e8%a7%89%e5%a4%9a%e6%a0%b7%e6%80%a7" class="header-anchor"></a>1. 五类页面 + 视觉多样性 </h3><p>所有 slide 必须归入五种类型之一：</p> <ol> <li><strong>Cover</strong> 封面</li> <li><strong>TOC</strong> 目录</li> <li><strong>Section Divider</strong> 分节页</li> <li><strong>Content</strong> 内容页</li> <li><strong>Summary</strong> 总结页</li> </ol> <p>并明确要求：<strong>不要连续多页用同一 layout</strong>——避免 Agent 生成「十页长得一样」的 PPT。</p> <h3 id="2-theme-对象契约强制"><a href="#2-theme-%e5%af%b9%e8%b1%a1%e5%a5%91%e7%ba%a6%e5%bc%ba%e5%88%b6" class="header-anchor"></a>2. Theme 对象契约（强制） </h3><p>编译脚本向每页传入固定五色主题：</p> <table> <thead> <tr> <th>Key</th> <th>用途</th> </tr> </thead> <tbody> <tr> <td><code>primary</code></td> <td>最深色，标题</td> </tr> <tr> <td><code>secondary</code></td> <td>深色强调、正文</td> </tr> <tr> <td><code>accent</code></td> <td>中间调强调</td> </tr> <tr> <td><code>light</code></td> <td>浅色强调</td> </tr> <tr> <td><code>bg</code></td> <td>背景</td> </tr> </tbody> </table> <p><strong>禁止</strong>自创 <code>background</code> / <code>text</code> / <code>muted</code> 等 key。Agent 被死死绑在统一主题模型上，多页并行生成时才不会各画各的。</p> <h3 id="3-一页一文件可并行"><a href="#3-%e4%b8%80%e9%a1%b5%e4%b8%80%e6%96%87%e4%bb%b6%e5%8f%af%e5%b9%b6%e8%a1%8c" class="header-anchor"></a>3. 一页一文件，可并行 </h3><p>每页是独立可运行的 JS：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript"><span class="line"><span class="cl"><span class="kd">function</span> <span class="nx">createSlide</span><span class="p">(</span><span class="nx">pres</span><span class="p">,</span> <span class="nx">theme</span><span class="p">)</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="kr">const</span> <span class="nx">slide</span> <span class="o">=</span> <span class="nx">pres</span><span class="p">.</span><span class="nx">addSlide</span><span class="p">();</span> </span></span><span class="line"><span class="cl"> <span class="c1">// ...使用 theme.primary / theme.bg 等 </span></span></span><span class="line"><span class="cl"> <span class="k">return</span> <span class="nx">slide</span><span class="p">;</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span><span class="line"><span class="cl"><span class="nx">module</span><span class="p">.</span><span class="nx">exports</span> <span class="o">=</span> <span class="p">{</span> <span class="nx">createSlide</span><span class="p">,</span> <span class="nx">slideConfig</span> <span class="p">};</span> </span></span></code></pre></div><ul> <li>函数<strong>必须同步</strong>（不能 async）</li> <li>文件可单独 <code>node slide-01.js</code> 预览</li> <li>有 subagent 时最多 5 页并发生成</li> <li>最后 <code>compile.js</code> 统一写入 <code>output/presentation.pptx</code></li> </ul> <p>这是「结构化输出 + 模块化并行」在文档生成上的干净落地。</p> <h3 id="4-设计系统不是空话"><a href="#4-%e8%ae%be%e8%ae%a1%e7%b3%bb%e7%bb%9f%e4%b8%8d%e6%98%af%e7%a9%ba%e8%af%9d" class="header-anchor"></a>4. 设计系统不是空话 </h3><p><code>references/</code> 里拆得很细：</p> <table> <thead> <tr> <th>文件</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td><code>slide-types.md</code></td> <td>五类页面 + 额外 layout 模式</td> </tr> <tr> <td><code>design-system.md</code></td> <td>色板、字体、Sharp/Soft/Rounded/Pill 风格配方、排版间距</td> </tr> <tr> <td><code>editing.md</code></td> <td>模板编辑、XML、常见坑</td> </tr> <tr> <td><code>pitfalls.md</code></td> <td>QA 流程、PptxGenJS 陷阱</td> </tr> <tr> <td><code>pptxgenjs.md</code></td> <td>完整 API 参考</td> </tr> </tbody> </table> <p>中文固定 <strong>Microsoft YaHei</strong>，英文默认 Arial；16:9（10&quot; × 5.625&quot;）；页码徽章除封面外必有，且只显示当前页码（不是 <code>3/12</code>）。</p> <h3 id="5-和只会改-markdown-的-skill不同"><a href="#5-%e5%92%8c%e5%8f%aa%e4%bc%9a%e6%94%b9-markdown-%e7%9a%84-skill%e4%b8%8d%e5%90%8c" class="header-anchor"></a>5. 和「只会改 Markdown 的 Skill」不同 </h3><p>多数 Agent Skill 只动文本。这个 skill 管的是<strong>二进制办公文档</strong>：生成、改、读，还带 QA 门槛。属于 productivity 类 skill 里工程化程度较高的样本。</p> <h2 id="上手claude-code"><a href="#%e4%b8%8a%e6%89%8bclaude-code" class="header-anchor"></a>上手（Claude Code） </h2><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">claude plugin marketplace add https://github.com/MiniMax-AI/skills </span></span><span class="line"><span class="cl">claude plugin install minimax-skills </span></span></code></pre></div><p>依赖：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">pip install <span class="s2">&#34;markitdown[pptx]&#34;</span> <span class="c1"># 读 PPT</span> </span></span><span class="line"><span class="cl">npm install -g pptxgenjs <span class="c1"># 从零创建</span> </span></span></code></pre></div><p>Cursor / Codex / OpenCode 的安装方式见 <a class="link" href="https://github.com/MiniMax-AI/skills#installation" target="_blank" rel="noopener" >仓库 README</a>。</p> <p>触发词：PPT、PPTX、PowerPoint、presentation、slide、deck。</p> <h2 id="同仓库其他技能顺带一提"><a href="#%e5%90%8c%e4%bb%93%e5%ba%93%e5%85%b6%e4%bb%96%e6%8a%80%e8%83%bd%e9%a1%ba%e5%b8%a6%e4%b8%80%e6%8f%90" class="header-anchor"></a>同仓库其他技能（顺带一提） </h2><p>MiniMax skills 里还有同一思路的办公套件：<code>minimax-pdf</code>、<code>minimax-xlsx</code>、<code>minimax-docx</code>，以及前端/全端/移动端/shader 等开发技能。如果你要做「Agent 生成 Office 全家桶」，可以整包接入再按需挑。</p> <h2 id="适合谁"><a href="#%e9%80%82%e5%90%88%e8%b0%81" class="header-anchor"></a>适合谁 </h2><ul> <li>想让 Claude Code / Codex 直接产出<strong>结构稳定、风格统一</strong>的 PPT，而不是随机排版</li> <li>需要「模板编辑 + 从零生成 + 读回分析」三条链路</li> <li>在研究 Agent Skill 怎么管二进制产物、怎么做多页并行、怎么定 theme 契约</li> </ul> <h2 id="和收藏夹里其他项目的关系"><a href="#%e5%92%8c%e6%94%b6%e8%97%8f%e5%a4%b9%e9%87%8c%e5%85%b6%e4%bb%96%e9%a1%b9%e7%9b%ae%e7%9a%84%e5%85%b3%e7%b3%bb" class="header-anchor"></a>和收藏夹里其他项目的关系 </h2><ul> <li>Skill 被 Multica 等平台当作可复用剧本 → <a class="link" href="https://godvvvzzz.github.io/p/multica/" >Multica</a></li> <li>运行这些 Skill 的编码 Agent → <a class="link" href="https://godvvvzzz.github.io/p/pi/" >Pi</a>、Claude Code 等</li> <li>Skill 本体的知识/记忆沉淀 → <a class="link" href="https://godvvvzzz.github.io/p/openviking/" >OpenViking</a></li> </ul> <hr> <p><em>最后更新：2026-09-09。信息基于公开 SKILL.md 与仓库 README，使用前请以官方为准。</em></p>