Scientific Reporting（科研/技术报告）

你遇到的痛点（为什么需要这个 skill）

很多“报告写作失败”不是写不出来，而是：

• 路由误入

  docs-media

  （被 PDF/Word 关键词抢走）
• 报告没有结构（缺少 Executive Summary / 方法可复现 / 结果可追溯）
• 图表不达标（截图、低 DPI、字体不一致、颜色不友好）

这个 skill 的职责是：把报告当成可交付工程，并把图表与叙事纳入同一规范。

---

适用场景（关键词）

• 中文：

  科研报告

  、

  技术报告

  、

  项目报告

  、

  实验报告

  、

  分析报告

  、

  HTML 报告

  、

  PDF 报告

• 英文：

  technical report

  、

  research report

  、

  HTML report

  、

  Quarto

  、

  RMarkdown

不适用：

• 仅“抽取 PDF 文本/解析 docx” →

  docs-media/pdf/docx/markitdown

---

输入（最小信息）

1. 受众：老板/评审/客户/组会同学（决定写作风格与解释深度）
2. 目的：决策/复现/汇报/归档（决定是否必须包含 appendix）
3. 输出格式：

   Markdown

   /

   HTML

   /

   PDF

   （可多选）
4. 数据与图：是否已有数据、已有图、或需要从数据生成图

---

输出（默认目录）

推荐输出为（可按项目名建子目录）：

• reports/<topic>/report.md

  （source-of-truth）

• reports/<topic>/report.html

  （可选）

• reports/<topic>/report.pdf

  （可选）

• reports/<topic>/figures/

  （报告引用的图，来源于

  figures/**/out

  ）

• reports/<topic>/appendix/

  （方法、参数、环境、额外图表）

模板：

templates/report-skeleton.md

---

工作流（强制顺序）

Phase 1 — 结构先行（先搭骨架）

报告必须包含（即使简写）：

1. Executive Summary（结论先行）
2. Context（问题与约束）
3. Methods（可复现：数据/流程/参数）
4. Results（以图为骨架）
5. Discussion（解释意义、局限、建议）
6. Appendix（可选但推荐：环境/补充图/表）

Phase 2 — 结果以图为锚

• 图表走

  scientific-visualization

  （publication-quality）
• 示意图走

  scientific-schematics

  （流程/机制/系统图）
• 文本解释走

  scientific-writing

  （段落化、避免 bullet 作为最终稿）

Phase 3 — 导出策略（HTML/PDF）

如果要 HTML：

• 优先：Markdown + 静态图（PDF/SVG/PNG）
• 需要交互：Plotly 输出 HTML（并提供静态 fallback）

如果要 PDF：

• 重点：图字体与线宽在最终版面可读
• 禁止：把网页截图当 PDF

---

质量门禁（报告交付前）

• “结论先行”：读 Executive Summary 就能知道要点与建议
• “可复现”：Methods + Appendix 足以复现关键结果
• “图可用”：统一字体、色盲友好、导出格式正确
• “可追溯”：每个结论能指向某张图/某个表/某段计算