Turbo 是 2389-research/speed-run 技能集中的一项代码生成技能，其核心思路是：由 Claude 编写契约，Cerebras 托管的 LLM 实现代码，生成的文件直接写入磁盘。使用时需声明“I'm using speed-run:turbo for hosted code generation.”。
用途
Turbo 适用于以下场景：算法类代码（如限流器、解析器、状态机）、多文件实现（3 个以上）、样板代码较多的实现、token 受限的会话。
以下场景建议改用 Claude 直接生成：CRUD/存储操作（由于没有修复开销，Claude 更便宜）、需要复杂协调的单一实现、修复周期代价高昂的速度关键任务。
主要能力与权衡
Turbo 通过托管 LLM 快速生成代码，并只返回元数据（写入的文件、行数），Claude 不会看到生成的代码。与 Claude 直接生成相比：速度约 0.5 秒对约 10 秒；token 成本约节省 60%；首次通过质量约 80-95%（Claude 约 100%）；通常需要 0-2 次修复（Claude 为 0 次）。
托管 LLM 通常能正确完成约 90% 的内容，包括：数据模型与契约完全匹配、路由/端点正确、核心算法逻辑、基本错误处理。
使用方式
第 1 步：编写契约提示词
用精确规格组织提示词，包含数据契约（使用完全一致的模型）、API 契约（使用完全一致的路由）、算法（分步逻辑、状态管理细节、边界情况处理）和规则。示例结构如下：
Build [X] with [tech stack].
DATA CONTRACT (use exactly these models):
[Pydantic models / interfaces with exact field names and types]
示例： class Task(BaseModel): id: str title: str completed: bool = False created_at: datetime
class TaskCreate(BaseModel): title: str
API CONTRACT (use exactly these routes):
POST /tasks -> Task # Create task GET /tasks -> list[Task] # List all tasks GET /tasks/{id} -> Task # Get single task DELETE /tasks/{id} -> dict # Delete task POST /reset -> dict # Reset state (for testing)
ALGORITHM:
- [Step-by-step logic for the implementation]
- [Include state management details]
- [Include edge case handling]
RULES:
- Use FastAPI with uvicorn
- Store data in [storage mechanism]
- Return 404 for missing resources
- POST /reset must clear all state and return {"status": "ok"}
第 2 步：生成代码
调用：
mcp__speed-run__generate_and_write_files prompt: [contract prompt] output_dir: [target directory]
该调用只返回元数据（写入的文件、行数），Claude 不会看到生成的代码。
第 3 步：运行测试
针对生成的代码运行测试套件。
第 4 步：修复（如需要）
对于失败项，使用 Claude Edit 工具进行外科手术式修复（通常每次 1-4 行）。常见修复类型：缺少工具函数（偶发，约 4 行）、逻辑边界情况（偶发，1-2 行）、导入顺序（罕见，1 行）。
第 5 步：重新测试
重复第 3-4 步直到所有测试通过。即使需要修复，总 token 成本也远低于由 Claude 生成全部内容。
配置
需要设置以下变量：
- CEREBRAS_API_KEY：（必填）你的 API 密钥
- CEREBRAS_MODEL：默认 gpt-oss-120b，指定使用的模型
可用模型：
- gpt-oss-120b：价格 $0.35/$0.75，速度 3000 t/s，默认，性价比最佳，输出干净
- llama-3.3-70b：价格 $0.85/$1.20，速度 2100 t/s，可靠的备选
- qwen-3-32b：价格 $0.40/$0.80，速度 2600 t/s，带有冗长的 thinking 标签
- llama3.1-8b：价格 $0.10/$0.10，速度 2200 t/s，最便宜，可能需要更多修复
限制
首次生成质量并非 100%，通常需要 0-2 次修复；对于 CRUD/存储操作、需要复杂协调的单一实现以及修复周期代价高昂的速度关键任务，建议改用 Claude 直接生成。