Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Budowanie i kod

ppt-effects

/ppt-effects

Przechowuje dopracowane efekty animacji do prezentacji jako przepisy z parametrami i wzorcami, by szybko stosować je do nowych materiałów.

Repozytorium
ppt-effects ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Przechowuje dopracowane efekty animacji do prezentacji jako przepisy z parametrami i wzorcami, by szybko stosować je do nowych materiałów.

Wyzwalacze z opisu

配方 + 参数 + 参考件使用效果x
Oryginalny opis (EN)

PPT 效果库。每个调好的动画效果(效果1、效果2……)都以"配方 + 参数 + 参考件"的形式 存档;当用户说"使用效果x"并给出新素材时,按库中模块套用,配合 ppt-master 现场生成, 不必重新理解一遍步骤。

Jak działa

  1. 何时使用
  2. 生成方式分流(要不要用 ppt-master)
  3. 新增效果的标准流程(做新效果时按这个走)
  4. 开工前先问张数(效果 11–14)
  5. 性能与读取纪律(避免"卡")
  6. 问询与预览(必答)
  7. 取用流程
  8. 入库规则
  9. 硬约束
Sekcje z nagłówków SKILL.md, w oryginale · 109 linii, 396 słów
Podgląd SKILL.md
---
name: ppt-effects
description: >
  PPT 效果库。每个调好的动画效果(效果1、效果2……)都以"配方 + 参数 + 参考件"的形式
  存档;当用户说"使用效果x"并给出新素材时,按库中模块套用,配合 ppt-master 现场生成,
  不必重新理解一遍步骤。
---

# PPT 效果库

这里保存的是**已经和用户调试通过、并且拿到"可存"指令**的 PPT 动画效果。每个效果是一个独立模块,编号即生成先后。

## 何时使用

- 用户说"使用效果1 / 效果2……",或"用之前那个效果做一份"。
- 用户要求复现某个已入库效果的动画、版式、切换。

## 生成方式分流(要不要用 ppt-master)

先看该效果 `spec.json` 的 `method_kind`:

| method_kind | 含义 | 怎么做 | 是否需要 ppt-master |
|---|---|---|---|
| `template-clone` | 效果11–15 | 复制 `reference/*.pptx`,按 spec 换图/换色/改字 | **不需要**(参考件即成品) |
| `from-scratch` | 效果1–10 | 库里只有参数与配方,页面要重新生成 | **需要**:`pptx_to_svg.py --roundtrip` → 改 SVG/媒体 → `svg_to_pptx.py --roundtrip` |

一句话:**能"复制参考件"就不需要;要"从参数生成"就需要。**

## 新增效果的标准流程(做新效果时按这个走)

1. **取参考**:用户给视频/ppt/描述 → 先用 ppt-master 的 `pptx_to_svg.py --roundtrip` 导入分析,或抽视频帧读参数
2. **建模块**:`effects/0NN_<中文名>/`,四个子目录/文件:
   - `reference/` 基准件 pptx(用户手改版优先)
   - `spec.json` 参数(画布/图层/坐标/动画/规则)
   - `recipe.md` 结构 + 做法 + 坑
   - `preview/` 至少 1 张预览
3. **登记**:`index.md` 加一行;`spec.json` 写 `method_kind`
4. **写经验**:把这次踩的坑写进 `recipe.md`(不写就白做)
5. **同步公开版**:在 `ppt-effects-public/tools/sync_from_internal.py` 的 `SLUGS` 里登记英文名,跑一次脚本
6. **提交**:内库 `git commit`,公开库也 `git commit`

判据:用户说"可以/满意/入库"才算完成,没确认前只放工作区。

## 开工前先问张数(效果 11–14)

这几个效果的**页数与配对方式由图片张数决定**,不问清就没法排:

| 效果 | 可选张数 | 张数决定什么 |
|---|---|---|
| 11 中式滑转 | 2–9 张 | N 张 → N+1 页,每页一块竖版面板 |
| 12 六边形旋转 | 1–4 张 | 1 张可复用满 6 页;4 张则每页不同 |
| 13 模糊遮罩 | 1–5 张 | 1 张 = 5 页共用;N 张 = 每页一张 |
| 14 立体图片轮播 | 3–10 张 | N 张 → N+1 页,标签数随之变化 |

做法:

1. **用户一次给了 N 张图时,先确认“这 N 张是全用,还是只用其中几张”**,再报页数;
2. 张数不足下限(如 11 少于 2 张、14 少于 3 张)先说明做不成,别硬套;
3. 超过上限就提示会多出内容或需要分册;
4. 效果 15 只有 1 张,不用问。

spec.json 里 materials.ask_count = true 就是给这种效果的标记。

## 性能与读取纪律(避免"卡")

按需读,不要一次全读:

1. **先 `index.md`** → 确定效果 → **只读该效果的 `recipe.md`**;需要精确数值时再读它的 `spec.json`。不要一次读 10 个 recipe/spec。
2. **跑检查器用 `--brief`**:`check_materials.py 效果N 图.jpg --brief` → 只返回一行(PASS/WARN/BLOCK + 首条问题)。需要完整报告时再去掉该参数。
3. **预览图一次只给一张**,用 `docs/preview/*.jpg`(已压到 ~50 KB)。不要为回答"效果N 是啥"去现截图——PowerPoint COM 打开+导出每次 2–5 秒。
4. **不要批量导出页面 PNG**,除非用户明确要求逐页预览。
5. 参考件体积差异大(效果2-骑行 9.7 MB / 效果9 4.9 MB),只是回答问题时不要打开这些 pptx。

## 问询与预览(必答)

用户问"**效果N 是啥**""**给个预览**""**这些效果有什么区别**"时,**必须答复,不能只说"我看看"**。回答材料都在库里,不需要现做:

1. **一句话说明**:读 `spec.json` 的 `summary`(10 个效果都有);没写就用自己的话概括"几页 + 动什么 + 适合什么素材"。
2. **配图**:`spec.json` 的 `preview` 字段指向 `docs/preview/效果N_*.png`,直接引用该路径即可(图是中性素材渲染的,可公开)。
3. **素材门槛**:顺带说清 `materials` 里最关键的两条——要几张图、有什么硬条件(深色/白底/画幅)。

**使用前给总览**:用户没说具体是哪个效果时,先给一张表(10 行:代号 / 一句话 / 需要几张图),再问要哪个;不要直接开始做。

> 问"效果N 是啥"只答不问别的;不要因为没看到图就回避,预览图在库里。

## 取用流程

1. 读 `index.md`,按代号(效果x)找到目录。
2. 读该效果的 `recipe.md`(人读的意图与坑)和 `spec.json`(机器读的精确参数)。
3. **先校验素材,再动手**——不要凭眼睛看:
   ```bash
   python tools/check_materials.py 效果9 ./素材文件夹/          # 数量/画幅/方向/明暗
   python tools/check_materials.py 效果2 --variant long a.jpg b.jpg
   python tools/check_materials.py --list                      # 全部效果的素材要求
   ```
   要求写在各模块 `spec.json` 的 `materials` 段里(`min`/`max`/`aspects`/`deficit`/`checks`)。退出码 1 = 阻断,不许硬套;退出码 0 但带 `[!]` = 可以先做,但那几条必须先跟用户说。文字长度不在自动检查范围内,仍要自己对槽位。
4. 以 `svg/` 里的模板为骨架,替换素材与文案,生成新项目的 `svg_output/`。
5. 跑 ppt-master 的检查与导出(命令见 recipe.md 的"制作管线")。
6. 运行 `tools/patch_effect.py --in 导出.pptx --spec <效果>/spec.json --out 定稿.pptx --text <可选新文案>` 做精确校正。
7. 渲染核对,呈现给用户;得到"可存"后才写入用户指定目录。

## 入库规则

- 只有用户说"可存"之后才建模块;调试中的版本不入库。
- 目录命名:`effects/<三位序号>_<短名>/`,`spec.json` 里的 `id` 记录用户使用的代号(效果1)。
- 每个模块必须包含:`recipe.md`、`spec.json`、`animations.json`、`svg/`、`reference/`(定稿 pptx)、`preview/`(关键帧)。
- 新效果追加到 `index.md` 末尾,保持创建顺序。

## 硬约束

- 效果库本身不含用户照片;素材随每次任务传入。
- **文本框先问**:数量、文案、字体、字号必须逐项向用户确认;库里的字体字号只能作为"建议默认",不得直接套用。
- 位置、时长、阴影、切换一律从 `spec.json` 读,不要凭记忆重写。
- 若新素材导致比例严重不符,先与用户确认是裁切还是拉伸,再动手。
- **字体优先用开源可商用字体**:霞鹜文楷、思源黑体/宋体、HarmonyOS Sans、MiSans、EB Garamond。商业字库(华文、方正、汉仪等)只有个人非商用授权,对外发布或商用须自行取得许可;库内 spec.json 的 onts.recommended_free 列了每个模块的替代方案。
Pliki w paczce (7)
  • .gitattributes 1 KB
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.md 6 KB
  • RELEASE-NOTES.md 3 KB
  • SKILL.md 7 KB
  • index.md 5 KB

Wersje

W bazie nie ma innych skilli o nazwie ppt-effects.

Migawka bazy z 13.11.2026 · wersja paczki 2f362083af16 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100ppt-skill
    Generuje szablony prezentacji, pełne zestawy slajdów z pomysłu lub konspektu oraz eksporty do PDF i prezentacji obrazkowej.
  • 100career-ppt-cloner
    Odtwarza wygląd prezentacji z konkursów o karierze i Challenge Cup, wstawiając własne treści w zachowany układ.
  • 100sn-ppt-story
    Układa zapytanie, materiały użytkownika i gotowy research w jeden edytowalny plik outline.md prezentacji, po przygotowaniu DECK_DIR przez sn-ppt-entry.
  • 90proposal-ppt-quality
    Tworzy i poprawia edytowalne prezentacje PPT do ofert i propozycji biznesowych, zachowując treść i sprawdzając każdą stronę po eksporcie.
  • 100scene-ppt
    Przerabia artykuł lub temat na prezentację PPT w formie obrazów, po jednym obrazie na stronę 16:9.
  • 95article-to-ppt
    Zamienia długi tekst lub materiał szkoleniowy w konspekt PPT z sugestiami układu i skryptem wypowiedzi prowadzącego.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.