SKILL.md
readonlyread-only
name
setup-api-key
description
引導使用者設定 ElevenLabs API 金鑰，以便使用 ElevenLabs MCP 工具。當使用者需要設定 ElevenLabs API 金鑰、ElevenLabs 工具因缺少 API 金鑰而失敗，或使用者提到需要存取 ElevenLabs 時使用。首先檢查 ELEVENLABS_API_KEY 是否已設定且有效，僅在需要時才執行完整設定流程。
ElevenLabs API 金鑰設定
引導使用者取得並設定 ElevenLabs API 金鑰。
工作流程
步驟 0：先檢查現有的 API 金鑰
在向使用者索取金鑰之前，先檢查是否已有 ELEVENLABS_API_KEY：
- 檢查目前環境中是否存在
ELEVENLABS_API_KEY。如果存在，使用該值進行初步檢查。 - 僅當環境中沒有時，才檢查
.env檔案中是否有ELEVENLABS_API_KEY=<value>。 - 不要列印、引用或重複金鑰。如果提到它，請遮罩處理。
- 如果找到現有金鑰，驗證它：
GET https://api.elevenlabs.io/v1/user 標頭：xi-api-key: <現有-api-金鑰> - 如果現有金鑰驗證成功：
- 告知使用者 ElevenLabs 已設定完成且可正常運作
- 跳過設定流程
- 詢問是否要更換/輪替金鑰；如果不要，則停止
- 如果現有金鑰驗證失敗：
- 告知使用者現有金鑰似乎無效或已過期
- 繼續進行步驟 1
步驟 1：索取 API 金鑰
告知使用者：
若要設定 ElevenLabs，請開啟 API 金鑰頁面：https://elevenlabs.io/app/settings/api-keys
（需要帳號嗎？請先在 https://elevenlabs.io/app/sign-up 建立一個）
如果您還沒有 API 金鑰：
- 點擊「Create key」
- 為金鑰命名（或使用預設名稱）
- 設定金鑰的權限。如果您提供的金鑰將「User」權限設為「Read」，此技能會自動驗證金鑰是否可用
- 點擊「Create key」確認
- 立即複製金鑰 - 它只會顯示一次！
請勿將金鑰貼到此對話中。而是將其複製/貼到您的本機
.env檔案中：ELEVENLABS_API_KEY=您的-api-金鑰如果
.env已有ELEVENLABS_API_KEY=...這行，請取代該行。
儲存後告訴我，但不要分享金鑰。
然後等待使用者確認金鑰已儲存在本機。
步驟 2：驗證與設定
在使用者表示金鑰已儲存後：
- 重新檢查
.env和目前環境中是否有ELEVENLABS_API_KEY，但此步驟以.env為準。 - 如果
.env包含一個值，即使目前環境中有不同的ELEVENLABS_API_KEY，也驗證該值。 - 如果
.env中沒有金鑰：- 告知使用者
.env似乎沒有包含ELEVENLABS_API_KEY。 - 再次顯示預期的行。
- 如果目前環境中有金鑰，請注意此步驟仍需要將金鑰儲存在
.env中。 - 提醒他們不要將金鑰貼到對話中。
- 告知使用者
- 如果找到
.env金鑰，驗證它：GET https://api.elevenlabs.io/v1/user 標頭：xi-api-key: <本機-api-金鑰> - 如果驗證失敗：
- 告知使用者本機金鑰似乎無效或已過期。
- 提醒他們 API 金鑰頁面。
- 要求他們取代
.env中的值，並在儲存後告知。
- 如果驗證成功，確認：
完成。ElevenLabs 已設定完成，且
.env中的金鑰可正常運作。
安全規則
- 切勿要求使用者將 API 金鑰、權杖或密碼貼到對話中。
- 切勿列印或回顯環境變數或
.env中的 API 金鑰值。 - 對於本機持續設定，優先使用
.env或受管密碼，而非 shell 歷史記錄。 - 對於瀏覽器或用戶端應用程式，將
ELEVENLABS_API_KEY保留在伺服器端，並在適當時發出短期權杖。
