add-sfx 是一个音效添加技能，用于在视频剪辑、动态图形、应用演示、短视频、动画或界面项目中引入本地音效文件。其核心用途是搜索并缓存 Woven SFX 音效，为需要 .wav 文件的项目提供可直接引用的本地音频。
适用场景：当视频剪辑、reel、短片、动画、产品演示或 UI 需要音效时；当用户要求 whoosh、pop、beep、glitch、impact、相机声、掌声、ding、刮擦声或类似音频提示时；当剪辑计划已列出 sound id、且文件必须在组装或渲染前存在于本地时。该技能不用于背景音乐、配音、唇同步、音频清理或生成歌曲。
前提条件：需要配置 MCP 服务器，仅安装技能不会启用工具；若缺少 sfx_* 工具，应引导用户查看 references/mcp-setup.md 并重启智能体。项目本地音效库按以下顺序解析：WOVEN_SFX_LIBRARY 环境变量、.claude/project.md 中的 sfx-library、当前工作目录下的 ./sounds/sfx/。
工作流程分三步：第一步用普通词汇调用 sfx_search，优先使用具体的声音词而非剪辑抽象词，例如“fast whoosh”“camera shutter”“short beep”“glitch”，并根据 id、标签、时长和默认音量选择最接近的结果，不得虚构 sound id 或文件名；第二步用 sfx_pull 并传入所选 id，在项目需要 .wav 的位置使用返回的 localPath；第三步在组装或渲染前用 sfx_list_installed 确认计划中的音效已存在，若缺失则再次调用 sfx_pull 拉取。
搜索提示：转场移动可用 whoosh、fast whoosh、deep whoosh；UI 反馈可用 beep、click、ding、notification；相机时刻可用 camera、camera shutter、camera flash；数字断裂可用 glitch、scratch、record scratch；冲击或强调可用 impact、drop、thud、pop；人群反应可用 applause、cheers、gasp。
记录结果：编写剪辑计划或交付时，应包含 id（目录音效 id）、file（搜索结果中的 .wav 文件名）、localPath（由 sfx_pull 返回）、duration_ms（用于计时的片段长度）、default_volume（起始增益，仅在混音需要时调整）。
常见错误：不要从 pull-in 或 fade 等转场标签开始，而应搜索想要的声音本身；不要使用解析器工作流，应先搜索再按返回 id 拉取；不要猜测文件名，应先搜索再按返回 id 拉取；不要将 Woven SFX 用于音乐铺底或人声轨道。