plan-decklisted
Install: claude install-skill shio-vinyl/plan-deck
# 规划汇报 PPT
本 skill 的目录即 plan-deck 仓库,下文记为 `$R`。本文写工作流、要点和入口;规则全文和正反例在 `$R/docs/`,用到时读。
规划汇报和一般 PPT 不同:听众是逐页核对的审查者,单页三四百字是常态,目标是“密而不乱”;结构是分级标题的树,不是故事线;地图是证据,数字要对得上,正当性来自上位依据;它是多人改的过程文件,pptx 是唯一真身。
| 要做的事 | 读 |
|---|---|
| 写页面:版式、框和图示、每页三层、标题、标红、用词 | `$R/docs/visual-language.md` |
| 放大的重点用哪种做法:标签行、栏头并列、通栏、节点链、泳道、文件摘录、矩阵表、台阶 | `$R/docs/patterns.md` |
| 给一页选页型 | `$R/docs/page-types.md` |
| 页面里要放地图 | `$R/docs/map-types.md`,再按 gis-composer 的 skill 出图 |
| `style.json`、大纲格式、组件和命令 | `$R/docs/architecture.md` |
| 用户说定稿,要出去 AI 味版 | `$R/docs/humanize.md` |
| 想改已定的做法,或想知道某条规则的来由 | `$R/docs/design-principles.md` |
## 和通用演示文稿 skill 的关系
宿主可能同时装了通用的演示文稿 skill(如 Codex 的 Presentations)。规划汇报按本 skill 做;项目的 `style.json` 就是用户给的样式说明,通用 skill 里“没有样式说明时”的默认规则不适用。下面这些通用做法和本 skill 冲突,不照做:
- 用 Spaces、artifact-tool 之类的在线工具出稿,或把 pptx 导进去改完写回原路径。本 skill 用 `$R` 的 python-pptx 运行时,原件只读、另存版本。
- 正文至少 17 磅、一页一个观点、能删就删。规划汇报每页三四百字,正文 12—14 磅(按页高换算),不减内容。
- 不用程序画的形状、改用生成图片。规划汇报的图示(节点、箭头、泳道、表)必须是可编辑的形状,证据图从项目材料里取,不用生成图冒充。
- 禁用破折号、分号、圆点这类标点,不加章节标签。规划文本照常用这些标点;用通栏页眉预设时章名行是页眉的一部分。
- 起稿先弹模板选择器。视觉系统按本 skill 第 1 步定。
## 项目目录
开始前先确定项目目录:用户指定的目录;没指定就问。不要放进 `$R`,也不要散落在当前目录。
新起稿时按这个结构建:
```
<项目目录>/
deck.pptx 汇报稿(文件名按项目定)
deck.outline.md 结构大纲,与 pptx 同名
style.json 视觉系统的数值(运行时读它)
style.md 视觉系统的说明:汇报对象、用途,版式和字号的取舍
assets/ 图片、截图、地图(地图由 gis-composer 产出后放这里)
scripts/ 生成和修改用的临时脚本
renders/ 渲染检查用的 pdf 和图片,可随时删
```
接手已有项目时,项目目录就是汇报稿所在的目录,顺着它原有的结构放,不另建一套、