Research Repo Reproduction 是一个面向学术研究代码仓库的复现与审计技能,主要用于对研究代码进行忠实、可记录的运行或检查。其核心定位是:复现并不等于为了让结果好看而修改任何东西,而是对研究产物进行一次有据可查的复现尝试。
用途 该技能适用于检查、清理、理解、复现或审计学术研究代码仓库,尤其是当 README 中的命令、数据集等信息需要核对时使用。它帮助使用者系统地梳理仓库的运行流程,区分可信复现与探索性改动。
主要能力
- 阅读 README、配置文件、环境文件、脚本与文档,建立对仓库的整体认识。
- 清点文档中记录的命令,形成命令清单。
- 识别最小可信目标:冒烟测试、推理、评估或训练启动。
- 记录关于数据、权重、环境与硬件的假设。
- 仅运行有文档依据或理由充分的命令。
- 若必须打补丁,将补丁说明与科学贡献声明隔离。
- 在 repro_outputs/ 下写入标准化证据。
- 针对质量不佳的学术仓库,优先处理包结构、清晰的 CLI/脚本、配置、环境锁定或安装文档、结构不变量的测试、可复现命令、数据来源、论文/提案放置、wiki/来源摘要等清理事项。
使用方式 执行可信复现流程:首先阅读 README、配置、环境文件、脚本和文档;其次清点文档中记录的命令;然后确定最小可信目标(冒烟测试、推理、评估或训练启动);记录关于数据、权重、环境与硬件的假设;仅运行有文档依据或理由充分的命令;如果必须打补丁,将补丁说明与科学贡献声明隔离;最后在 repro_outputs/ 下写入标准化证据。输出文件包括 repro_outputs/SUMMARY.md、repro_outputs/COMMANDS.md、repro_outputs/LOG.md、repro_outputs/PATCHES.md、repro_outputs/status.json。
适用场景
- 需要检查或理解学术研究代码仓库时。
- 需要清理学术仓库结构、提升可复现性时。
- 需要复现论文中的实验或运行评估时。
- 需要审计研究代码仓库的可信度时。
- 当 README 命令、数据集、权重或环境信息需要核对时。
限制与边界
- 不得静默更改数据集、划分、指标、检查点或评估代码。
- 不得在未明确说明转变的情况下,把失败的复现转化为探索性重构。
- 不得仅凭冒烟测试宣称 SOTA 或正确性。
- 必须将可信复现与 explore_outputs/ 分开。
- 该技能强调忠实复现,反对为让结果好看而修改代码。
其他信息 该技能的官方文本、具体安装方式、收费与价格信息暂未提供。