结构与配置

workspace directory 是连接到平台 workspace 的 GitHub workspace repository 的本地 clone。平台会从 Osmosis workspace template 创建新的 workspace repositories。

repository/
├── rollouts/                            # AgentWorkflow + Grader code
├── configs/
│   ├── eval/                            # Evaluation configs
│   ├── AGENTS.md                        # AI assistant instructions for configs
│   ├── training/
│   │   └── default.toml                 # Training config template
│   └── benchmark/                       # 可选：benchmark submit configs
│       └── default.toml                 # Benchmark config template
├── data/                                # Local test datasets
├── pyproject.toml                       # Python project config
├── README.md                            # Project readme
├── AGENTS.md                            # AI coding assistant 的 canonical instructions
├── CLAUDE.md                            # Claude Code 指向 AGENTS.md 的 pointer
└── .gitignore                           # Git ignore rules

必需目录

CLI 期望以下目录存在：

路径	用途
`rollouts/`	rollout 代码，每个 rollout 一个子目录
`configs/training/`	用于 `osmosis train submit` 的训练任务 TOML 文件
`configs/eval/`	用于 `osmosis eval submit` 的 evaluation run TOML 文件
`data/`	用于 `osmosis dataset upload` 的本地数据集

configs/benchmark/ 是可选目录，仅供 osmosis benchmark submit 使用；osmosis doctor 和 osmosis doctor --fix 都不会要求或创建它。在 workspace directory 中任意位置运行健康检查：

osmosis doctor

修复缺失的 scaffold 目录，且不覆盖已有文件：

osmosis doctor --fix

`rollouts/`

存放 AgentWorkflow 和 Grader 代码的目录。每个 rollout 都是一个子目录，包含一个 entrypoint 文件（通常是 main.py），用于定义 agent workflow 和 grading 逻辑。

rollouts/
└── my-rollout/
    ├── main.py          # Entrypoint: defines AgentWorkflow + Grader
    ├── pyproject.toml   # Rollout package dependencies
    └── README.md        # Rollout notes

创建新的 rollout scaffold：

osmosis rollout init <name>

或应用 starter template：

osmosis template list
osmosis template apply multiply-local-strands

`configs/`

用于 evaluation 和 training 的配置文件，以及可选的 benchmark submission configs。

子目录	`doctor` 是否要求	用途	参考
`configs/training/`	Yes	用于 `osmosis train submit` 的训练任务 configs	Training Config
`configs/eval/`	Yes	用于 `osmosis eval submit` 的 evaluation run configs	Evaluation Config
`configs/benchmark/`	No	仅供 `osmosis benchmark submit` 使用的可选 benchmark run configs	Benchmark Config

默认 templates 和 rollout-specific evaluation 与 training configs 已预填必需字段，并以注释形式包含可选设置。完整 TOML schema 参考请参见 Configuration Files。

`data/`

存放本地数据集文件的目录。通过 osmosis dataset upload 将它们上传到平台，然后在 training 和 evaluation configs 中通过名称引用已上传的数据集。

osmosis dataset upload data/<dataset-file>.jsonl

`pyproject.toml`

workspace repository 的标准 Python 项目配置。单个 rollout 也可以拥有自己的 rollouts/<name>/pyproject.toml 文件，用于 rollout-specific dependencies。

pyproject.toml

[project]
name = "osmosis-workspace"
description = "Osmosis workspace repository"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = [
    "osmosis-ai[server,strands]>=0.3.0,<0.4",
]

`AGENTS.md` 与 `CLAUDE.md`

AGENTS.md 是 AI coding assistants 的 canonical instruction 文件。CLAUDE.md 会将 Claude Code 指向 AGENTS.md，而不是作为第二套独立维护的 instructions。嵌套的 configs/AGENTS.md 为 configs/ 下的文件补充 config-specific rules。

生成的运行时状态

CLI 可能会在 .osmosis/ 下创建本地 runtime 文件，例如 exported metrics。请将它们视为本地状态，而不是源代码。

开始使用

运行

工作区

参考

必需目录

`rollouts/`

`configs/`

`data/`

`pyproject.toml`

`AGENTS.md` 与 `CLAUDE.md`

生成的运行时状态

下一步

Workspace 仓库

配置文件

​必需目录

​rollouts/

​configs/

​data/

​pyproject.toml

​AGENTS.md 与 CLAUDE.md

​生成的运行时状态

​下一步

Workspace 仓库

配置文件

必需目录

`rollouts/`

`configs/`

`data/`

`pyproject.toml`

`AGENTS.md` 与 `CLAUDE.md`

生成的运行时状态

下一步