FineEnvs 是一个 Apache-2.0 许可的 Python 仓库,审计提交为 5e0b46e96bfd20105976e50a06a3b79c9c62f076(2026-10-12)。其项目本地 README 和配置具有权威性;历史运行、移动的主依赖、付费服务和已知运行时缺口不构成可复现性保证。
用途
该技能用于检查或固定 FineEnvs 检出并选择一个环境/项目路径;运行无后端 Wordle 冒烟测试或其他明确批准的本地夹具检查;阅读奖励、评分器、覆盖率、数据许可或框架契约证据;使用捆绑的领域和框架生成器契约编写新环境。不应将其用作通用训练、服务、Ray、沙箱、Hugging Face、提供商或云操作指南;这些操作应使用所属技能,此处仅提供审计参考以识别其前置条件和副作用。
主要能力
提供离线预检脚本,可从仓库根目录运行 python3 .agent-skills/fineenvs/scripts/preflight.py --json,或从已安装技能根目录运行 python3 "$SKILLS_ROOT/fineenvs/scripts/preflight.py" --json。对于检出,可添加 --repo PATH --expect-commit 5e0b46e96bfd20105976e50a06a3b79c9c62f076。runtime_verified:false 表示仅检查:该辅助工具不导入框架、不读取机密、不查询 HTTP/GPU 状态、不创建沙箱、不运行评估。可选框架标记仅供参考,不应要求所有方言同时存在。
使用方式
固定并阅读:验证提供的检出提交,然后阅读其项目本地 README 及相关 pyproject.toml、REPRODUCE.md、VALIDATION.md 或 eval/README.md。阅读 references/upstream.md 获取审计矩阵、源链接、框架契约、奖励注意事项、许可、分支要求和云效应。
行动前分类:将清单、源检查和无后端本地夹具与凭据、下载、服务启动、提供商推理、E2B/Daytona 或 HF 沙箱、付费 Spaces、GPU 作业、Hub/桶写入和部署分开。后者需获得明确批准,并说明提供商、模型、硬件、数据量、输出路径和花费。
选择最小路径:Wordle Verifiers 是低成本本地路线:cd 00-environments-101/envs/wordle/verifiers && uv sync && uv run python rollout.py。保持仓库根 .env 处理如文档所述;切勿发明每项目机密文件。
保留证据:报告固定提交、项目路径、解析版本或提交、分割、模型/检查点、命令、端点、硬件、奖励/评分器设置、覆盖率及输出目录。冒烟测试证明执行/检查点重载,而非学习或质量。
安全编写:保留一个框架无关的领域模块,收集目标/动作/状态/奖励/后端/终止/路径需求,然后使用捆绑的编写或框架生成器技能。最后完成所选框架的导入、发现和 rollout 检查;编写过程中不要启动训练。
示例
离线主机/检出检查;不启动上游进程。
python3 .agent-skills/fineenvs/scripts/preflight.py --json
python3 .agent-skills/fineenvs/scripts/preflight.py --json
--repo /path/to/FineEnvs --expect-commit 5e0b46e96bfd20105976e50a06a3b79c9c62f076
阅读固定项目说明后的最低成本本地冒烟测试。
cd 00-environments-101/envs/wordle/verifiers uv sync && uv run python rollout.py
离线 LaTeX OCR 夹具路径(--real-data 变体非离线)。
uv run --project 01-latex-ocr/envs/latex_ocr --extra dev
pytest 01-latex-ocr/envs/latex_ocr/tests -q
uv run --project 01-latex-ocr/envs/latex_ocr latex-ocr-smoke
最佳实践
在固定修订版阅读项目本地说明;根快速入门不是通用契约。保持本地端点在 localhost 并使用文档化变量;切勿探测生产 Spaces。将历史表格视为合格证据,而非当前基准声明;报告覆盖率时使用 pass@1。保留 Apache-2.0 通知及 PortSim CC BY-SA 4.0/ODbL 归属义务。不要代表用户授权云花费、数据许可、凭据或外部副作用。
适用场景
适用于需要检查、固定或运行 FineEnvs 环境与数据集项目的开发者或研究人员,尤其是进行本地冒烟测试、阅读奖励与评分器证据、或编写新环境时。不适用于通用训练、服务、云操作等场景。
限制
该技能不提供通用训练、服务、Ray、沙箱、Hugging Face、提供商或云操作指南。涉及凭据、下载、服务启动、付费沙箱、GPU 作业等操作需明确批准。历史运行和移动依赖不保证可复现性。