Scientific Reporting

# 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 足以复现关键结果
- [ ] “图可用”：统一字体、色盲友好、导出格式正确
- [ ] “可追溯”：每个结论能指向某张图/某个表/某段计算