前言¶

做短視頻、分鏡預覽或互動內容時，畫面往往先定稿，音效卻要單獨找素材庫、對節奏、再剪輯對齊。純靠 Agent 寫提示詞，也很難直接得到與畫面一致的短音效。若希望 Coding Agent 在對話里根據場景描述或某一幀畫面生成配套音效，需要一條把「文本 / 幀圖像」接到 Kling SFX 能力上的 Skill 路徑。

下面介紹 SkillHub 社區技能 keling sfx（座標 @user_f95f21b8/dlazy-keling-sfx，當前版本 1.0.9）：它面向 design-media 類任務，用 Kling SFX 生成與場景匹配的聲音效果。

這是什麼¶

keling sfx 是發佈者 user_f95f21b8 在 SkillHub 上架的社區 Skill（來源標註爲 community）。官方簡介爲：

Generate matching scene sound effects based on text descriptions or video frames using Kling SFX.

一句話：讓 Agent 根據文字場景描述或視頻幀，調用 Kling SFX 生成對應的場景音效。Skill 採用通用 SKILL.md 格式，安裝後由 Agent 讀取技能說明並按其中步驟調用後端能力。

SkillHub 頁面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-keling-sfx
API 條目：https://api.skillhub.cn/user_f95f21b8/dlazy-keling-sfx

核心功能¶

依據已公開資料，可確認的能力邊界如下：

1. 文本驅動：用自然語言描述場景（環境聲、動作聲等），生成匹配的音效。
2. 視頻幀驅動：以視頻中的某一幀爲參考，生成與該畫面氛圍一致的音效。
3. 底層模型：能力來自 Kling SFX（可靈音效相關能力），Skill 本身負責在 Agent 工作流裏暴露調用方式。
4. 需 API 密鑰：SkillHub 標籤爲 requires_api_key=true，使用前需按 SKILL.md 配置密鑰；具體字段名與獲取方式以安裝包內文檔爲準。

未在官方頁面單獨列出的參數、輸出格式或計費細則，本文不展開，避免與 SKILL.md 不一致。

安裝與啓用¶

SkillHub 推薦的安裝方式是：先按官方安裝說明準備 skillhub CLI，再把該 Skill 裝到當前 Agent 能識別的 skills 目錄（裝錯目錄會導致 Agent 讀不到技能）。

1. 檢查或安裝 skillhub CLI¶

command -v skillhub && skillhub --version

若未安裝，可按 SkillHub 文檔執行完整安裝（CLI + 默認 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

說明文檔：https://skillhub.cn/install/skillhub.md

2. 安裝 keling sfx¶

官方頁面給出的安裝提示爲：根據上述安裝文檔，安裝 @user_f95f21b8/dlazy-keling-sfx。

命令形態與 SkillHub 通用約定一致（--dir 必須指向本機 Agent 的 skills 目錄）：

skillhub install user_f95f21b8/dlazy-keling-sfx --dir <你的 Agent skills 目錄>

常見路徑（摘自 SkillHub 安裝文檔，按你實際使用的客戶端選擇其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝後重啓或刷新 Agent，使其加載新 Skill；API Key 等配置請打開技能目錄中的 SKILL.md 按發佈者說明填寫。

典型用法¶

公開 SkillHub 頁未附帶獨立示例倉庫，典型流程應遵循 SKILL.md 中的 Agent 指引，與簡介一致的使用意圖如下：

1. 在對話中說明要生成的音效場景（例如「雨夜街道、遠處車流」「木門緩慢推開」），由 Agent 走文本生成路徑。
2. 若已有視頻或分鏡，提供某一幀或讓 Agent 截取幀，走「畫面 → 音效」路徑。
3. 因標記了 requires_api_key=true，首次使用前在 SKILL.md 要求的位置配置 API 密鑰，再發起生成。

具體子命令、請求字段與返回 JSON 結構以安裝後的 SKILL.md 爲準；不要在未讀文檔的情況下臆造 CLI 參數。

適用場景與注意¶

適合誰

• 需要在 Cursor、Claude Code、Codex 等帶 Skills 的 Agent 裏，把「寫分鏡 / 描述場景」和「出音效」放在同一條對話鏈路裏的創作者或開發者。
• 已具備或可申請 Kling SFX 相關 API 訪問（Skill 依賴密鑰）。

限制與注意

• 社區來源（community），升級與維護節奏跟隨發佈者 user_f95f21b8，使用前可看 SkillHub 上的版本號（當前 v1.0.9）。
• SkillHub 統計（以 API 抓取爲準）：評分 100000，下載 977，安裝 3；數字僅作商店參考，不代表效果保證。
• 涉及上傳視頻幀或調用雲端 API 時，注意素材版權、隱私與服務商條款。
• 安裝務必使用 --dir 指向正確 skills 目錄；否則默認可能落在 ./skills/，Agent 無法識別。

結尾¶

keling sfx 把 Kling SFX 的「文本 / 視頻幀 → 場景音效」能力封裝成 Agent Skill，減輕找素材和對軌的成本。若你要在本地 Agent 中啓用，可從 SkillHub 頁面與安裝文檔入手：

• https://www.skillhub.cn/skills/user_f95f21b8/dlazy-keling-sfx
• https://skillhub.cn/install/skillhub.md