env-and-assets-bootstrap:在跑代码之前先把环境和资产搞定
env-and-assets-bootstrap:在跑代码之前先把环境和资产搞定

做深度学习论文复现的时候,最让人烦躁的事情之一就是:你找到了一个看起来能跑的仓库,README 里写了训练命令、推理命令、评估命令,洋洋洒洒一大堆。但当你真正准备动手的时候,卡住了——conda 环境怎么配?数据集往哪放?预训练权重去哪下载?这些 README 里要么没写,要么写得很含糊,你得自己猜、自己试、自己折腾。

env-and-assets-bootstrap 就是为这个场景设计的。它是 lllllllama 开发的 RigorPilot Skills 套件中的一个子技能。截至 2026 年 8 月,这个技能在 Learn Skills 平台上的安装量已超过 13.9 万次

这个技能能做什么

env-and-assets-bootstrap 的核心任务很明确:在 README 优先的深度学习仓库复现流程中,准备好环境和资产,然后交给后续的执行技能

它不做仓库扫描、不做论文解读、不跑任何模型代码。它的全部工作就是在你跑任何命令之前,先把环境、数据集、检查点、缓存这些东西规划好、准备好

具体来说,它做以下几件事。

保守的环境规划:技能会读取目标仓库顶层目录中的环境配置文件——environment.ymlrequirements.txtpyproject.toml 等——然后生成一个保守的环境引导方案。默认采用 conda-first 策略,优先使用 conda 创建隔离环境。方案中会包含清晰的激活步骤,告诉你环境建好之后怎么激活、怎么验证。

资产路径规划:技能会检查仓库对数据集、检查点、缓存目录的依赖情况,生成一份资产清单和路径提示。数据集应该放在哪里?预训练权重应该下载到哪个目录?缓存目录有没有默认位置?这些问题会被提前梳理清楚,而不是等你跑到一半发现文件找不到再回头排查。

策略引用与合规:技能集成了 env-policy.mdassets-policy.md 两份策略文档,确保环境和资产的准备过程遵循保守、可复现的原则。下载资产时优先选择官方源、避免使用非标准路径、记录所有假设——这些策略会被自动应用。

提供可执行的引导脚本:技能提供了 bootstrap_env.shprepare_assets.py 两个脚本。前者负责环境的创建和激活,后者负责资产的下载和路径规划。这些脚本可以直接运行,也可以由 AI 编程助手代为执行。

轻量、保守、只做 setup:技能的定位非常克制——它只做 setup,不做 execution。环境建好了、资产准备好了,它的工作就结束了。后续的命令执行、结果记录、审计报告,都交给 minimal-run-and-audit 等其他技能。

安装方法

env-and-assets-bootstrap 支持 Claude Code、Codex CLI、Cursor、OpenClaw、GitHub Copilot 等多种 AI 编程助手

通过 npx skills 安装(推荐)

在项目根目录打开终端,执行以下命令:

bash
npx skills add https://github.com/lllllllama/ai-paper-reproduction-skill --skill env-and-assets-bootstrap

指定 Agent 安装

如果只想为某个特定的 AI 助手安装,可以用 --agent 参数指定:

bash
npx -y skills add lllllllama/ai-paper-reproduction-skill --skill env-and-assets-bootstrap --agent claude-code

通过 skill4agent 安装

bash
npx skill4agent add lllllllama/ai-paper-reproduction-skill env-and-assets-bootstrap

通过 bzskills 安装

bash
npx bzskills add lllllllama/ai-paper-reproduction-skill --skill env-and-assets-bootstrap

安装完成后,技能会自动配置到你的 AI 编程环境中,slug 保持为 env-and-assets-bootstrap 以确保兼容性

什么时候该用它

env-and-assets-bootstrap 的使用边界非常清晰。

应该使用的情况

  • 在 README-first 的复现流程中,已经确定了复现目标,需要在运行任何命令之前准备环境和资产

  • 目标仓库依赖 conda 环境、数据集、检查点或缓存目录

  • 需要一个保守的、可复现的环境配置方案

  • 用户明确表示希望在运行任何命令之前先完成 setup

不应该使用的情况

  • 还在扫描仓库的初始阶段——那是 repo-intake-and-plan 的事

  • 需要完整的端到端编排——那是 ai-research-reproduction 的事

  • 需要解读论文内容——那是 paper-context-resolver 的事

  • 需要生成最终的运行报告——那是 minimal-run-and-audit 的事

  • 进行与特定复现目标无关的通用环境配置

使用案例

案例一:拿到一个新仓库,先把环境配好

你从 GitHub 上 clone 了一个论文复现仓库,README 里写着“使用 conda 创建环境”。你告诉 AI 助手:“帮我准备好这个仓库的环境和资产,我要开始跑了。”

env-and-assets-bootstrap 被调用后,会扫描仓库根目录的 environment.yml,生成一个 conda 环境创建方案,然后执行 conda env create -f environment.yml。环境建好之后,技能会给出激活命令——conda activate <env_name>——并验证环境是否可用。

案例二:仓库依赖外部数据集和检查点

你正在复现一篇图像分类论文,仓库的 README 提到需要下载 ImageNet 数据集和 ResNet-50 的预训练权重,但没有说明具体放哪里。你告诉 AI 助手:“帮我准备一下这个仓库需要的数据集和权重。”

技能会检查仓库代码中引用的路径——比如 --data_dir /path/to/imagenet--checkpoint /path/to/resnet50.pth——然后生成一份资产路径规划。它可能会建议你把数据集放在 ./data/imagenet/,把权重放在 ./checkpoints/resnet50.pth,并给出下载链接和校验和。

案例三:作为完整复现流程的第一步

你正在用 RigorPilot 的完整复现流程(ai-research-reproduction)处理一个论文仓库。主编排器在 repo-intake-and-plan 完成仓库扫描之后、minimal-run-and-audit 执行命令之前,调用 env-and-assets-bootstrap 完成环境和资产的准备。环境建好了、数据集放对了位置,后续的命令执行才能顺利跑通。

案例四:环境配置方案太激进,需要保守策略

某个仓库的 README 建议直接 pip install -r requirements.txt,但你知道这个仓库依赖的某些包版本可能与系统环境冲突。你告诉 AI 助手:“用 conda 先创建一个干净的环境,再装依赖。”

技能会优先采用 conda-first 策略,用 conda 创建一个全新的隔离环境,然后再用 pip 安装剩余的依赖。这种方式比直接在系统 Python 环境中安装更安全、更可复现。

几个值得注意的细节

它只做 setup,不跑任何代码:这是 env-and-assets-bootstrap 最核心的边界。它不执行任何模型推理、训练或评估命令。它的全部工作就是“准备”——环境准备好、资产准备好、路径规划好——然后就把舞台交给其他技能。

保守优先,不搞激进优化:技能的设计原则是“conservative”——保守。它不会为了省事而跳过某些步骤,不会为了速度而使用非标准路径,不会为了便利而修改系统环境。每一步都按照可复现的标准来。

conda-first,不是 conda-only:默认采用 conda-first 策略,但如果仓库没有 environment.yml 只有 requirements.txt,技能也会退而使用 venv 或 pip。关键是“先创建隔离环境”,至于是 conda 还是 venv,取决于仓库的实际情况。

不替代人工判断:技能生成的方案是基于 README 和仓库文件的保守推荐。如果 README 本身信息不足,技能会如实反映——它不会替你猜一个数据集路径、不会替你编一个检查点下载链接。该问人的时候它会问。

安装后 slug 保持不变:技能安装后的标识符保持为 env-and-assets-bootstrap,便于在不同平台和工具之间保持兼容

版本与兼容性:该技能最初属于 ai-research-workflow-skills 仓库,后迁移至 RigorPilot Skillsai-paper-reproduction-skill 作为兼容别名仍然可用。无论通过哪个仓库安装,技能本身的功能是一致的。