可重复报告
Reproducible report
学到 会用 就够:能亲手用起来
你可能会说
“我的数据更新后,要重新复制图表和正文数字,怎样减少手工改漏的地方?”
可重复报告把分析步骤、图表和文字放在能按规则重新生成的工作流程里,使同一份输入和相应环境能再次生成报告中的结果。
使用 AI
科研里的例子
假设经济学课程作业更新了县级样本,报告中的有效样本数、描述表和趋势图随重新运行一并更新,作者再核对新增记录是否符合原规则。
先让数据处理与分析步骤有清楚的执行顺序,再把需要展示的表格、图形和正文数字连接到实际计算结果。每次更新数据后重新运行,能够减少手工复制和改数字的遗漏。实现时需要记录输入版本、软件和依赖、运行入口,以及输出文件的位置;遇到随机步骤时还要说明相应设置。某些报告工具可以把代码与说明写在同一文件,也可以由脚本先生成图表再组织成文。无论采取哪种形式,都应测试从干净环境能否重新得到关键结果,并确认没有偷偷沿用旧缓存或未记录的人工修改。
在你的学科里,直接拿去用
把数据分析要求写成可复现说明
请先为这项分析形成可复现的任务说明,再建议代码。 问题:[填写] 数据字典及已有规则:[提供] 可用软件与现有代码:[提供] 明确一行数据代表什么、样本范围、连接键、单位、缺失码、变量构造、估计对象和输出。区分描述分析与因果分析;缺少识别依据时不要把回归系数直接称为因果影响。给出小样本核对、异常记录和可重跑顺序。保留原始数据,所有转换写到派生结果并留记录;不能为得到显著结果修改数据或筛选规则。方括号里的内容换成你自己的。来自知识增量《科研中英表达与 Prompt 指南》PG08
查错并交付能核验的修复
请定位问题并给最小修复。 代码与环境:[粘贴] 输入样例:[不含私密信息的小样本] 实际错误或输出:[粘贴] 我期望:[填写] 先区分已观察事实与可能原因,优先用最小样例验证。解释根因,给最小差异和有意义的检查。没有实际运行权限时明确标为未运行建议,不把推测写成测试通过。若修改会影响研究规则或结果,指出具体影响,不顺手重构无关部分。方括号里的内容换成你自己的。来自知识增量《科研中英表达与 Prompt 指南》PG09
判断
亲手检查一次
复制一份运行说明,在不依赖当前软件会话的情况下重新生成一张关键表,核对数字和输入版本。
它做不到的
能够重复生成错误结果,也仍然是错误结果。可重复报告不保证研究设计成立,也不表示他人自动拥有受限数据的使用权限。
增量,由你来写
读完这张,你的理解变了什么?
留言功能会在后面的版本开放。现在可以先在 X 上 @knowledgedelta 告诉我。
来源
- Wickham、Çetinkaya-Rundel、Grolemund — R for Data Science (2e): Quarto2026-11-07 核对
- American Economic Association — Data and Code Availability Policy2026-11-07 核对
- Stata — [U] 16 Do-files2026-11-08 核对
卡片底稿由 AI 协助整理,经过核对;发现错误请告诉我。