setup-sandbox 是做什麼的？
為新的沙箱設置初始檔案系統。透過 Recoup CLI 擷取帳戶的組織與藝術家資訊，並建構資料夾結構。在沙箱剛建立且尚無檔案系統時使用。執行前，請檢查沙箱是否已有 orgs/ 目錄 — 若有，則無需使用此技能。
使用方式
此技能通常作為沙箱初始化流程的一部分自動執行。它依賴於 Recoup CLI 來獲取必要的帳戶資料。
前提條件
- 沙箱必須為全新建立，且尚未有任何檔案系統。
- 需要安裝並配置好 Recoup CLI。
- 執行前，請手動或透過指令檢查
orgs/目錄是否存在：
if [ -d "orgs" ]; then
echo "orgs 目錄已存在，跳過此技能。"
else
echo "準備執行 setup-sandbox..."
# 在此執行技能邏輯
fi
技能流程
- 檢查目錄：確認
orgs/不存在。 - 擷取資料：透過 Recoup CLI 取得組織與藝術家清單。
- 建構結構：根據資料建立對應的資料夾層級。
環境變數
| 變數名稱 | 說明 | 必要 |
|---|---|---|
RECOUP_API_KEY | 用於驗證 Recoup CLI 的 API 金鑰 | 是 |
SANDBOX_ID | 目前沙箱的唯一識別碼 | 是 |
輸出範例
執行成功後，沙箱的檔案系統將類似如下結構：
orgs/
├── org-1/
│ ├── artist-a/
│ └── artist-b/
└── org-2/
└── artist-c/
注意事項
- 僅適用於新沙箱：若沙箱已有
orgs/目錄，請勿執行此技能，以免資料不一致。 - CLI 依賴：確保 Recoup CLI 版本為最新，以避免相容性問題。
- 權限：使用的 API 金鑰需具有讀取組織與藝術家資訊的權限。
疑難排解
orgs 目錄已存在
若執行時發現 orgs/ 已存在，腳本將自動中止，並輸出警告訊息。請手動檢查沙箱狀態。
CLI 連線失敗
請確認網路連線正常，且 RECOUP_API_KEY 已正確設定。