nodeclaw-image-gen 是做什麼的？
利用現有的文字模型來理解需求、選擇樣式與技術，並呼叫隨附的 Node CLI。確定性的準備、驗證和圖片處理屬於工具的功能，而非模型自訂的腳本。不需要額外的 LLM 服務、常駐程式或儲存上傳器。將實際的 API 結果儲存在本地；不要將它們重新上傳到 Telegram、儲存空間或 CDN。
開始
將 <skill-root> 解析為包含此已載入 SKILL.md 檔案的絕對目錄；切勿從工作目錄猜測。在使用者的工作區中執行 node "<skill-root>/scripts/image-gen.mjs" ...，以便相對輸出會放置在工作區中。
- 檢查 Node.js 22+ 和 CLI
--help，然後執行setup --status --json來檢查本地憑證就緒狀態，但不要進行 API 呼叫。不要列印設定檔、不要在每次使用時重寫設定，也不要要求使用者重複已儲存的位址/模型選擇。 - 預設值：NodeClaw、
gpt-image-2、Task-first、一張圖片、./generated-images/。如果是外掛安裝，請使用/plugin configure nodeclaw-image-gen@nodeclaw-image-gen；待處理的變更會透過同一工作階段中的/reload-plugins載入，而非重新啟動。不要聲稱此技能可以自行開啟或執行這些原生命令。隨附的原生模組會在載入/重新載入時將位址/金鑰作為一次性的短暫繫結傳遞；CLI 會驗證它，並忽略舊的啟動匯出。重新載入後，請連同setup --status --json一起檢查有效的apiBaseUrl、endpointMode和credentialConfigured。僅憑憑證就緒狀態並不能證明最新的設定或 API 已接受；status:not_configured可能表示沒有獨立的設定檔。如果位址仍然過時或原生應用程式被封鎖，請報告確切的載入/設定封鎖原因，不要列印環境變數值、讀取金鑰儲存庫、重新輸入已儲存的金鑰、重試未變更的重新載入或呼叫 API。使用者選擇的獨立安裝在其本機終端機中使用node "<skill-root>/scripts/image-gen.mjs" setup --interactive；它會要求輸入基礎位址並隱藏金鑰，並提供明確的--replace參數來覆寫現有設定。切勿在聊天、AskUserQuestion、規格、工具命令引數或 OAuth/權杖/工作階段儲存庫中收集金鑰。不要在捕獲的 AI 工具工作階段中執行互動式金鑰提示。直接安裝程式/設定金鑰引數僅供人類操作的自動化使用，而非模型進行祕密收集。 - 重複使用提供的模型/路徑/規格選擇。
models --json會合併有序的探索結果；當沒有目錄時，仍允許使用精確的手動模型，但其功能會明確標示為未驗證。安裝/設定位址和金鑰會固定該端點；傳統自動模式在回退到已設定的/原生端點之前，仍會嘗試公開的主動式 harness。不要將儲存的金鑰移動到另一個位址或代理前綴。
生成或編輯
「生成」會建立新的圖片；「編輯」則使用經過明確批准的原始圖片/遮罩。僅存在於工作區中的檔案並不代表有權限傳送它們。
node "<skill-root>/scripts/image-gen.mjs" generate --prompt "A quiet riverside town at sunrise" --dry-run --json
node "<skill-root>/scripts/image-gen.mjs" generate --prompt "A quiet riverside town at sunrise" --yes --json
編輯使用 edit --prompt TEXT --image FILE [--mask FILE]。對於較長的提示，請使用經過批准的私人 --spec FILE；規格檔案不是診斷日誌，也絕不能包含 API 金鑰。CLI 會將 Task/OpenAI 路由附加到已儲存的基礎位址。原生 /v1beta/models/{model}:generateContent 需要使用明確的 --api-mode gemini：它是僅限 Direct 的原生 contents/parts，不能由 Google 模型名稱或 Images 相容性金鑰推斷。現有的 google_image_generate_content Images/Task 執行會維持在目前的路由上。Gemini 原生傳輸並不能證明 Direct Image 計費或就緒狀態。CLI 的 help 會列出實際選項。
在進行付費呼叫之前，請根據 dry-run 的結果總結操作/模型/樣式/規格/端點/方法/回退/輸出。使用 一種原生形式：如所示生成 / 調整 / 探索樣式 / 取消。僅合併真正遺漏的問題；不要詢問每一個欄位。批准後使用 --yes；僅確認重大的數量/端點/順序變更。
Claude Code 在可用時使用 AskUserQuestion；Codex 僅在實際上暴露時使用 request_user_input。不要用編號文字冒充原生選擇，或切換模式來發明工具。使用者選擇的非互動式自動化可以使用提供的設定/規格加上 --yes。Grok Bot 的導入/原生形式整合未經驗證；雲端路徑不是桌面檔案。
樣式和技術工具
styles list|show ID選擇外觀；techniques list|show ID選擇一個工作流程及其隨附的工具。可以自由組合，無需樣式→技術允許清單或另一個協調器服務。- 建議 2–3 個相關樣式，加上「原始提示 / 無預設」。使用
styles show ID --json讀取所選的預設；exampleImages[]是可選的第三方預覽 URL，不是已批准的 API 圖片輸入。不要自動擷取、上傳或將它們用作編輯參考。58 個捆綁預設包括 55 個額外導入的樣式；references/style-imports/中的原始集合僅作為來源出處，絕非另一個有效的樣式來源。GIF 名稱不表示支援動畫。只使用當前請求所批准的主題/上下文，不要使用不相關的私人記憶體。僅在透過可用的 harness 工具請求時才進行搜尋；不要將整個私人提示傳送給搜尋引擎。 - 僅讀取所選的工作流程，檢查要求，並 使用其隨附的
techniques prepare/check/merge工具。不要要求較弱的模型重新實作裁剪/調整大小/遮罩/顏色/合併邏輯。首先在本地準備，然後顯示實際的付費請求數量和順序以供批准。本地準備工作絕不代表已授權進行推理。 - 像素藝術細化：準備對齊的最近鄰插值拼貼和編輯規格，透過現有客戶端提交已批准的編輯，檢查並合併為高解析度/原始尺寸的 PNG。保留構圖：準備一個受限的編輯規格並檢查結果。兩者都內建 PNG 編解碼器；無需安裝 Python/ImageMagick。
- 缺少 helper/最低客戶端要求時，需要進行已批准的全技能更新或在付費呼叫之前停止該技術。不要用僅限上下文的聲明、執行下載的程式碼、承諾無縫體驗或啟動付費重繪循環來取代它。
styles|techniques sync預覽官方 GitHub JSON/Markdown；--yes會套用。自訂命名空間是分開的。可執行 helper 的變更需要經過驗證的完整技能更新；遠端內容永遠不會變更驗證/端點/權限或授予執行批准。預設不會授權揭露私人記憶體。
結果與復原
使用回傳的 JSON 狀態和路徑。saved 表示所有預期檔案均已儲存。pending/outcome_unknown 會保留控制代碼，並使用 resume --handle FILE，絕對不會建立另一個請求。save_failed 會保留成功儲存的檔案並重試相同的結果。直接未知的結果沒有啟用的復原機制。技術 incomplete/partial 的結束碼為 3；部分輸出未經完全細化。
停止客戶端不會取消遠端 Task。不要切換方法/模型/端點來繞過不確定性、驗證或政策；請參閱 API 合約。僅在實際可用時才使用 vision 功能；檔案檢查不能證明視覺品質。沒有自動的付費細化。
對於安裝請求，請在呼叫其安裝程式之前取得並驗證所選的 GitHub 套件；不要假設原始檔案已存在於本地。優先使用文件記錄的 AI 自動安裝流程或所選的原生外掛管理員，絕不要重複安裝。獨立安裝完成後，將其回傳的 commands.configure argv 轉換為使用實際安裝路徑的正確引號命令，供使用者在本地執行；同時也回傳重新設定/狀態/更新命令。外掛使用其原生的敏感設定表單；其 Git 支援的 marketplace 會獨立於獨立發行版本資產來選擇儲存庫版本。人類在終端機中執行的 claude plugin install --config 可能會提供聲明的位址/金鑰值，但絕不能收集真實的金鑰或將其放入 AI 工具引數中。在使用者完成設定且本地 setup --status --json 回報就緒之前，不要將憑證設定標記為完成；這僅是本地就緒狀態，並非 API 已接受。如果所需的獨立發行版本或相符的 marketplace 版本不可用，請以此封鎖原因停止，而不是憑空發明已安裝的功能。
docs fetch|sync 是選用的公開參考，不是執行階段合約更新。獨立 update check|apply 永遠不會寫入外掛管理的快取；那些應使用原生外掛管理員。安裝/取代/發佈需要各自的授權，不能從圖片請求推斷出權限。使用者互動遵循使用者的語言；此技能的基礎指導語言為英文。