프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

GordenPPTSkill Skill

저장소 ↗

제작자: GordenSun★ 4,154skill 1개

설치

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만/주★ 5.4천그저께 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Desktop Commander

MCP server for terminal commands, file operations, and process management

제작자: wonderwhy-er널리 사용됨↓ 74만/주★ 1만어제 업데이트

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의 Skill(지시 묶음) 1개, 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 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 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

웹과 모바일의 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