自定义 Rollout 指南

使用 workspace 的 Agent Skills，将任务、数据集或现有 agent 转成可运行的 Osmosis rollout。如果想先运行无需设计工作的已知正确示例，请从 Multiply Quickstart 开始。

本指南假设您已经完成 Onboarding：workspace repository 已 clone，CLI 已安装并认证，并且您的 AI coding environment 已在 workspace directory 中打开。

Workspace Skills 的工作方式

Platform-created workspace repositories 会在 .agents/skills/ 下包含 project-local Agent Skills。加载这些 skills 的 agent 可以选择当前阶段对应的 workflow：

plan from dataset -> create rollout -> submit evaluation run -> debug failures -> prepare training run

这些 skills 会调用 Osmosis CLI 完成 workspace checks、dataset validation、evaluation runs 和 training preflight，不会取代 CLI。

何时使用这条路径

适合使用这条路径	适合运行 Multiply 示例
您已经知道想训练的任务	您想先证明平台可以端到端跑通
您有 sample data 或 platform dataset	您还不想设计数据集
您想让 agent 创建或改造 rollout 代码	您想复制命令，而不做产品选择
您愿意检查生成的代码和 evaluation run output	您还在学习 Osmosis workflow

使用 Workspace Repository 中的 Skills

在您的 AI coding environment 中打开 platform-created workspace repository。该仓库会把 workspace contract 和 Agent Skills 与 rollout code、configs、data 放在一起：

repository/
├── .agents/
│   └── skills/
├── .claude/
│   └── skills/
├── rollouts/
├── configs/
│   ├── eval/
│   └── training/
├── data/
├── AGENTS.md
├── CLAUDE.md
└── pyproject.toml

AGENTS.md 包含 always-loaded workspace contract。.agents/skills/ 包含 canonical workflow skills，.claude/skills/<skill-name> 会通过指向 .agents/skills/ 的 symlinks，把同一组 skills 暴露给 Claude Code。

验证 Workspace

在要求 agent 编写 rollout 代码前，确认 CLI 能解析 workspace：

osmosis doctor
osmosis auth whoami

让 Agent 从数据集开始规划

描述 task，并让 agent 从 workspace 的规划 skill 开始：

I want to train a model for <task> in this Osmosis workspace. Start with the `plan-training` skill: read the workspace instructions, help me settle the dataset plan, and propose the next step before creating rollouts, running evaluation runs, or submitting a training run.

Workspace skills 会引导 agent 完成以下阶段：

规划训练

检查 data/、现有 rollouts 和 workspace config，先确定 dataset schema，再编写 rollout 代码。

创建或改造 rollout

编写能加载、运行并给 samples 打分的最小 AgentWorkflow 和 Grader。生成的文件应保持在 rollouts/、configs/eval/、configs/training/ 和 data/ 下。

提交 evaluation run

Push rollout 到 workspace repository，并提交一次 evaluation run 作为 quality gate：

git push
osmosis eval submit configs/eval/<name>.toml
osmosis eval info <eval-run-name>

Debug 到 evaluation run 干净通过

Training 前修复 loading、dataset、grader、dependency 和 reward 问题。健康的 evaluation run 是从创建阶段交接到 training 准备阶段的节点。

准备 training run

Rollout 验证通过后，让 agent 检查 training run config 并运行 submit-time preflight。只有在您准备启动 platform training run 时才提交。

不要跳过 evaluation run。osmosis train submit 应该发生在 rollout 能够在平台上干净加载、运行并给 samples 打分之后。

Workspace Skills

Workspace skills 围绕 rollout creation stages 组织：

Skill	用途
`plan-training`	将任务想法或数据集转化为具体的 experiment plan
`create-rollouts`	创建或改造 rollout code、graders、entrypoints 和 baseline evaluation configs
`evaluate-rollouts`	提交 evaluation runs、比较 baselines，并检查 failures
`debug-rollouts`	诊断 evaluation、config、dataset、dependency 或 preflight failures
`submit-training`	准备 training run config、提交 training run，并检查 training run status

通常不需要按名称调用 skill。描述想要的结果；加载仓库 Agent Skills 的 agent 会选择匹配的 workflow。

下一步

SDK 概览

理解生成的 rollout 代码背后的 AgentWorkflow 和 Grader contract。

评估

提交 training run 前用 evaluation run 验证 rollouts。

Git Sync

Push rollout 修改，并让平台同步 evaluation run 和 training run 使用的代码版本。

训练任务

Evaluation run 通过后提交并监控 training run。

开始使用

核心 API

集成

执行

Agent 工具

Workspace Skills 的工作方式

何时使用这条路径

使用 Workspace Repository 中的 Skills

验证 Workspace

让 Agent 从数据集开始规划

Workspace Skills

下一步

SDK 概览

评估

Git Sync

训练任务

​Workspace Skills 的工作方式

​何时使用这条路径

​使用 Workspace Repository 中的 Skills

​验证 Workspace

​让 Agent 从数据集开始规划

​Workspace Skills

​下一步

SDK 概览

评估

Git Sync

训练任务

Workspace Skills 的工作方式

何时使用这条路径

使用 Workspace Repository 中的 Skills

验证 Workspace

让 Agent 从数据集开始规划

Workspace Skills

下一步