关于 reproducibility-audit
用于检查研究结果能否依据现有材料和步骤复现的技能。它记录阻碍并判定复现状态,只有实际运行并核验后才标记为已复现。
主要功能
- 01检查代码、数据、配置与版本
- 02将论文主张对应到可执行步骤
- 03记录歧义与阻碍
- 04记录命令和输出
- 05判定复现状态并提出修复
适用场景
- 01在依赖论文结果前评估其可复现性
- 02找出复现尝试缺失的材料
- 03记录复现过程中的证据与阻碍
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jurgendn/ agent-skills --skill reproducibility-audit安装后在 Claude Code 中输入/reproducibility-audit确认已加载。
附带文件references/good-enough-baseline.md
详细介绍
可复现性审计
除非已列出所有缺失项,否则一律假定结果不可复现。
工作流
-
确定要复现的目标结果。
-
检查是否具备所需条件:
- 代码
- commit/版本固定信息
- 数据访问权限
- 配置文件
- 预处理步骤
- 硬件假设
- 随机种子处理
references/good-enough-baseline.md将这些内容扩展为一份具体的存在/缺失核对清单(涵盖数据来源、依赖项固定、冒烟测试、版本标识和确定性),并以 Good Enough Practices in Scientific Computing(Wilson 等人,2017 年)为依据——其中缺少任何一项都应作为问题记录,而非小小的不便。 -
尝试将论文中的主张对应到可执行步骤。
-
明确记录歧义和阻碍因素。
-
如果运行代码,记录确切的命令和输出。
-
对状态进行分类:
- 已复现
- 部分复现
- 受阻
- 与论文不一致
-
推荐为实现可复现性所需的最小修改。
规则
- 除非你实际运行并检查过,否则不要声称结果已复现。
- 配置细节缺失应作为问题记录,而非小小的不便。
- 将代码是否可用与结果是否可复现分开说明。
输出格式
返回:
- 目标结果
- 可用产物
- 缺失产物
- 复现状态
- 命令/证据
- 建议的修复
评论
支持 Markdown