yellowworkshops
創作者購買了 yellowworkshops 並新增了這個外掛程式。此技能負責在首次使用時準備好創作者自己的電腦（約 10 分鐘，僅一次），保持其更新，開啟指南，然後將每次編輯工作交給完整的編輯器技能（ugc-reels-editor）。創作者並非技術人員：切勿要求他們輸入指令；請自行執行所有操作並使用簡單的語言溝通。
在他們自己的電腦上執行
所有操作都在創作者自己的 Windows PC 或 Mac 上執行，透過 Claude 桌面應用程式的 Code 標籤（或 Claude Code）。如果狀態檢查顯示 SANDBOX，表示您位於一個小型雲端沙盒中，而非創作者的電腦上：請用一到兩句話告訴他們開啟 Claude 桌面應用程式，選擇 Code，在他們的電腦上選取一個資料夾，然後再次詢問。切勿為了繞過此問題而複製他們的任何素材。
設定指令
指令碼位於此檔案（此技能的基本目錄）旁邊的 scripts 資料夾中。請使用適用於該電腦的指令碼：
- Windows (PowerShell)：
powershell -NoProfile -ExecutionPolicy Bypass -File "<skill dir>\scripts\start.ps1" <command> - Mac (bash)：
bash "<skill dir>/scripts/start.sh" <command>
指令：status · all --key YWS-XXXX-XXXX-XXXX · update --daily · diag。首次執行會將 Python 的私有副本（已校驗總和固定）下載到 ~/yellowworkshops/runner；不會在系統範圍內安裝任何內容，也不需要管理員密碼。
每次創作者要求製作捲軸（或任何 yellowworkshops 相關事項）
- 執行
status。它會輸出 JSON，然後輸出READY、NOT_SET_UP或SANDBOX: …其中之一。 - NOT_SET_UP： 進行設定（如下），然後繼續處理他們的要求。
- READY： 執行
update --daily（快速；每天最多一次真實檢查）。如果它輸出UPDATED to …，用一句話告訴他們有什麼新內容（冒號後的文字）。然後移交給編輯器：如果ugc-reels-editor技能已列出，則使用該技能；否則讀取~/.claude/skills/ugc-reels-editor/SKILL.md並遵循其指示。使用~/yellowworkshops/ugc-reels-home.json中的 Python (python_cmd) 來執行編輯器的指令碼——引擎僅能使用該 Python 執行。新專案應放在~/yellowworkshops/projects/<reel name>/中。
首次設定
- 您需要他們的授權金鑰（
YWS-XXXX-XXXX-XXXX，位於他們的購買電子郵件中）。如果他們尚未提供，請索取金鑰——這是您唯一需要詢問的問題。用一句話告訴他們：「正在設定您的電腦：約 10 分鐘，僅此一次。您的影片絕不會離開這台電腦。」 - 執行
all --key <KEY>。它會下載約 1 GB 的資料，請在背景中執行並等待其完成（不要使用輪詢迴圈）。它會輸出一個編號步驟清單（如[3/7] 正在啟動您的授權…）及下載百分比；簡短傳達步驟標題即可，無需每行都報告。如果某個指令因時間限制而被中斷，請再次執行相同的指令：已完成的步驟會被跳過，下載會從中斷處繼續。 - 根據最後一行和退出代碼來讀取結果：
READY: …(退出代碼 0) → 告訴他們已完成設定，並提及 「隨時輸入 guide 獲取靈感」，然後繼續處理他們的要求（上節的步驟 3）。編輯器技能已新增至~/.claude/skills/ugc-reels-editor；如果在此工作階段中尚未列出，請直接讀取其 SKILL.md。NEEDS_KEY(退出代碼 11) → 要求提供金鑰，然後使用--key再次執行。SANDBOX: …(退出代碼 10) → 請參閱「在他們自己的電腦上執行」。SETUP_ERROR: <reason>(退出代碼 1) → 使用下方的手冊進行修復，然後再次執行all。詳細資訊請查看~/yellowworkshops/install-log.txt。
修復手冊 (SETUP_ERROR)
盡可能自行修復，其餘部分用一兩句簡單的話說明，然後重試。
- 無法連線 / 無法下載 → 檢查網路連線 (
curl -I https://yellowworkshops.com)。公司網路、VPN 或防火牆可能封鎖下載：請他們嘗試其他網路（手機熱點），然後重試。 - 僅剩 N GB 可用空間 → 告訴他們需要釋放多少空間以及從哪裡釋放（資源回收筒/垃圾桶、下載資料夾）；您可以顯示他們下載資料夾中最大的資料夾，但未經他們明確同意，請勿自行刪除任何內容。
- 金鑰已在另一台電腦上使用 → 每個授權僅限一台電腦。建議：在舊電腦上說「移動我的 yellowworkshops 授權」（它會執行
reels deactivate）；如果舊電腦已無法使用，請寫信至 [email protected]。 - 找不到金鑰 / 已退款 → 要求他們從電子郵件中再次複製金鑰（注意字母 O 與 0 的區別）；否則請聯絡支援。
- 防毒軟體 / 無法解壓縮 / 某個程式仍在佔用 → 關閉其他正在編輯捲軸的 Claude 工作階段和編輯器視窗；如果防毒軟體已隔離檔案，請要求他們允許主目錄中的
yellowworkshops資料夾。 - Windows「路徑過長」 → 主目錄路徑過長；請為設定指令設定
YWS_HOME為較短路徑，例如C:\yellowworkshops，然後重試。 - 此 Mac 上 FFmpeg/引擎無法啟動 → 從
status中記下 macOS 版本；需要 macOS 12 或更新版本。不支援較舊的 Mac：請委婉告知，並引導他們前往 [email protected] 申請退款。 - 下載清單未簽署 / 設定輔助程式過舊 → 更新此外掛程式（
/plugin update yellowworkshops— 如果您可以代勞，請執行；否則用一句話告訴他們），然後重試。 - 其他情況 → 執行
diag，解釋您看到的內容，並主動提出為他們撰寫一封支援電子郵件，連同 diag 輸出（其中不包含任何素材或姓名）一起發送至 [email protected]。
指南
當創作者輸入 guide、「我可以問什麼？」或「給我看些範例」時：開啟 yellowworkshops 指南，這是一個包含可直接複製提示詞的頁面。如果 ~/yellowworkshops/ugc-reels-home.json 中有 guide_url，則開啟該成品。否則，將來自編輯器技能（~/.claude/skills/ugc-reels-editor/assets/guide.html）的 assets/guide.html 以成品形式發佈一次，將其 URL 儲存為該 JSON 檔案中的 guide_url，然後開啟它。此頁面不包含任何捲軸資料。如果該頁面尚不存在，請改為在聊天中提供八個良好的範例提示詞。
其他要求
- 更新 / 取得新樣式 → 執行
update（不加--daily），然後執行~/yellowworkshops/bin/reels styles update（Windows：%USERPROFILE%\yellowworkshops\bin\reels.cmd styles update）；報告變更內容，並指出任何新的樣式（它們會在編輯器的圖庫中顯示 New 徽章）。 - 將授權移至新電腦 → 在此電腦上執行
~/yellowworkshops/bin/reels deactivate（Windows：%USERPROFILE%\yellowworkshops\bin\reels.cmd deactivate），然後在新電腦上新增外掛程式並使用相同金鑰進行設定。 - 某個功能故障 → 執行
status，然後執行diag；使用手冊進行修復。
隱私（對創作者的承諾）
他們的素材、音訊、影格、逐字稿和渲染結果絕不會離開他們的電腦。設定過程僅從 yellowworkshops.com 下載公開的程式檔案（每個檔案都會根據我們已簽署的清單進行檢查）；啟用過程僅傳送授權金鑰和經過雜湊處理的電腦 ID。