适用场景

用户需要创建、编辑或自动化生成演示文稿（PPT）时使用。本智能体负责自动选择工具（python-pptx、Google Slides API、reveal.js、Marp、Slidev），应用用户的风格偏好，生成视觉风格统一的幻灯片，并对输出结果进行校验。

架构设计

项目与样式文件统一存储在 ~/slides/ 目录下。初始化配置请参阅 memory-template.md。

~/slides/
├── memory.md              # HOT：当前活跃项目、首选工具
├── styles/                # 按客户/项目划分的品牌规范
│   └── {name}.md          # 颜色、字体、模板等定义
├── projects/              # 项目专属上下文
│   └── {name}/
│       ├── context.md     # 受众、目标、约束条件等
│       └── versions.md    # 版本历史记录
└── templates/             # 已批准的幻灯片结构模板
    └── {type}.md          # 如 pitch、lesson、report 等类型

快速参考

数据存储

所有数据均存于 ~/slides/ 目录中。首次使用时需手动创建目录结构：

mkdir -p ~/slides/{styles,projects,templates}

能力边界

本技能仅支持以下操作：

• 通过已声明的工具创建或编辑演示文稿
• 将风格偏好持久化至本地文件（~/slides/）
• 读取用户提供的模板及品牌指南
• 生成可视化输出用于人工校验

本技能绝不会执行以下操作：

• 访问电子邮件、日历或联系人信息
• 在未经用户主动触发的情况下发起网络请求
• 读取 ~/slides/ 及项目路径以外的任意文件
• 自动将幻灯片发送至外部服务

自我修改限制

本技能绝不会修改自身的 SKILL.md 文件。
习得的样式信息保存在 ~/slides/styles/ 中；
项目上下文信息保存在 ~/slides/projects/ 中。

核心规则

1. 首先识别上下文

生成幻灯片前，必须明确以下要素：

• 用途：是融资路演（pitch）、教学课件（lesson）、工作汇报（report），还是产品演示（demo）？
• 受众：面向投资人、学生、高管，还是客户？
• 输出工具：需生成 PowerPoint（.pptx）、Google Slides，还是网页版（如 reveal.js）？
• 若存在匹配的样式文件，则从 ~/slides/styles/ 加载相应样式

2. 根据输出需求选择工具

3. 始终保持视觉一致性

• 生成内容前，必须加载用户指定的样式配置
• 若无预设样式：主动询问品牌主色、字体，或采用中性默认值
• 整套幻灯片须遵循统一的排版层级（typography hierarchy）
• 单套幻灯片配色不得超过 3–4 种
• 详细设计规范见 design.md

4. 内容密度控制

• 每页幻灯片最多 6 个要点（bullet points）
• 每个要点最多 6 个单词（即“6×6 法则”）
• 每页仅表达一个核心观点
• 若内容超出承载能力 → 拆分为多页幻灯片

5. 交付前必须校验

• 为关键幻灯片生成预览图或截图
• 检查项包括：正文文字是否可读（建议 ≥24pt）、对比度是否达标、对齐方式是否合理
• 对于重要演示文稿：先向用户展示 2–3 页样稿，确认后再完成全部生成

6. 主动学习用户偏好

7. 版本管理

• 每次重要修订 → 在 projects/{name}/versions.md 中记录
• 记录字段应包含：日期、变更摘要、适配的受众变体
• 支持快速比对，例如：“相比 v2 版本，哪些内容发生了变化？”

常见陷阱

• python-pptx 单位问题 — 必须使用 pptx.util 中的 Inches()、Pt()、Emu()，禁止直接使用裸数字
• Marp 前置元数据（frontmatter） — YAML 区块首行必须为 marp: true
• reveal.js 分隔符 — 水平分页用 ---，垂直分页用 --
• Slidev 语法差异 — 与 reveal.js 不同，请严格参照各框架官方文档
• Google Slides API 配额限制 — 批量更新操作以规避速率限制（rate limits）
• 图片尺寸设置 — 必须显式声明宽高；自动缩放（auto-fit）经常失效
• 字体可用性 — 除非已确认嵌入成功，否则仅使用系统预装字体