# Retrospects · 复盘文件

每次任务收尾的 AI-用户协作复盘。两份文件配对：

| 后缀 | 用途 | 受众 |
|---|---|---|
| `*.md` | 长读版（完整 8 段格式） | UX team 内部精读 / handoff reference |
| `*.slides.md` | Marp 幻灯片源文件 | 转 PPTX / PDF / HTML 给同事 + 领导分享 |

## 默认 = 不导出

复盘写完只有 `.md` + `.slides.md` 源文件，不自动跑 dist/ 导出。理由：
- `.md` + gitea 浏览器渲染覆盖日常看复盘
- PPTX / HTML 是对外分享物料，按需出

## 触发导出

跟 AI 说 "导出幻灯片 / 分享 / 出 PPT"，AI 才跑 marp。

## 手动导出（一次装好 marp-cli 即可）

```bash
npm i -g @marp-team/marp-cli  # 一次性
marp docs/retrospects/<name>.slides.md --pptx -o docs/retrospects/dist/<name>.pptx
marp docs/retrospects/<name>.slides.md --html -o docs/retrospects/dist/<name>.html
```

`.marprc.yml`（仓库根目录）已配置 TVU 真源 tvu-dark 主题，无需 `--theme-set` 参数。

## 分享场景对应格式

| 格式 | 场景 |
|---|---|
| **`.md` 源**（默认有） | UX team 精读 / gitea 浏览器渲染 / 代码同事 |
| **PPTX**（按需出） | 投屏 / 周报嵌入 / 领导要改 |
| **HTML**（按需出） | 内网链接 / 本地预览深色科技风 |

**不出 PDF**：Marp PDF 走打印 CSS，渐变会失真。需要 PDF 附件用 Keynote / PowerPoint 打开 PPTX → 另存为 PDF。

## 写新复盘

1. 长读版：`YYYY-MM-DD-{feature}-retrospect.md`（按 [video-sync 那篇](./2026-05-20-video-sync-mockup-retrospect-internal-share.md) 8 段格式写）
2. 幻灯版：同名加 `.slides.md` 后缀。复用现有 Marp frontmatter（theme=gaia + TVU 绿 #2fb54e），按 15-20 张幻灯片重组核心内容（**不是 1:1 复制**长读版）
3. 导出 → 检查 → 分享