---
name: sound-effects
description: 通过 playcraft CLI 生成音效（SFX）；--prompt 仅支持英文。含时长、循环等 CLI 参数与英文提示词写法，与 playcraft-audio-generation 配合。
license: MIT
source: https://github.com/elevenlabs/skills/tree/main/sound-effects
compatibility: agent,opencode
---

# 音效生成（SFX）— CLI 与提示词

用**英文文字描述**生成短音效（平台后端走 ElevenLabs Sound Effects，**不是**语音 TTS）。你在沙箱里**只使用 `playcraft tools generate-sfx`**；云端认证与厂商侧配置由平台处理，**无需也不应**在技能文档或命令中涉及密钥、环境变量或自行调用厂商 HTTP/SDK。

## 语言（必须遵守）

**`--prompt` 只支持英文。** 不要用中文或其他语言写 SFX 描述：模型对非英文支持差，易出现杂音、语义跑偏或听感像念白。若用户给中文需求，先在心里翻译成简洁英文短语再写入 `--prompt`。

## CLI

```bash
playcraft tools generate-sfx \
  --prompt "<English only, see Prompt Tips below>" \
  [--duration <秒>] \
  [--loop] \
  --output <路径>
```

| CLI 选项 | 说明 |
|----------|------|
| `--prompt` | 必填，**仅英文**音效描述 |
| `--duration` | 可选，约 0.5–30 秒 |
| `--loop` | 可选，可循环音效 |
| `--output` | 必填，保存路径（如 `./assets/audio/click.mp3`） |

生成 BGM 用 `playcraft tools generate-bgm`（见 `playcraft-audio-generation`）。

## Prompt Tips（英文 `--prompt`，优先遵守）

- 具体化："Heavy rain on a tin roof" 优于 "Rain"
- 组合层次："Footsteps on gravel with distant traffic"
- 标明风格："Cinematic braam, horror" 或 "8-bit retro jump sound"
- 情绪与场景："Eerie wind howling through an abandoned building"
- 使用**非对白、偏拟声/材质/场景**的短语；长句口语容易听起来像念稿（虽非 TTS API）

## 失败时

根据 CLI 报错判断：参数问题则改 `--prompt` / `--duration`；若提示权限、额度或上游不可用，向用户说明需**在平台侧**检查配置或配额——**不要**尝试自行配置密钥或直连厂商 API。