deck-beamer-proposal-report

Beamer 提案 / 报告演示文稿

生成可直接编译的 Beamer 源码，用于提案（说明你打算做什么，以及为什么值得资助 / 批准）和报告（对照承诺说明你做了什么）。这两类文稿都围绕工作计划组织，而非单一贡献——需要目标、工作包、时间线、里程碑、交付成果、预算和风险；报告还要补充进度与计划的对照。

这是渲染步骤。幻灯片规范的架构和与格式无关的设计规则位于 references/slide-spec-and-design.md——请先阅读。它不是 deck-beamer-academic（单篇论文成果报告），也不是 deck-business-report（面向高管的 PPTX/Canva）。

---

两类文稿，不同主线

提案演示文稿

受众：委员会 / 资助方 / 顾问，他们要决定是否批准或资助。评估内容包括重要性、可行性以及计划的可信度。

主线：

1. 问题与重要性——为什么这件事很重要，为什么是现在。
2. 缺口 / 研究现状——还有哪些问题未解决；你将做出哪些他人尚未做到的工作。
3. 目标 / 研究问题——2–4 个明确且可检验的目标。
4. 方法 / 研究方法——针对每个目标，说明将如何着手。
5. 初步结果——证明你有能力完成这项工作（降低资助请求的风险）。
6. 工作计划与时间线——将工作包映射到甘特图。
7. 里程碑与交付成果——具体、有日期且可验证。
8. 风险与缓解措施——指出真实风险，表明你已提前考虑。
9. 预算 / 资源（如适用）——需要什么，以及原因。
10. 预期影响与总结——成功后能带来什么。

报告演示文稿（进展 / 里程碑 / 最终）

受众：同一批相关方，现在他们要检查实际交付是否符合承诺。

主线：

1. 回顾目标——承诺过什么（一张幻灯片）。
2. 进度与计划对照——按目标 / 工作包标注状态（按计划进行 / 有风险 / 已完成）。
3. 迄今为止的关键结果——展示证据，标题直接陈述结论。
4. 已完成 / 未完成的里程碑——如实呈现状态表。
5. 偏差及原因——计划有哪些变更，以及变更的理由。
6. 风险（更新）——哪些风险已发生，有哪些新风险。
7. 剩余工作与修订后的时间线——还剩什么工作，何时完成。
8. 预算 / 资源状态（如适用）——实际支出与计划的对照。
9. 总结与请求——下一步需要什么决策或支持。

---

工作流

1. 收集输入

• 文稿类型（提案 / 进展 / 中期 / 最终）。
• 已确定的计划：目标、工作包、原始时间线、里程碑、交付成果、预算。
• 对于报告：每个事项的当前状态，哪些事项延期以及原因。
• 受众和演讲时长；如有强制要求，还需提供机构 / 资助方的 Beamer 模板。

2. 构建幻灯片规范

以上述相应主线为骨架，然后为每张幻灯片编写规范块（references/slide-spec-and-design.md）。提案演示文稿的说服性表达技巧——如何将内容包装成推介而非信息倾倒、沙漏结构、三种提案图示原型（蝴蝶 / 家族肖像 / 前后对比），以及密度控制——请参阅 references/proposal-persuasion-craft.md（基于 Knapen et al., 2025，arXiv:2504.01645）。针对不同文稿类型的指导：

• 目标采用以结果为导向的结论式标题，而非主题式标题。
• 时间线 → 使用一张甘特图幻灯片（TikZ pgfgantt），不要堆砌日期。
• 里程碑 / 交付成果 → 使用紧凑的状态表（booktabs），可见行数 ≤ 6；超出部分放入备用幻灯片。
• 风险 → 使用 2 列的“风险 → 缓解措施”（或可能性 / 影响）表格，仅列出主要风险。
• 进度（报告） → 使用带有清晰图例的状态表（✓ 已完成 / ◐ 按计划进行 / ✗ 有风险），用颜色区分，但绝不能只依赖颜色。
• 预算 → 汇总各类别；完整明细放入备用幻灯片。

输出 LaTeX 前，请先确认规范。

3. 输出可直接编译的 .tex

使用 assets/preamble.tex 渲染已批准的规范（在学术论文导言区的基础上添加 pgfgantt、状态宏以及风险/里程碑表格样式）。要求：

• 文件独立完整，可使用 pdflatex/lualatex 编译；占位符须明确标记为 % TODO。
• 甘特图使用 pgfgantt 构建；里程碑/交付物/风险表格使用 booktabs。
• 状态宏（\done、\ontrack、\atrisk）将符号与颜色配对（适合色觉障碍者）。
• 通过 \note{} 添加演讲者备注；较长的评审中，使用 \tableofcontents[currentsection] 回顾章节内容。
• 添加备用幻灯片附录，包含详细预算、完整里程碑列表和方法深度内容。

4. 交付

提供编译命令、需要放入的文件、修改日期/数字的位置，以及附录中的详细幻灯片。

随 .tex 一同提供 scripts/compile.sh，以便一步完成构建（如果存在 latexmk，则使用它；否则运行两遍 pdflatex；必须安装 pgfgantt）：

./scripts/compile.sh proposal.tex        # build
./scripts/compile.sh -c proposal.tex     # build, then clean aux files

---

优秀的提案/报告演示文稿与论文报告的区别

• 计划就是成果。 含糊的时间表或模糊的里程碑，比薄弱的结果更容易让提案失败。确保每个里程碑都有日期且可验证。
• 在这里，可行性胜过新颖性。 初步结果旨在证明你有能力执行，而不是构成完整的贡献。
• 报告必须如实说明进度延误。 隐瞒“有风险”事项的状态表会破坏信任；应展示这些事项以及相应的缓解措施。
• 数字必须经得起核查。 预算、时间表和里程碑日期都会受到审查——确保它们在各张幻灯片中保持一致。

---

应避免的反模式

• 将目标写成主题（“研究 X”），而非带有成功标准、可检验的目标。
• 时间线幻灯片只罗列一段日期，而不使用甘特图。
• 把未达成的里程碑藏起来，或省略进度与计划的对比视图。
• 将完整的预算/工作包细节塞进主幻灯片，而不是放入备用幻灯片。

---

输出

1. 已确认的幻灯片规范（Markdown），基于提案或报告主线构建。
2. 单个可直接编译的 .tex 文件（附带导言区），包含甘特图、状态表格和明确标记的占位符。
3. 编译、编辑和附录说明。