IP Studio
把零散身份線索或已有角色圖變成可跨對話復用的風格化角色，再用同一身份製作社交主頁、文章傳播視覺和 Codex v2 桌寵。角色創建預設交付正式主參考圖、完整角色檔案和說明；衍生視覺預設交付經過角色一致性與內容檢查的最終圖片及可追溯記錄；桌寵預設交付九組狀態動畫、十六個注視方向、完整 QA 證據和可直接安裝的寵物目錄。使用者只做會改變身份、傳播方向或既有安裝的選擇，結構補全、內容提煉、生圖、審圖、重試、儲存、拼裝和校驗由 Agent 完成。
第一判斷
先按使用者要得到的獨立結果選擇主路徑：
- 建立或修改角色身份：從零創建、導入現有形象，或修改已鎖定角色，進入「角色身份主路徑」。
- 製作角色衍生視覺：頭像、主頁橫幅、資料卡、文章封面、說明圖或正文插圖，進入「衍生視覺主路徑」。角色身份已有鎖定包時直接消費；只有已核准圖片時先自動導入並鎖定角色；還沒有角色時先完成角色身份主路徑，再返回當前衍生請求。
- 製作 Codex 桌寵：把已鎖定角色製作、檢查、打包或安裝成 Codex v2 桌寵，進入「Codex 桌寵主路徑」。已有角色包時直接消費；只有已核准圖片時先自動導入並鎖定角色；還沒有角色時先完成角色身份主路徑，再返回桌寵請求。
一個請求同時要求角色、衍生圖或桌寵時，先鎖定角色，再分別完成每個結果；桌寵只能在當前角色版本鎖定後開始。普通個人品牌策劃、沒有 IP 角色參與的一般封面、說明圖和插圖、照片級數位分身、Codex 桌寵以外的一般動畫、Live2D、影片、Windows 獨立桌寵和其它桌寵平台停在這裡，直接說明相鄰能力邊界。使用者只點名 $ip-studio 時，按從零創建處理。
資訊與動作邊界
按以下順序使用資訊：
- 當前請求和使用者明確表達的選擇；
- 當前對話中已經出現的身份、用途和審美線索；
- 使用者提供或明確指向的圖片、文件、連結與角色資料夾。
角色材料足以決定用途、受眾、角色形態、希望留下的印象和最終風格時直接繼續。缺少會改變角色方向的資訊時，把可行解整理成三張完整方向卡，讓使用者選擇或組合，不發放問卷。使用者明確把選擇交給 Agent 時，採用最符合用途的一張並說明選擇。
衍生視覺先讀取當前內容、使用者指定的角色包及主參考圖，再讀取使用者提供的 logo、介面、數據或視覺資料。只有事實、名稱、品牌方向或核心敘事無法從材料確定，而且不同答案會改變最終圖片時，才把一個具體取捨交給使用者。平台裁切和安全區需要當前規格且使用者沒有提供截圖或尺寸時，查詢該平台官方資料。
桌寵路徑先讀取當前角色檔案和主參考圖，再讀取使用者明確提供的其它形象參考。角色名、桌寵名、風格和動作氣質能從角色包穩定推斷時直接繼續；只有一個固定特徵無法同時保持身份與 192×208 桌寵幾何時，才把這一個取捨交給使用者。除非使用者明確要求為一個只有品牌名、沒有角色方向的請求補充公開品牌線索，否則不主動聯網研究品牌。
調用本 Skill 已授權在當前任務中查看使用者提供的圖片、使用已有生圖與看圖能力，並在可寫工作區創建角色包、衍生視覺和桌寵執行目錄。使用者要求「製作可用的 Codex 桌寵」時，寫入本機 Codex 寵物目錄屬於該結果的最後一步；同一寵物標識已經被不同內容佔用時，先儲存現有目錄並請求一次替換決定。其它安裝、上傳、發送和發布僅在使用者另行要求時進行。本流程不刪除既有角色版本、正式衍生圖、桌寵執行記錄或已儲存的舊安裝。
回覆語言跟隨使用者。內部檔案使用固定英文鍵名，使用者不需要閱讀或編輯這些鍵名。
角色身份主路徑
先區分從零創建、導入現有形象和修改已鎖定角色。導入時區分使用者有意保留的特徵與當前圖片的偶然細節；修改時讀取 character-profile.json 及其中登記的單張主參考圖，改變固定特徵則生成新版本。
進入本路徑後讀取 references/character-system.md。它負責角色方向、Q 版診斷、生圖輸入、視覺檢查、配色與複雜部件處理；完成每個專業動作後回到本節對應步驟。
1. 建立待確認檔案
執行 python scripts/character_kit.py schema 讀取當前檔案合約。需要文件草稿時執行：
python scripts/character_kit.py draft <draft-profile-path> --character-id <slug> --display-name <name> --language <language>
先把已知資訊寫入草稿。Q 版方向尚未確定時，允許未選欄位暫時為空；正式生圖前必須根據使用者選擇或已認可圖片補齊完整重建檔案。檔案分別記錄形體與比例、頭臉各部位、軀幹與四肢、尾巴或翅膀等附肢、每種顏色的準確落點與面積關係、紋樣邊界、材質區域、服裝層級與連接、標誌物的幾何和安裝方式、正側背結構、繪製方式和一致性邊界。
Agent 主動決定不會改變角色方向的側面、背面、接縫和材質細節，並在 provenance.decisions 標記為 agent_inferred。會改變輪廓、臉部、主配色、標誌物或角色含義的分歧才交給使用者。正式生圖前執行：
python scripts/character_kit.py prompt <draft-profile-path> --purpose master
該命令先驗證檔案是否完整，再從檔案生成完整身份提示詞。後續生圖使用命令輸出的 prompt；不另寫一份身份描述。姿勢、動作、場景、畫幅和鏡頭只透過當次命令的 --task 傳入。
2. 用 Q 版診斷設計
從同一份待確認檔案獨立生成三張診斷稿。每張都是單角色、線條清楚、細節克制、約 3.5 頭身、正面中性姿態和乾淨背景；三張應在輪廓、角色形態或核心象徵上形成真實差異，而不只是換色。
生成後逐張查看。診斷稿應讓主輪廓和一項主要記憶點在縮圖中仍然成立，且沒有缺失肢體、結構斷裂、無關文字或設計堆積。此時檔案仍是暫定設計：只有技術錯誤或違反使用者已經確認的特徵才自動淘汰；結構成立、識別清楚但改變了尚未確認細節的圖片保留為新分支，並向使用者說明變化。某張確實失敗時從原檔案替換一次，不從失敗圖片繼續編輯。把通過檢查的三張圖連同簡短差異交給使用者選擇或組合。
已有形象已經獲使用者認可且使用者只要建立檔案時跳過本步驟。修改已鎖定角色時，只有輪廓、臉部、核心配色或標誌物重新設計才回到本步驟。
3. 生成正式主參考圖
把使用者選擇寫回待確認檔案，逐項補全 reference 規定的結構，再用腳本生成正式候選的完整提示詞。通過標準是：另一個 Agent 不需要猜測身份關鍵細節，就能從檔案畫出同一個角色的正面、側面和背面。Q 版只提供本次選擇證據，不進入角色包，也不成為後續生圖參考。
正式主參考圖應是單角色、全身、正面或輕微三分之四視角、中性姿態、乾淨背景，無文字、標籤和拼圖；固定特徵都能直接看見。先比較檔案與圖片，再比較技術完整性。明顯生成錯誤自動修正，正式階段最多修正兩次。
基礎配色、輪廓、臉部或標誌物改變時，從當前檔案建立新分支並重畫。只有渲染瑕疵可以局部修復；修復後重新檢查全部固定特徵。同一複雜部件連續兩次不正確時，按 reference 中的部件分支先確定它的幾何、比例、材質、連接、各視角可見性和運動方式，將獲確認的結構寫回檔案，再由腳本重新生成完整提示詞和整張角色圖。
向使用者展示通過檢查的正式候選並請求最終核准。使用者已經在當前請求中明確授權 Agent 代為定稿時，Agent 可選擇最符合檔案的一張。
4. 驗證可復用性
最終稿獲批後，先核對圖中實際成立的結構與檔案：使用者已核准的設計變化寫回對應欄位，偶然生成細節不反向覆蓋已確認設定。然後執行：
python scripts/character_kit.py prompt <draft-profile-path> --purpose consistency --reference <approved-master-image> --task <different-pose-expression-and-simple-background>
把命令輸出的 prompt 和 master_reference 一起交給生圖能力，生成一張不同姿勢、不同表情、簡單背景的一致性測試圖。測試圖必須保留形體、臉部、顏色落點、服裝連接、材質和標誌物；它只用於本次檢查，不寫進角色包，也不作為後續參考。
測試不通過時先判斷是檔案描述缺失還是主參考圖不穩定，再更新對應生產者並重試；最多修正兩次。仍需放棄一個已核准特徵時，把這個取捨交給使用者決定。
5. 無損鎖定角色包
角色通過一致性檢查後，在當前可寫工作區使用 ip-studio-output/<character-slug>/。將待確認檔案和正式主圖交給腳本：
python scripts/character_kit.py finalize <kit-folder> --profile <draft-profile-path> --master <master-image-path>
python scripts/character_kit.py check <kit-folder>
finalize 在寫入前驗證檔案和圖片；已有角色會遞增版本，把舊檔案與說明儲存進 history/rNNN/，並保留舊主圖。命令失敗時讀取錯誤、修正生產輸入後重試，不手寫腳本本應生成的版本號、校驗值或說明文件。
腳本成功後重新讀取 character-profile.json 和 character-guide.md，實際打開 assets.master_reference 指向的圖片，並執行一次 python scripts/character_kit.py prompt <kit-folder> --purpose scene --task <simple-reuse-task> 確認下游能夠讀取當前檔案與主圖。只有檔案、說明、圖片和派生提示詞一致且 check 通過，才算角色已經鎖定。
衍生視覺主路徑
本路徑只消費已經鎖定的角色身份。讀取 references/visual-production.md，它負責頭像、主頁橫幅、資料卡、文章封面、說明圖和正文插圖的簡報、構圖、生圖、檢查與歸檔；完成每個專業動作後回到本節。
1. 確定本次結果
把請求拆成一個或多個明確結果：
avatar：同時適應圓形與方形裁切的1:1頭像；使用者說「頭像套圖」時分別生成簡化徽章版與豐富肖像版。profile-banner：未指定平台時使用3:1通用主頁橫幅；指定平台時按實際裁切與遮擋區構圖。profile-card：預設4:5手機端資料卡。cover：固定5:2文章封面。explainer：按內容在4:5、3:4或16:9中選擇說明圖比例。article-illustration：固定16:9正文插圖。
使用者說「主頁套圖」時預設生成頭像與主頁橫幅，明確要求資料卡時再加入資料卡。每個結果分別建立簡報、生成、檢查和歸檔，共享同一角色版本；一個結果不借用另一個結果的候選圖繼續衍生。
2. 建立視覺簡報
先執行 python scripts/visual_kit.py schema，再由 Agent 創建並填寫草稿：
python scripts/visual_kit.py draft <brief-path> --kind <kind> --visual-id <slug> --language <language>
根據內容真源確定核心對象、理解缺口、機制或變化、看後結論、品牌角色、唯一主要結構、角色動作、標題、標籤和配色。封面、說明圖和正文插圖按 references/visual-production.md 的當前合約執行。
角色必須在內容視覺中承擔因果動作：親自接收、移動、連接、拆分、選擇、阻擋、轉換或承受核心對象，並產生可見結果。頭像以縮圖識別為目標；主頁橫幅和資料卡讓角色與核心符號發生真實互動。使用者不需要查看或編輯簡報。
3. 生成並自動檢查
執行：
python scripts/visual_kit.py prompt <kit-folder> --brief <brief-path>
把命令輸出的 prompt 和按序排列的 image_references 一起交給生圖能力。它們分別來自當前角色檔案、單張主參考圖、視覺簡報和使用者提供的其它圖片，不另寫第二份角色身份或內容提示詞。
生成後實際打開圖片，按 reference 的順序檢查角色一致性、內容事實、角色動作的因果作用、唯一資訊結構、手機端層級、文字與 logo 可辨認性和技術完整性。失敗時修正最早出錯的簡報判斷，再從原始角色檔案與內容資料重畫；每張正式結果最多自動修正兩次。仍需改變事實、敘事重點或角色固定特徵時，只把這一項取捨交給使用者。
4. 歸檔最終圖片
使用者核准或已授權 Agent 代為定稿後執行：
python scripts/visual_kit.py finalize <kit-folder> --brief <brief-path> --image <approved-image>
python scripts/visual_kit.py check <visual-folder> --kit <kit-folder>
正式結果寫入 <kit-folder>/derivatives/<kind>/<visual-id>/。其中儲存最終圖片、視覺簡報、當次角色檔案快照、完整生圖輸入、輸入資料副本和校驗記錄；當前角色檔案、主參考圖和歷史版本保持不變。候選圖、自動重試圖和一致性檢查材料只留在任務臨時目錄。
腳本成功後重新讀取 visual-record.json，實際打開其中登記的最終圖片，並確認角色版本、主參考圖、視覺簡報、生圖輸入和最終圖片的校驗值均可讀取。滿足當前請求後停止，不自動擴展成其它比例、表情包或媒體。
Codex 桌寵主路徑
本路徑只消費已經鎖定的角色身份。進入後讀取 references/pet-production.md；它負責 Codex v2 精靈表合約、九組狀態、十六個方向、逐行生圖、確定性拼裝、盲審、動態預覽、成品目錄和安裝。角色身份、升版和其它衍生視覺仍由各自主路徑負責。
開始時建立四步可見進度，並在真實檔案或決定存在後才推進：
- 準備角色和桌寵執行目錄。
- 生成桌寵尺寸下的主形象。
- 生成並檢查全部動作與注視方向。
- 拼裝、驗證並安裝桌寵。
1. 建立與角色包相連的執行目錄
先調用工作區依賴載入器，把它返回的 Python 絕對路徑用於本路徑的每條命令。執行：
"<workspace-python>" -B scripts/pet_kit.py schema
"<workspace-python>" -B scripts/pet_kit.py prepare <kit-folder>
"<workspace-python>" -B scripts/pet_kit.py check <run-folder> --stage prepared
prepare 從當前 character-profile.json 生成桌寵尺寸下的完整身份描述，複製角色檔案、說明和單張主參考圖的可校驗快照，並生成基礎圖、九組動作、四向錨點和兩條方向行的正式任務。預設在 <kit-folder>/derivatives/codex-pet/<pet-id>/runs/rNNN/ 建立新執行，不覆蓋舊執行。尾巴燈籠等獨立配件繼續保持獨立與可擺動，同時讓固定點、箍環、吊帶、圓環和配件之間的受力路徑在 192×208 中連續可見。
2. 生成桌寵主形象和標準動作
生圖前完整載入當前環境的 $imagegen Skill。執行 pet_kit.py ready <run-folder>，只處理返回的 ready_jobs。每個任務讀取 imagegen-jobs.json 登記的提示詞和全部圖片輸入；基礎圖可以只由角色包開始，其它行必須附帶角色主參考圖、桌寵主形象和對應佈局參考。
選定結果後實際打開圖片，再執行：
"<workspace-python>" -B scripts/pet_kit.py accept-job <run-folder> --job <job-id> --source <image> --qa-note <visible-evidence>
該命令把通過的結果寫入正式位置、執行該階段的確定性檢查並更新依賴。基礎圖通過後生成 idle、左右移動、招手、跳躍、失敗、等待、任務執行和檢查結果九組動畫；每組使用 reference 規定的幀數和應用語義。彼此獨立的動作行可在環境允許時最多並行生成三個，使用者不需要排程任務。
左右翻轉不改變臉紋、光向、單側配件和標誌物含義時，running-left 可用 reference 指定的逐格鏡像腳本從已核准的 running-right 得到；其它狀態分別生成。九組動作通過後，按 reference 生成 8×9 中間精靈表、總覽圖和九個 GIF，實際看圖檢查身份、狀態、方向、循環、尺度和連接。
3. 生成十六個注視方向
Agent 根據角色頭臉、眼睛、身體、附肢和配件的真實構造寫入 qa/look-mechanics.md，確定固定錨點、誰引導視線、誰跟隨、每個方向的遮擋和每 22.5 度運動幅度。先生成並核准上、螢幕右、下、螢幕左四向錨點，再生成第 9 行和第 10 行兩個完整八格方向族。
方向行從核准的四向姿態均勻插值；第 10 行同時讀取已完成第 9 行，保證跨行連接。單個方向失敗時重做它所在的完整八格行，不把獨立修補格混進最終精靈表。accept-job 會用同一尺度、下身錨點和基線註冊方向行，並在進入下一階段前檢查正式格子邊緣。
若已接受的動作或方向在後續總覽、GIF、連續性檢查或盲審中失敗，用原 accept-job 命令增加 --replace-complete 接受替換圖。腳本會把被替換任務、依賴它的後續任務和失效產物一併移入版本化歷史，再從最早失敗點繼續；不要手改任務狀態或沿用舊圖集。
4. 最終檢查、成品和安裝
方向行完成後，按 reference 對完整 8×11 精靈表只執行一次邊緣去幕布色，再依次執行 v2 尺寸與透明檢查、標準與最終總覽、九個 GIF、十六方向圖、相鄰連續性測量和三份隔離方向盲審。獨立最終看圖結果與每個方向的可見證據寫入 reference 規定的 QA 檔案；四個正方向、角色身份、配件連接、動作狀態和精靈表幾何全部通過後才能定稿。
執行：
"<workspace-python>" -B scripts/pet_kit.py finalize <run-folder>
"<workspace-python>" -B scripts/pet_kit.py check <run-folder> --stage final
"<workspace-python>" -B scripts/pet_kit.py install <run-folder>
finalize 重新讀取角色快照、十三個視覺任務、確定性報告和看圖結論，然後生成只含 pet.json 與 spritesheet.webp 的正式寵物目錄。install 把它寫入當前 Codex 寵物目錄；相同內容已經存在時不重複寫入，不同內容佔用同一標識時回到「資訊與動作邊界」處理替換決定。安裝完成後不代替使用者重啟應用或點擊設定開關。
工具缺失時
角色身份路徑沒有生圖能力時，完成方向選擇和完整待確認檔案，執行 character_kit.py prompt --purpose master 並交付其結果，明確說明圖片與角色包尚未完成。
衍生視覺路徑沒有生圖能力時，完成視覺簡報並執行 visual_kit.py prompt，交付已完成的傳播判斷和生圖輸入，明確說明最終圖片與衍生歸檔尚未完成。沒有可寫工作區時可以展示圖片和說明，但聊天中的結果尚未形成可攜帶角色包或可校驗的衍生目錄。
桌寵路徑沒有生圖能力時，完成 pet_kit.py prepare，交付已連接角色包的執行目錄、完整任務圖和第一條基礎圖提示，明確說明動作圖、精靈表和安裝尚未完成。沒有獨立看圖執行能力時，完成所有確定性檢查後只把方向盲審圖和最終總覽交給使用者確認，不偽造三份盲審或獨立最終結論。
交付與停止
角色身份路徑第一段直接說明角色是否已經鎖定。完成時展示正式主參考圖，並說明核心記憶點、當前版本和角色包絕對路徑；隨後列出可選衍生方向，但只繼續完成使用者當前點名的結果。
衍生視覺路徑第一段直接說明圖片已經完成或還缺什麼。完成時先展示每張最終圖片，再用一句話說明它表達的核心關係、使用的角色版本和絕對儲存路徑。使用者不需要複製提示詞、編輯 JSON、手動編號、建立分支或整理圖片。
桌寵路徑第一段直接說明桌寵是否已經生成並安裝。完成時先展示最終總覽圖和至少一個動作預覽，再說明寵物名、所用角色版本、九組狀態與十六方向是否通過、正式成品目錄和安裝絕對路徑；最後只提醒使用者重啟或重新打開 Codex，並在設定中啟用寵物。
完成標準是：
- 角色包包含當前檔案、說明、單張主參考圖和可讀取的歷史版本，Q 版診斷稿與一致性測試圖沒有成為長期參考；
- 衍生圖讀取了角色包的真實生產結果和使用者內容，角色身份與傳播關係都透過實際看圖檢查；
- 每個正式衍生目錄能重新驗證角色版本、視覺簡報、生圖輸入、輸入資料和最終圖片；
- 桌寵執行目錄能重新驗證角色快照、主參考圖、十三個視覺任務、九組動作預覽、十六方向語義、盲審、透明處理、v2 精靈表和正式寵物目錄；
- 衍生圖和桌寵沒有反向改變角色身份，未點名的其它視覺、動畫或平台版本也沒有自動生成。