Skill doesn't activate

確認 SKILL.md 位於複製目錄的根目錄，並重新啟動 Claude Code。

freemcplab / 目錄 / 演練場 / narrator-ai-cli-skill

● 社群 GridLtd-ProductDev ⚡ 即開即用

narrator-ai-cli-skill

Name: narrator-ai-cli-skill (Claude Skill)
Author: GridLtd-ProductDev

作者 GridLtd-ProductDev · GridLtd-ProductDev/narrator-ai-cli-skill

Narrator AI 影片配音 CLI 的 Agent 技能 — 由 Claude 從命令列端對端驅動配音流程。

narrator-ai-cli-skill 教導 Claude 如何使用 narrator-ai-cli（Narrator AI 影片配音 API 的 CLI 客戶端）。它封裝了旗標、常見流程與輸出處理，讓 Claude 能組合配音提示、啟動工作、輪詢完成狀態，並將輸出檔案放置到合適的位置 — 當您想要批次配音一系列影片而無需手動執行 CLI 時特別實用。

▶ 觀看演示 📦 安裝 💡 使用場景

為什麼要用

核心特性

封裝 narrator-ai-cli 的旗標與子命令
處理工作提交與輪詢模式
輸出檔案放置慣例
跨多個來源影片的批次配音
當 API 金鑰或設定缺失時明確報錯

即時演示

實際使用效果

narrator-ai-cli-skill.replay ▶ 就緒

0/0

安裝

作者儲存庫 · Claude Skills 官方文件

使用場景

實戰用法： narrator-ai-cli-skill

如何根據腳本為單一影片配音

👤 使用 Narrator AI 進行配音的創作者與剪輯師 ⏱ ~15 min beginner

何時使用： 您有一部影片和一份配音腳本草稿，想透過 CLI 產生配音。

步驟

準備輸入素材

給定我的影片 scene_01.mp4 和配音腳本 script.md，執行 narrator-ai-cli 並將輸出儲存到 ./narrations/。✓ 已複製

→ 使用正確旗標呼叫 CLI
等待並驗證

輪詢直到工作完成，然後確認輸出檔案存在且有音訊內容。✓ 已複製

→ 輸出檔案存在且時長不為零

結果： 配音檔案已就緒，可直接匯入您的剪輯軟體。

注意事項

長時間工作在 shell 中逾時 — 使用 CLI 的非同步模式搭配輪詢，而非阻塞式呼叫

搭配使用： filesystem

批次為一系列場景配音

👤 擁有多場景專案的團隊 ⏱ ~45 min intermediate

何時使用： 您有 10 個以上場景，每個場景都有對應腳本，需要以一致的方式完成配音。

步驟

遍歷專案結構

找出 project/ 下所有 scene_*.mp4 與 scene_*.md 配對，並逐一排入配音佇列。✓ 已複製

→ 列舉出所有配對並建立工作佇列
序列或並行執行

最多同時執行 3 個工作；依 API 限制進行速率控制。✓ 已複製

→ 受控的並發執行
回報結果

產生一份表格：場景、狀態、時長、輸出路徑。✓ 已複製

→ 清楚的完成狀態表格

結果： 整個專案在單次執行中完成配音，並附有清楚的狀態報告。

注意事項

批次執行中途觸碰 API 限制 — 遵守上游速率限制；遇到 429 時進行退避重試

搭配使用： filesystem

組合

與其他 MCP 搭配，撬動十倍槓桿

narrator-ai-cli-skill + filesystem

自動尋找輸入素材，並將輸出放置到結構化資料夾中

遍歷 project/，為每個場景配音，輸出至 project/narrations/。✓ 已複製

narrator-ai-cli-skill + claude-shorts-skill

為 claude-shorts 產生的短片加入 AI 配音

為每支渲染完成的短片配音一段開場白並混音進去。✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫	成本
cli-invocation	inputs (video+script) + flags	每次配音執行時呼叫	narrator-ai API usage
job-polling	job id	提交工作後呼叫	minimal
batch-orchestration	list of jobs	多場景專案時呼叫	depends on batch size

成本與限制

運行它的成本

API 配額: 依 Narrator AI 方案而定
每次呼叫 Token 數: LLM token 消耗極少；主要費用來自 API 使用分鐘數
費用: 由 Narrator AI 按 API 用量計費
提示: 僅對最終腳本進行配音；先在 LLM 中反覆調整文字內容

安全

權限、密鑰、影響範圍

憑證儲存： Narrator AI API 金鑰存放於環境變數中；切勿直接寫入程式碼

資料出站： Narrator AI endpoints

上傳的影片／音訊會經過第三方服務處理；請確認其資料處理政策

故障排查

常見錯誤與修復

CLI command not found

安裝 narrator-ai-cli，並確認它在 Claude Code 執行環境的 PATH 中。

驗證： which narrator-ai-cli

401 from Narrator API

設定 NARRATOR_API_KEY（或 CLI 所需的對應環境變數）。

驗證： env | grep NARRATOR

替代方案