SuperAPI AI 工具集

generate-openenv-env

设计与创作

查看项目

更新于 10-15 22:15

技能介绍

用途:从用例提示出发,端到端构建生产级 OpenEnv 环境,例如“为 textarena 库生成环境”会生成 envs/textarena_env/。

主要能力:解析用例并命名环境(snake_case、简短、领域相关);编码前调研目标库/API,提取安装依赖、环境创建 API、动作与观测格式、奖励与终止语义、特殊设置等关键信息;挖掘 2-3 个现有 OpenEnv 环境作为模板,并阅读 references/openenv-tutorial-01-environments.md(Part 10)与 references/openenv-docs-environment-builder.md;提出影响架构的实现问题;选择环境原型(默认 typed step/reset,或 MCP 工具环境,或特殊客户端流程);用 CLI 脚手架生成文件;按 OpenEnv 契约实现 models.py、server/<name>_environment.py、server/app.py、client.py、openenv.yaml、README.md;最后验证并交付。

使用方式:脚手架命令为 PYTHONPATH=src uv run openenv init <name>_env --output-dir envs。实现需使用类型化模型,server/app.py 用 create_app(<factory_or_class>, ActionType, ObservationType, env_name=...),并采用双导入模式。验证命令包括 PYTHONPATH=src:envs uv run python -c "from envs.<name>_env.server.<name>_environment import <ClassName>Environment"、openenv build、openenv validate --level static --skip-build、pytest,以及无测试时的 uvicorn 冒烟检查与 openenv validate --url http://localhost:8000。

适用场景:需要为某库或 API 新建 OpenEnv 环境时。

限制:不进入模型训练/评估流程;不得臆造库 API;实现前必须至少阅读一个现有环境;不复制过时清单模式或构建产物;除非明确支持并发会话,否则 max_concurrent_envs 不得大于 1。缺失答案时需记录假设。