プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

GordenPPTSkill Skill

リポジトリ ↗

作者:GordenSun★ 4,1541 個の skill

インストール

What it does

AI-friendly PPT builder skill: 17 hand-polished Chinese PPTX templates + non-destructive text-only editing tools (python-pptx based). Pick a template, write edits.json, build a real .pptx with the layout intact. Personal/research use only.

  • Connects Instruction files the AI reads
  • Account or key No key found in README or SKILL.md
  • Category コーディング
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/gordensun-gordenpptskill.svg)](https://mcp.popnx.com/en/skills/gordensun-gordenpptskill)

一緒に使える

同じ作業で AI をサービスにつなぐ MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

作者:morluto広く使われている↓ 38.9万/週★ 46.9万7 日前更新

MCP · サービスにつなぐパソコンで動く

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

作者:fallow-rs広く使われている↓ 244.1万/週★ 5383今日更新

MCP · サービスにつなぐパソコンで動く

似た Skill

同じ種類の作業。Skill 一覧と同じ並び

似たものと比べる
これ
GordenPPTSkill
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
作者GordenSunmorlutomultica-aiGraphify-Labsharry0703
Skill 数11111
GitHub スター4,154468,733234,332150,287144,566
最終コード更新2026年6月22日2026年11月19日2026年4月20日2026年11月18日2026年11月18日
ライセンス–MIT–Apache-2.0MIT

GordenSun による 1 個の Skill(指示セット)。AI が読んでそのとおりに作業します · MCP server ではありません

Skill と MCP の違い

MCP = 手

AI を外部のサービスやデータにつなぎます(例:Notion を読む、請求書を作る)。プログラムやサーバーが動いている必要があります。

Skill = 手順書

作業のやり方を AI に教えるテキストファイル。どのサービスにもつながりません。

重なる部分もあります。ツールを呼ぶスクリプト付きの Skill や、知識だけを渡す MCP もあります。やりたい作業から選んでください。

使えるアプリ

提供元の記載なし · SKILL.md 形式の Skill は Claude Code、Codex、Cursor など Agent Skills 対応アプリで使えます

インストール

Is it safe?

  • Who made it

    GitHub account GordenSun (person), 13 years old

  • Use and upkeep

    ★ 4,154 stars · code last changed 2026年6月22日

  • Any scripts?

    6 scripts that can run on a computer: scripts/apply_update.py, scripts/build_manifest.py, scripts/build_pptx.py, scripts/check_update.py and 2 more

  • Uses the internet?

    Scripts that go online: scripts/check_update.py, scripts/apply_update.py

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 7d4a61c (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

まず:どの AI を使っていますか

使っているアプリを選ぶと、そのアプリでのインストール方法だけが表示されます

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the gordenpptskill folder again. The ZIP must have a gorden-ppt-skill folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick gorden-ppt-skill.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026年11月12日 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Claude Code にインストールしてもらう

この文をコピーして Claude Code のチャットに貼り付けます

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.claude/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .claude/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code を開き直し、/GordenPPTSkill と入力するか関連する作業を頼むと Claude が自動で使います

Checked against official docs 2026年11月12日 · Source: code.claude.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.claude/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.claude/skills/gordenpptskill
  3. Claude Code を開き直し、/GordenPPTSkill と入力するか関連する作業を頼むと Claude が自動で使います

自分でインストールした Skill は ChatGPT デスクトップアプリ、Codex CLI、IDE の Codex 拡張機能で使えます · Web 版とモバイル版の ChatGPT では自分でインストールした Skill は使えず、ディレクトリのプラグインに含まれる Skill だけが使えます

ChatGPT デスクトップアプリ

ChatGPT デスクトップアプリには Codex が組み込まれていて、Codex は ~/.agents/skills フォルダから Skill を読み込みます

Option 1ChatGPT にインストールしてもらう

ChatGPT デスクトップアプリで Codex を開き、この文をチャットに貼り付けます

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.agents/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .agents/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2自分でフォルダを置く

gorden-ppt-skill フォルダを ~/.agents/skills/gorden-ppt-skill に置きます

~ はホームフォルダ($HOME)です

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.agents/skills/gordenpptskill

インストールしたあと

  • ChatGPT デスクトップアプリ:サイドバーの Skills を開いて Skill があるか確認します
  • 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します
  • Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Web 版とモバイル版の ChatGPT

自分でインストールした Skill は使えません。ディレクトリのプラグインに含まれる Skill だけが使えます

この Skill を ChatGPT で使うには、上の方法で ChatGPT デスクトップアプリを使ってください

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Option 1Codex にインストールしてもらう

この文をコピーして Codex のチャットに貼り付けます · ChatGPT デスクトップアプリ内の Codex、Codex CLI、IDE 拡張機能で使えます

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.agents/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .agents/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex は新しくインストールした Skill を自動で見つけます。表示されない場合は Codex を再起動してください · 使い方:ChatGPT では @ を入力して Skill を選びます · Codex CLI や IDE 拡張機能では /skills を実行するか、$ に続けて Skill 名を入力します

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.agents/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.agents/skills/gordenpptskill
  3. Codex を開き直して関連する作業を頼むと、Codex が skill を一覧に出します

Option 1Cursor にインストールしてもらう

この文をコピーして Cursor のチャットに貼り付けます

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.cursor/skills/gorden-ppt-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .cursor/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor の Agent チャットで / を入力し GordenPPTSkill を選ぶ

Checked against official docs 2026年11月12日 · Source: cursor.com

For Terminal users

Skill は AI が従う指示です。入れる前にファイルを読み、信頼できる提供元のものだけを入れてください。

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:下のコマンドは PowerShell では動きません。上の「AI にインストールしてもらう」を使ってください

  2. skill フォルダを ~/.cursor/skills にコピー

    repo を一時フォルダにダウンロードし、SKILL.md のあるフォルダだけをコピーします

    git clone --depth 1 https://github.com/gordensun/gordenpptskill.git /tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-gordensun-gordenpptskill-7d4a61c/.' ~/.cursor/skills/gordenpptskill
  3. Cursor の Agent チャットで / を入力し GordenPPTSkill を選ぶ

Option 1Let the AI install it

Skill を読めるほかのアプリ向けです。この文には Claude Code、Codex、Cursor のパスが入っていて、AI が使っているアプリに合わせて選びます · Copy this sentence into the app’s chat

Where to install
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) for all my projects, at ~/.claude/skills/gorden-ppt-skill (in Codex use ~/.agents/skills/gorden-ppt-skill, in Cursor ~/.cursor/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill gorden-ppt-skill from https://github.com/gordensun/gordenpptskill (commit 7d4a61c) into the project this chat is open in (at .claude/skills/gorden-ppt-skill; in Codex use .agents/skills/gorden-ppt-skill, in Cursor .cursor/skills/gorden-ppt-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI や GitHub Copilot など Agent Skills 対応の他のアプリはフォルダが違います。そのアプリのガイドを見て、SKILL.md のあるフォルダをコピーしてください。

GitHub で見る ↗

2026年11月11日 に Claude Code、Codex、Cursor の公式ガイドで skill フォルダを確認

✓ コマンド確認済み 2026年11月16日

元の SKILL.md を見る

以下は提供元の repo の文章で、PopNx MCP の指示ではありません

7,928 文字 · GitHub で全文を開く

---
name: gorden-ppt-skill
description: >-
  用 21 套内置中文 PPT 模板(或用户自带的 .pptx 模板)生成与编辑 PowerPoint 演示文稿:只替换文字、不破坏原排版/配色/字号,内置按文本框尺寸的出框检测与同级标题字号一致校验;也支持完全原创的简洁版式。当用户要"做 / 生成 / 制作 / 编辑一份 PPT / 演示文稿 / 幻灯片 / .pptx",或需要工作汇报、年终与季度总结、述职竞聘、项目复盘、开题答辩、商务提案、教学课件、数据可视化等成品 PPTX 时使用。Use when the user wants to create or edit a PowerPoint / PPT / slides / .pptx deck, pick from built-in templates, or apply their own template without breaking the layout.
---

# gorden-ppt-skill

> **版本** 见同目录 [`VERSION`](./VERSION)。

---

## 🚨 启用本 Skill 后做的第一件事:跑一次自动更新

任何 AI 在本会话**第一次用到这个 Skill 时**,**必须**先把下面这条命令作为它的第一个 tool call:

```bash
python3 scripts/apply_update.py
```

这条命令会自动:
1. 从远端 `update_source`(git+ 仓库)拉取最新 `updates.json`
2. 比对本地 `VERSION` 与远端 `latest_version`
3. 如果有新版本 → 只下载真正变动的文件(增量更新,无 LFS 流量浪费)
4. 如果已是最新 → 几秒内退出,输出 `OK   Nothing to do`

⚠️ 本 Skill **不会自动 push 更新**,必须由 AI 主动 pull。如果跳过这一步,可能在用过期版本,行为、规则、模板都可能与文档不符。

✅ 同一会话内只需做一次,后续 tool call 不必重复检查。

---

> **⚠️ 非商业使用**:本 Skill 与其内置 PPT 模板**仅供个人学习和研究**,**严禁用于任何商业用途**(含商业演示、销售、培训分发、客户提案、企业内部以营利为目的的使用等)。模板素材来自第三方设计师作品,二次商用需要获取原作者授权。

## 何时使用本 Skill

当用户的需求满足下列任何一项就调用本 Skill:

- 需要"做一份 PPT / 演示文稿 / 幻灯片",无论是工作汇报、年终总结、季度复盘、项目提案、述职竞聘、教学课件、开题答辩、读书报告……
- 用户给了文字大纲或一段描述,希望"做成 PPT"
- 用户拿来一份 .pptx 文件,希望"按这个模板做一份新的"
- 用户希望"调整 / 编辑 PPT 的某些文字",且要求"不破坏排版"
- 用户希望对比多个 PPT 模板,选一个合适的

## 更新机制说明

完整的更新工具有两个脚本:

| 脚本 | 干嘛 | 何时用 |
|---|---|---|
| `scripts/apply_update.py` | **检查 + 应用**(一步到位) | **每次启用 Skill 第一件事**(见顶部红框) |
| `scripts/check_update.py` | 仅检查、不应用,列出会变的文件 | 当你只想预览改了什么、不想立即更新时 |

如果只想先看变化再决定要不要升级:

```bash
python3 scripts/check_update.py     # 列出 added / modified / removed
```

`updates.json` 的 `update_source` 已配置为 `git+https://github.com/GordenSun/GordenPPTSkill.git#main`,开箱即用,无需修改。

## 三种模式

收到用户需求后,先判断走哪种模式:

### 模式 A:从内置模板里挑

**默认走这条路。** 21 套内置模板覆盖了绝大多数中文场景。

1. **读 [`templates/INDEX.md`](./templates/INDEX.md)** ——一份精简清单,列出每套模板的风格、主色、适用场景、页数。
2. **匹配用户输入** —— 把用户描述(场景、风格关键词、所需页面类型、颜色偏好)和每个模板的 intro.md 对比。
3. **选模板的决策规则**:
   - **用户已明确指定模板** → 直接用。
   - **你高度确信只有 1 个模板最合适**(场景 + 风格 + 主色都强匹配,且明显优于其它)→ 可直接用,但开工前一句话告诉用户你选了哪个、为什么,给用户一个否决的机会。
   - **其余所有情况(用户没指定,或你不能完全把握哪个最合适)→ 必须让用户来选**:
     - 用 AskQuestion 提供 **正好 3 个**候选模板,每个附上一句话理由(风格 / 适用场景 / 页数),并**把对应的 `templates/<slug>/preview.png` 一并展示**给用户看图决策。
     - 选项里**始终额外带一个「都不满意,换一批」**。用户选它时,再按匹配度给出**另外 3 个**没出现过的候选(同样附预览图)。可反复换,直到用户选定或候选用尽。
     - 候选都用尽仍不满意 → 询问用户更具体的偏好(风格 / 颜色 / 场景),或转模式 C 原创。
   - ⚠️ 不要在没让用户看预览图的情况下,仅凭模糊匹配就自作主张定一个模板。
4. **拿到目标模板后**:
   - 读 `templates/<slug>/intro.md`(高度浓缩,告诉你这个模板的特性)
   - 读 `templates/<slug>/detail.json`(结构化数据,告诉你每页 / 每个文本位的细节)
   - 按 [模式 A 工作流](./references/workflow.md#mode-a) 选页、写 `edits.json`、跑 `build_pptx.py`

### 模式 B:用户自己带 PPT 模板

当用户提供了 .pptx 文件且明确希望以它作模板时:

1. 把用户的 pptx 当作"未知模板"
2. 用 `scripts/render_slides.py` 把每页渲染成 PNG,再用 `python-pptx` 现场探查每页的 shape / paragraph / run 结构(无需额外脚本)
3. 自己看每页(PNG + shape 输出):
   - 推断每页是什么角色(封面 / 目录 / 章节扉页 / 内容页 / 结束 / 模板宣传)
   - 推断每页适合放什么内容
   - 跳过模板宣传 / "稻壳儿" / 感谢下载 之类
4. 按 [模式 B 工作流](./references/custom-template-workflow.md) 用 explicit `address` 写 `edits.json` 选页 + 文字替换
5. **不要修改用户模板原文件**;所有改动写到新的 output.pptx

### 模式 C:完全原创(不基于任何模板)

当用户明确要求"原创设计 / 不用模板 / 简单干净的样式"时:

1. **创建尽量简洁的版式** —— 大量留白、对齐严格、装饰极少
2. 单页元素 ≤ 4 个,避免复杂图形 / 图标群组
3. 字体:英文 Arial / Helvetica;中文 微软雅黑 / 思源黑体;标题加粗即可
4. 主色 1 个 + 灰阶 + 白底;不要拼凑多种风格
5. 用 `python-pptx` 直接代码生成,参考 [`references/original-design-guide.md`](./references/original-design-guide.md)

## 编辑铁律(所有模式通用)

1. **不改排版** —— 只改文字。形状的位置、大小、颜色、字体、字号、行距,都不动。
2. **所有占位文字必须替换** —— 模板里的 "Question 1" / "Vivamus..." / "Key Words Here" / "项目名称" 等占位文本都必须用真实内容替换。一份完成的 PPT 里不应出现任何示例占位词。
3. **`max_chars` 是软性参考,不是硬性上限;严禁用省略号截断** —— detail.json 每个 slot 的 `max_chars` / `chars_per_line` / `max_lines` 是按文本框尺寸估算的容量,**仅供参考**,帮助你把握"这格大概能放多少字"。
   - 优先写**自然、完整、精炼**的文字。略微超出通常没关系(容量已留 20% 余量,PPT 文本框本身也有弹性)。
   - **绝对禁止为了凑数而砍掉后半句、在结尾加 `...` / `…` / `等等` 来硬凑长度** —— 被省略号截断的半句话,比轻微超框难看得多,是最差的结果。
   - 真的太长时,按优先级处理:① 用更精炼的措辞**重写**(真正的概括,不是切断);② 减少要点条数 / 换一个空间更大的版式或页面;③ 实在不行,**宁可让它轻微超出一点,也不要出现省略号**。
   - `build_pptx.py` 的出框检测**只是提示、不阻断**保存。**日常不要加 `--strict`**(它会因超框拒绝保存,从而诱导截断)。`capacity_unknown:true` 的槽测不准,凭目测把握。
4. **数字 / 序号默认不动** —— `editable: false` 的 slot 是装饰性 "01/02/1/2/%" 之类,除非用户明确要求改顺序,否则保持。
5. **图形 / 图表通常无法同步** —— 装饰性的进度条 / 圆环 / 旗帜路径 / 流程箭头是固定形状;改了百分比文字不会改弧长。每个模板 detail.json 里如有这类页面会在 `cautions` 字段列出。
6. **真实数据图表才能改数据** —— 如果某页有 PPT 原生 chart(`shape.has_chart=True`),可以用 `build_pptx.py --chart-data` 同步更新;详见 [`references/chart-editing.md`](./references/chart-editing.md)。
7. **章节名前后呼应** —— 改了目录章节名,对应的分章扉页 + 内容页面包屑文字都要同步改。
8. **封面 / 致谢页按模板能力来,不要硬造** ——
   - 读 `detail.json` 的 `page_roles`,如果 `cover` 数组为空,**直接从第一张内容页开始**,不要拿一张内容页当封面用,更不要从其他模板临时凑一张封面页。
   - 如果 `ending` 数组为空,**直接以最后一张内容页收尾**,不要硬造"感谢聆听"。
   - 同理,`agenda` 空 → 不强加目录;`section_divider` 空 → 不强加分章扉页。
   - 也就是说:**模板有什么角色就用什么角色**,少一个角色就少一页,不要破坏视觉一致性去拼凑。这条规则在 v1.0.3 起对所有模板生效。
9. **同级标题字号必须一致,不要逐处改字号** ——
   - detail.json 顶部有 `type_scale`(字号层级表,level 1 = 最大),每个 slot 标了 `level`。**同一 level 的文字保持模板原字号,不要改字号。**
   - 某处文字偏长时,用**更精炼的措辞重写**来控制长度(见第 3 条),**不要把这一处字号改小**(会破坏同级一致),**也不要截断加省略号**。
   - 选多页拼一份 PPT 时,让各页同 level 的标题用词长度相近,整体才齐整。

## 标准工作流(模式 A)

```bash
# 1. 从 templates/INDEX.md 选定一个模板,例如 minimal-business-summary
TEMPLATE=templates/minimal-business-summary

# 2. 读两个文件
#    - $TEMPLATE/intro.md     -> 模板风格 / 适用场景 / 结构概述
#    - $TEMPLATE/detail.json  -> 每页 / 每个文本位的详细描述

# 3. 自己决定要用哪些页(用 detail.json 的 page.role 和 use_for)
#    生成 edits.json:
#    {
#      "template_slug": "minimal-business-summary",
#      "selected_slides": [1, 2, 3, 5, 7, 9, 10, 12, 13, 14, 16],
#      "edits": [
#        {"slide": 1, "slot_id": "cover_title_cn", "new_text": "2026 年度复盘"},
#        ...
#      ]
#    }

# 4. 跑构建(不要加 --strict:出框检测只作提示,不应阻断;超框宁可轻微超出也别截断加省略号)
python3 scripts/build_pptx.py \
    $TEMPLATE/template.pptx \
    edits.json \
    out/final.pptx \
    --detail $TEMPLATE/detail.json

# 5. (可选)渲染最终 pptx 给用户预览 / 自检(每页一张 PNG)
python3 scripts/render_slides.py out/final.pptx out/renders --dpi 144
```

## 目录结构

```
GordenPPTSkill/
├── SKILL.md               ← 本文件
├── VERSION                ← 当前版本号
├── CHANGELOG.md           ← 人类可读变更日志
├── updates.json           ← 机器可读版本增量索引
├── manifest.json          ← 所有文件的 sha256 与版本归属
├── README.md              ← 仓库概览(用户阅读)
├── scripts/
│   ├── build_pptx.py          # 按 edits.json 选页 + 换字 → 输出 pptx(含出框检测)
│   ├── render_slides.py       # pptx → PDF → 每页 PNG(预览/自检)
│   ├── compute_capacity.py    # 由 template.pptx 计算每个 slot 的容量字段(数据准备)
│   ├── check_update.py        # 检查远端是否有更新
│   ├── apply_update.py        # 增量更新本地文件
│   └── build_manifest.py      # 重建 manifest.json
├── references/
│   ├── workflow.md
│   ├── pptx-edit-schema.md
│   ├── custom-template-workflow.md
│   ├── chart-editing.md
│   └── original-design-guide.md
└── templates/
    ├── INDEX.md
    └── <slug>/
        ├── template.pptx
        ├── intro.md       # 高度浓缩简介
        ├── detail.json    # 详细页面 / slot 数据(含容量字段 + type_scale)
        └── preview.png    # 4 页 2×2 拼接预览图
```

## 关键脚本一句话说明

| 脚本 | 干嘛用 |
|---|---|
| `build_pptx.py` | 按 `edits.json`(选页 + 文字替换)从模板生成最终 pptx;带出框检测,`--strict` 时出框拒绝保存 |
| `render_slides.py` | 把任意 pptx 渲染成每页一张 PNG(用 LibreOffice + pdftoppm),用于预览 / 自检 |
| `compute_capacity.py` | 由 template.pptx 算出每个 slot 的 `chars_per_line/max_lines/max_chars` 等容量字段(自带模板已算好,仅在加新模板时需要) |
| `check_update.py` | 对比本地 VERSION 和远端 updates.json,告诉你要不要更新 |
| `apply_update.py` | 按 updates.json 的 delta 列表只下载变动文件 |
| `build_manifest.py` | 重新计算 manifest.json |

## 字体说明

模板 XML 里大量使用 `微软雅黑`。如果运行环境没有该字体,配合 `~/.config/fontconfig/fonts.conf` 把它别名到本地已安装的字体(推荐顺序:WenQuanYi Micro Hei → DengXian → Noto Sans SC → PingFang SC)。预览图正是用这条 fallback 链渲染的。

最终交给用户的 .pptx 在 PowerPoint / WPS / Keynote 里打开时会自动用宿主机的字体渲染,因此不需要担心字体丢失问题。

## 一些常见误区

- **不要**只改文字不改章节名一致性 —— 改 agenda 必须同步改分章扉页
- **不要**在装饰图上加文字以为是真图表
- **不要**把 lorem ipsum 留在最终 PPT 里
- **不要**为了塞下文字而忽略 `max_chars`
- **不要**修改用户原始模板文件 —— 所有产出都到新文件
- **不要**用本 Skill 做商业项目 —— 见顶部声明

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

GitHub の情報

GitHub スター
4,154
提供元
GordenSun
ライセンス
ライセンス記載なし この repo にはライセンスの記載がありません。既定では作者が全権利を持つため、配布や商用利用の前に確認してください。
最終コード更新
2026年6月22日
repo 内の SKILL.md(翻訳版とテンプレートを含む)
1