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 就能知道要...