# Slides

用户要做幻灯片、演示文稿、讲稿或汇报用的页面时用：在工作目录里写一份 deck（deck.json 加每页一个 HTML...

- Repository: https://github.com/JimLiu/baocut (1645 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add JimLiu/baocut --skill slides -g -a claude-code -y`
Codex: `npx skills add JimLiu/baocut --skill slides -g -a codex -y`
Cursor: `npx skills add JimLiu/baocut --skill slides -g -a cursor -y`
Gemini CLI: `npx skills add JimLiu/baocut --skill slides -g -a gemini-cli -y`

## Description

用户要做幻灯片、演示文稿、讲稿或汇报用的页面时用：在工作目录里写一份 deck（deck.json 加每页一个 HTML 文件），校验通过后线程里出现幻灯片卡片，用户在功能区预览、编辑与标注。可以套用工作目录里的设计系统；需要插图时可以用图片生成模型画好放进页面。也用于按用户的意见或标注改已有的幻灯片。视频画面里的字卡、下横栏与动效不用它（用动效图形）。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 幻灯片

一份幻灯片是工作目录里的一个目录：一个索引文件 `deck.json`，加上每页一个 HTML 文件。你用自己的文件工具直接写这些文件，BaoCut 的幻灯片编辑器读的就是它们。在 BaoCut 的会话里，校验通过后线程里出现幻灯片卡片；用户点「打开」，在功能区预览、改字、拖动元素，也可以圈出某处写下意见发回给你。

你的一轮工作是：**定内容与外观 → 写文件 → 校验到没有问题 → 告诉用户**。

## 1. 目录里有什么

```text
<deck 目录>/
  deck.json          索引：标题、页的顺序、分节、封面、字体、设计系统
  slides/<id>.html   每页一个文件
  assets/            导入的图片与字体（不要手写）
  ds/<folder>/       装进来的设计系统的副本（可选；见 references/design-system.md）
  images/            生成插图时存下的原图（可选；页面只引用导入后的地址）
```

- deck 目录放在工作目录里，按标题起一个简短的名字（例如 `q3-review/`），不以点开头。一个会话里做第二份就另起一个目录，不覆盖已有的。
- 页的 `id` 只用字母、数字、`-` 与 `_`，最长 64 个字符；文件名就是 `<id>.html`，文件里那个 `<section>` 的 `id` 与它相同。按内容起 id（`cover`、`agenda`、`pricing`），不用 `1`、`2` 这种会随插页变乱的编号。
- 新建的 `deck.json`：

```json
{
  "v": 4,
  "lists": "css",
  "title": "第三季度回顾",
  "order": ["cover", "agenda", "growth", "next"],
  "cover": "cover",
  "sections": {
    "intro": { "description": "这一季做成了什么", "start": "cover" },
    "plan": { "description": "下一季的三件事", "start": "next" }
  },
  "faces": {
    "source-sans-3": {
      "family": "Source Sans 3",
      "href": "https://fonts.googleapis.com/css2?family=Source+Sans+3:wght@400;600;700&display=swap"
    }
  },
  "designSystems": []
}
```

  `order` 决定页的先后；`sections` 是提纲，每节一句话、从哪一页开始；`faces` 登记页面里用到的网络字体与导入的字体文件（规则见 `references/format.md` 的「字体」）；`designSystems` 记录装进来的设计系统，没有就是空数组。已有的 `deck.json` 只改你要改的键，其余原样保留；`lists` 只在新建时写。

## 2. 新做一份

The rest: https://github.com/JimLiu/baocut/blob/HEAD/skills/baocut/built-in-skills/slides/SKILL.md