讀取 {{SKILL_ROOT}}/SKILL.md 以瞭解生產工作流程及其中的決策判斷。
使用 python "{{SKILL_ROOT}}/scripts/greybox.py" 作為通用命令前綴。
不需要 Node、MCP 或模型切換。此包裝器為選用性質：WorkBuddy 也可以直接讀取完整技能並直接執行其 CLI。請使用 setup 返回的命令前綴；它會記錄實際的 Python 與已驗證的套件識別。
對於長時間執行的美術案例，請使用 task-context pin 將實際記錄釘選到現有的 PLAN 中，並使用 task-context run 繼續；請閱讀 {{SKILL_ROOT}}/references/task-context.md。在交接或模型/工具變更後重新檢查。將不可用的模型/架構事實回報為未知。task-context inspect 可區分已安裝的副本與每個原始帳本的歷史/執行器復原路徑；絕不重新建立付費任務使其符合較新的執行器。
-
根據意圖、觀察到的狀態與請求的端點讀取當前任務。使用
intent route --file REQUEST --project PROJECT進行結構化請求路由。討論維持討論；灰盒請求預設使用灰盒端點；繼續使用原始任務記錄。針對灰盒工作執行host setup --host workbuddy --scope greybox --project PROJECT，或針對美術/圖像分支執行host setup --host workbuddy --scope art --project PROJECT --capability-report REPORT --session-id SESSION。Setup 會解析實際的原生專案根目錄並返回命令前綴。在可用時綁定當前的原生 ImageGen 調用證據；這樣就不需要 API 設定檔。僅工具探索是不夠的。圖像服務與不相關的工具並非灰盒的前置條件。 對於 Blender 場景工作，當需要 CLI 準備時，使用host setup --host workbuddy --scope spatial --engine blender --operation create|edit|review --project SOURCE_OR_WORKSPACE；可用的原生 bpy/CLI/MCP 操作隨後可遵循空間路由。Setup 僅為就緒檢查；應用探索不會檢查場景。純空間端點不需要遊戲專案或供應商。 -
對於 Godot/Unity 灰盒建立/修改，請閱讀
{{SKILL_ROOT}}/references/greybox-authoring.md並使用greybox init/build/play/validate/status/handoff；在請求的端點處停止。對於美術分支，如果缺少生成，請閱讀{{SKILL_ROOT}}/references/image-services.md並使用image configure設定使用者選擇的圖像服務。使用host configure --host workbuddy --image-profile NAME綁定其非機密名稱。 -
對於新的 S7 建模參考，請閱讀
{{SKILL_ROOT}}/references/modeling-references.md，記錄每個資產及其視圖一次，然後輸入boards workbuddy start --file REGISTRY --project PROJECT --workspace WORKSPACE。這會編譯頁面任務並註冊/安裝其範圍限定的 S7 守衛。執行其精確且無害的原生 Bash 探測，然後使用當前的原生工具架構執行boards workbuddy bind。消耗返回的任務；boards workbuddy claim會寫入精確的、可供呼叫的引數並保留現有的支出上限。一個已計劃的單一任務遵循相同的路徑，並且需要其計算出的或來源化的理由。記錄原始結果，然後透過boards production進行裁切/審查；一個壞的槽位不會抹除好的兄弟槽位，修正後的 ROI 會建立裁切嘗試而不會重新生成。新的對話會更新免費探測並保留原始待處理的呼叫。對於已選擇的圖像設定檔，透過現有已設定的服務帳本消耗精確準備好的頁面請求。不要降低品質要求或再次提交不確定的呼叫。 -
當活躍分支產生圖像時，透過當前主機的像素讀取工具開啟實際返回的本地圖像。使用主機支援的圖像 UI 呈現該檔案。CLI 成功並不代表具備這兩項能力。在會話能力報告中綁定精確的當前工具與證據。灰盒審查使用其原生捕捉的視圖，並且不需要圖像生成。
-
繼續當前路由與請求端點的命令。當
stop_at為greybox時，在灰盒交接後交付並停止；僅在請求時才進入美術。保留原始專案狀態與核准歷史。委派為選用；圖像/模型多任務並行使用{{SKILL_ROOT}}/references/execution-contract.md中描述的通用執行器。原生工具保持由代理驅動，除非驗證了實際的獨立橋接；API 工作者可以在模型連線停滯時繼續執行。
在 H3 之前，透過 scene-review --help 將已核准的概念與當前的全場景代理進行比較。在 H4，新的生產合約需要當前的特徵/視圖比較證據。閱讀 {{SKILL_ROOT}}/references/scene-comparison.md；使用觀察到的差距在擴展前修復環境、主要形體、光照與接觸。有效的證據覆蓋範圍絕不取代使用者的視覺接受度。
命令返回 JSON；失敗的命令返回非零代碼。對每個命令使用 --help 以取得精確的當前選項。將憑證保留在本地設定或設定的環境中，絕不留存在聊天、連接器檔案或可攜帶的專案記錄中。僅當所選服務需要服務憑證時才需要；連接器初始化不會登入提供者或建立付費任務。
僅當當前操作需要 Lux 時，執行 host setup --host workbuddy --scope runtime --runtime lux。它會準備/重用固定的私有執行環境，並且可以從失敗的 venv/ensurepip 探測中使用現有的相容直譯器進行復原。它不會查詢供應商或提交生成。在命令之間保留其返回的 Python 路徑。不會靜默地替換明確的 --python。