PixelLab Pip
首先分類使用者的資產、API 或問題意圖，然後選擇支援的 PixelLab 表面。當請求是問題時，直接回答問題。
工作流程
- 分類請求：
question | setup | create asset | edit/transform | animate | prompt_enhancement | integrate/code | check balance/status | troubleshoot docs/API | website/editor assistance。 在明確的技能調用之後，例如/pixellab-pip setup或@pixellab-pip setup，將單獨的setup視為設定意圖。如果應用程式有結構化參數，僅將其用作讀取相同自然語言意圖的另一種方式。 - 分類目標資產或表面：
general_image | background | character | object | effect_vfx | ui | whole_map | map_image | map_object | top_down_tileset | sidescroller_tileset | isometric_tile | tile_variants | animation | existing_image。 - 選擇表面：
使用 PixelLab MCP 管理編碼代理的資產，使用 REST v2 進行直接 API/程式碼/批次操作，僅將網站/Aseprite/Pixelorama 作為人類/編輯器表面，並僅為舊版相容性使用 REST v1。
對於設定意圖，閱讀
references/setup.md並執行設定精靈契約：首先推薦 MCP + API，支援純 MCP/純 API/手動模式，並且僅在無令牌預覽和明確批准後才更改設定。 - 僅在 PixelLab MCP 工具可用時使用 MCP，無論是裸調用還是帶前綴調用。如果 MCP 不可用，則路由到文檔中記錄的匹配 REST v2 端點。如果 MCP 和 REST v2 都不可用或失敗，請在使用任何非 PixelLab 的備用方案之前解釋原因。
如果工具帶有前綴，例如
mcp__pixellab__create_character，則透過後綴匹配。 - 當缺少或不清楚所需的工具/端點/欄位時，或者當身份驗證、SDK 支援、定價、模型/模式可用性或最新的 MCP 工具很重要時，刷新當前事實。
- 對於需要一致性的工作，總結使用者的身份、風格、調色板、視圖和參考錨點。在進行耗用積分的調用之前，最多問三個阻擋性問題。
- 對於 PixelLab 自然語言請求參數，例如
description、action、*_description、item_descriptions、text或color_palette，除非使用者選擇退出，否則將模糊的用戶用語改進為端點就緒的英文參數值。僅在適合所選路由時才使用文檔化的 PixelLab 增強端點；否則直接從請求和可見輸入中進行增強。對於非英文或多語言請求，請閱讀references/localization.md。 - 在即時生成之前，確認 PixelLab Bearer Token 已配置，而無需要求使用者將其粘貼到聊天中。
- 執行操作或回答問題。僅在已知衝突情況下提出簡短澄清。
表面規則
| 表面 | 使用時機 | 避免使用時機 |
|---|---|---|
| 託管 MCP | 需要具有 ID、輪詢、下載、清單/獲取/刪除輔助功能以及專案/沙箱/代理輔助功能的託管 PixelLab 資產的工作流程。 | MCP 未公開的原始影像/編輯/UI 原語，或當 PixelLab MCP 工具不可用時的任何 MCP 調用。 |
| REST v2 | 腳本、批次作業、伺服器整合、精確端點控制、通用影像、背景、UI、修補/編輯、提示增強、原始動畫、旋轉、調整大小、移除背景和 API 一致性檢查。 | 在未檢查已安裝的 SDK 或當前文檔的情況下猜測 SDK 方法。 |
| 網站 / 地圖工作坊 | 人類產品表面、完整地圖手動工作、豐富的庫、可見的瀏覽器協助以及僅限網站的工作流程。 | 對複製的瀏覽器會話令牌或未記錄的根端點進行程式化使用。 |
| Aseprite | 當用戶正在 Aseprite 內部積極工作時，用於本地編輯器插件工作流程。 | 將本地插件路徑視為公開的 REST/MCP 合約。 |
| Pixelorama / 編輯器 | 對網站編輯器工作流程進行可見的瀏覽器協助，包括現有資產、保存回傳流程以及獲得明確權限後的僅限網站手動流程。 | 隱藏自動化、未記錄的端點調用、公共 API 假設或任何未經二次確認的生成/保存/下載/編輯/刪除操作。 |
| REST v1 | 現有舊版程式碼和舊版 SDK 相容性。 | 除非使用者明確需要 v1，否則不要用於新工作。 |
託管 MCP 工具名稱不是 REST 端點。不要將 MCP 工具名稱作為 /v2/... 路徑進行 curl 操作。
意圖路由器
| 使用者意圖 | 表面規則後的預設路由 | 需要編碼/精確控制時的 REST v2 路由 |
|---|---|---|
| 角色、玩家、NPC、敵人、生物 | MCP create_character，然後 create_character_state、animate_character、get_character、清單/刪除輔助功能，以及明確請求時的 delete_animation。對於現有多方向角色的後續動畫，當使用者未指定方向時，預設使用南/下方向作為第一個候選；在動畫所有方向之前提問或獲得確認。 | 角色端點，例如 create-character-v3、create-character-with-4-directions、create-character-with-8-directions、create-character-pro、狀態、動畫、標籤、ZIP/清單/獲取/刪除端點。 |
| 物件、道具、物品、拾取物、武器、家具 | MCP create_1_direction_object、create_8_direction_object、create_map_object、物件狀態/動畫/審查/標籤工具。 | 物件端點，例如 create-1-direction-object、create-8-direction-object、map-objects、物件狀態/動畫/標籤/清單/獲取/刪除端點。 |
| 俯視地形圖塊集、Wang/自動圖塊/RPG 圖塊集 | MCP create_topdown_tileset。 | create-tileset、tilesets。 |
| 橫向卷軸/平台遊戲圖塊集 | MCP create_sidescroller_tileset。 | create-tileset-sidescroller、橫向卷軸圖塊集端點。 |
| 等距圖塊/方塊/地板 | MCP create_isometric_tile。 | create-isometric-tile。 |
| 圖塊變體 / 專業圖塊 | MCP create_tiles_pro 用於單個圖塊變體，例如六邊形、八邊形、方形俯視和等距圖塊。 | create-tiles-pro、tiles-pro/{tile_id}。 |
| 通用影像、精靈、圖標式獨立資產 | REST v2。 | create-image-pixen、generate-image-v2、create-image-pixflux、create-image-bitforge、generate-with-style-v2。 |
| 背景、場景、環境、背景幕 | REST v2 影像生成；未記錄直接託管的 MCP 背景工具。 | 使用帶有場景/背景提示的正常影像生成。不要假設 create-image-pixflux-background 是場景背景生成器而不檢查當前文檔。 |
| UI、HUD、按鈕、面板、血量條、選單 | REST v2。 | generate-ui-v2。除非存在公開的生命週期端點，否則網站 UI 庫是人類/編輯器表面。 |
| 影像編輯、修補、遮罩、轉換、調整大小、移除背景 | REST v2。 | inpaint、inpaint-v3、edit-image、edit-images-v2、image-to-pixelart、image-to-pixelart-pro、resize、remove-background。 |
| 減少顏色 / 量化調色板 | 網站/編輯器/本地影像工具。 | 未記錄公開的 REST v2/MCP 減少顏色端點；使用網站文檔或本地工具，而不是發明路由。 |
| 取消縮放像素藝術 / 移除放大 | Aseprite 或 Pixelorama 擴充。 | 網站文檔將其列為僅編輯器擴充；除非官方文檔添加端點，否則不要路由到 REST/MCP。 |
| 試穿服裝/物品於角色上 | 網站「試穿」用於單張圖像實驗性輸出；僅動畫幀服裝轉移使用 REST transfer-outfit-v2。 | 「試穿」返回合成影像，而不是孤立的紙娃娃圖層。 |
| 多圖像組合參考 | 網站實驗性流程或在驗證文檔後最接近的文檔化 REST 影像/編輯路由。 | 未記錄直接公開的 REST v2/MCP「多影像」路由。 |
| 重塑角色比例 | 網站「重塑」或在驗證文檔後最接近的文檔化編輯/角色路由。 | 網站文檔要求正好 64x64 畫布；未記錄公開的 REST v2/MCP 重塑端點。 |
| 提示增強、改善生成提示 | 對於不匹配的路由，預設使用代理端重寫；僅在文檔化的匹配增強端點時使用 REST v2。 | enhance-pixen-prompt、enhance-character-v3-prompt 或 enhance-animation-v3-prompt。除非使用者明確要求，否則不要將不匹配的增強端點用作通用優化器。 |
| 原始動畫、骨架、插值、服裝轉移、旋轉 | REST v2，除非是動畫一個託管的 MCP 角色/物件。 | animate-with-text*、animate-with-skeleton、estimate-skeleton、edit-animation-v2、interpolation-v2、transfer-outfit-v2、rotate、generate-8-rotations-v2/v3。 |
| 地圖影像、生成的關卡影像、視覺地圖概念 | REST v2 影像/背景路由；網站用於地圖擴展/紋理工作流程。 | 未記錄完整的公開 REST/MCP 地圖 CRUD、地圖擴展或地圖紋理表面。 |
| 地圖物件 | 預設使用 MCP create_map_object 加上 get_map_object。 | POST /map-objects；MCP 地圖物件在 8 小時後自動刪除。在編寫程式碼之前，請從 OpenAPI 驗證當前的 REST 結果和輪詢行為。 |
| 完整地圖、地圖工作坊、地圖 CRUD/匯出 | 手動使用網站，或使用 MCP/REST 生成元件。 | 在研究過程中未記錄完整的公開 REST/MCP 地圖 CRUD 表面。 |
| 靜態效果或 VFX 精靈 | REST v2 影像/編輯路由。當提供了目標精靈/影像且使用者要求添加、繪製、疊加或應用效果/拖尾/光環/衝擊時，將提供的影像視為編輯目標並使用 REST 影像編輯。僅當使用者要求一個單獨的可重用效果資產/圖層或未提供目標影像時，才使用物件/影像生成。 | 未記錄單獨的公開 VFX 端點。PixelLab 編輯路由返回一個完整的編輯後影像，而不是一個孤立的效果圖層。 |
| 動畫效果或 VFX | REST v2 原始動畫或 MCP 物件動畫（如果它應成為託管物件）。 | animate-with-text-v3、animate-with-skeleton 或物件動畫端點；將 VFX 視為描述，而不是單獨的端點。 |
| 餘額、積分、帳戶檢查 | 如果可用，使用 MCP get_balance。 | GET /balance。 |
| REST 非同步作業狀態 | REST v2。 | GET /background-jobs/{job_id}。MCP 託管資產改用資源特定的 get_* 工具。 |
| PixelLab 專案、沙箱、部署的代理工作流程、聊天、MCP 幫助/回饋 | 如果可用，使用 MCP list_projects、sandbox_*、chat_*、agent_help、agent_feedback、agent_list、agent_inspect 和 agent_talk 工具。 | 未記錄公開的 REST v2 等效項。 |
僅針對衝突情況進行澄清
- 「圖塊」：詢問使用者是想要一個地形/自動圖塊圖塊集、平台遊戲/橫向卷軸圖塊集，還是單個圖塊變體。
- 「地圖」：詢問他們是想要完整地圖、地圖物件、地圖影像、圖塊集、等距圖塊還是圖塊變體。
- 「物件/角色」：對於人物、NPC、生物、身體模板或身份/狀態動畫，推斷為角色；對於道具/物品/家具/武器，推斷為物件。僅在不確定時提問。
- 「角色動畫方向」：如果使用者要求為現有的多方向角色添加動畫，且未指定方向，則預設使用
south/下方向作為一個預覽候選。不要預設動畫西北、對角線或所有方向。僅在south方向不可用、資產方向未知或使用者需要不同的遊戲朝向方向時，才詢問使用哪個方向。僅在使用者明確要求全部/8 個方向、完整的方向集或批准了更大的批次時，才動畫所有方向。 - 「效果」：當不明確時，詢問是靜態精靈還是動畫效果。如果提供了目標精靈/影像，並且使用者要求對其添加效果，則推斷為一次性影像編輯。僅在沒有明確的編輯目標或使用者要求一個單獨的資產時，才詢問是可重用物件/圖層還是一次性精靈。
- 「等距圖塊集」：詢問他們是需要一個等距圖塊還是完整的圖塊集，因為公開文檔只公開了一個等距圖塊路由。
- 「紙娃娃」：收集基礎、圖層、方向、動畫以及孤立輸出與合成輸出；請參閱
references/paperdolling.md。 - 提供的影像是可選的，除非所選路由需要影像欄位。當提供影像時，從請求中推斷每個文件的端點特定角色；僅在一個檔案可能合理地被視為身份、風格、概念、編輯目標、遮罩、調色板、初始化/來源、第一幀或最後一幀時提問。
- 如果提示增強添加了從影像或用戶簡寫中推斷出的材料細節，請顯示提議的描述，並在進行耗用積分的生成或編輯之前獲得確認。
僅閱讀相關參考：
- Bearer Token 設定、PixelLab UI 命名和 MCP 身份驗證重用：
references/credentials.md。 - 安裝後 MCP/API/身份驗證的自然語言設定模式：
references/setup.md。 - 瀏覽器備用方案和網站自動化邊界：
references/browser-fallback.md。 - 紙娃娃和分層角色工作流程：
references/paperdolling.md。 - 圖塊集和圖塊變體詳細資訊：
references/tilesets.md。 - 附件、檔案路徑、提供的影像角色、端點欄位或固定尺寸影像轉像素藝術：
references/image-inputs.md。 - 非英文或多語言使用者請求和回應語言處理：
references/localization.md。 - 官方 PixelLab 文檔、MCP 文檔、REST 文檔和網頁重新整理路由：
references/official-docs.md。 - 使用量、餘額、作業和結果報告：
references/usage-reporting.md。 - 由生成幀組合的本地動畫預覽 GIF、精靈表或 ImageMagick/
magick：references/local-asset-assembly.md。
可選的更廣泛文檔：在完整的插件/存儲庫安裝中，這些路徑是相對於此 SKILL.md 解析的；純技能安裝可能省略它們。如果執行時 references/ 不夠用，最多讀取一個匹配的檔案（如果存在）。如果不存在，則繼續使用 references/official-docs.md 和當前的官方 PixelLab 文檔；不要搜索或加載整個集合。
- 表面邊界和服務選擇：
../../docs/pixellab/surfaces-and-services.md。 - 淺顯語言資產路由：
../../docs/pixellab/asset-routing.md。 - 產品/模型/模式術語：
../../docs/pixellab/terminology.md。 - S
…
[為翻譯而截斷]