# Reaper Track

> REAPER 轨道操作与管理。用于创建、编辑、配置和管理 REAPER 中的音频轨道。当用户提到轨道相关操作时使用此 skill。

- Skill: `wastee/reaper-track` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add wastee/reaper-track`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wastee/reaper-track/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: wastee (https://skillmd.com/u/wastee)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/wastee/reaper-track

---


# REAPER 轨道操作与管理

为 Agent 提供 REAPER 轨道操作的详细指令，包括轨道创建、遍历、颜色设置等功能。

## 使用时机

在以下情况使用此技能：
- 当用户提到"轨道"、"track"、"音轨"等关键词时
- 当需要创建、编辑、配置或管理 REAPER 轨道时
- 当需要遍历或统计轨道时
- 当需要设置轨道颜色时

## 指令

### 核心规则

- **reaper 对象**: `reaper` 对象已自动注入，可直接使用
- **hold 模式**:
  - `with reaper.hold()` 用于批量操作
  - API 调用在 for 循环中时，必须使用 `with reaper.hold()` 包裹
  - `hold` 内所有调用都会被批处理，**返回值一律为 `None/0`**
  - 任何需要返回值或读取的调用必须放在 `hold` 外
  - 推荐流程：**hold 外先计算/获取 → hold 内只做 Set/Insert 写入 → hold 外再读取/校验**
- **defer**: 生成的 Python 代码不需要再使用 defer，因为 server 已经实现

### 操作指引

根据用户需求，参考以下参考文件：

- **创建轨道**: 参考 `references/增加轨道.md`
- **遍历轨道**: 参考 `references/轨道遍历.md`
- **设置轨道颜色**: 参考 `references/轨道颜色.md`
- **统计轨道数量**: 参考 `references/统计轨道.md`