setup-pstack | 依平台設定角色模型與路由
本頁以 pstack-claude 0.9.126 為基準。setup-pstack 會寫入角色模型覆寫表（Override sheet），可能還要修改載入該表的指令檔。本頁只說明流程，不代表已修改任何設定。
定位與適用情境
你在 Codex 安裝 pstack 後，希望一般工作沿用聊天模型，審查則使用帳號實際可用的不同模型。先用此技能確認角色、推理等級與路由，不要把 Claude 的模型名稱直接搬過來。
角色中的 auto 與 inherit-parent 都表示沿用父工作階段模型。面板清單每個項目仍會產生一個子代理，別把重複的別名誤認為只執行一次。
準備
先確認平台、安裝方式與設定檔範圍。原文列出以下路徑及載入差異。這些是文件中的設定位置，不是本頁要你直接開啟的本機連結。
- Claude Code 的
<config>為$CLAUDE_CONFIG_DIR，未設定時為~/.claude。設定表是<config>/pstack-models.md，模型列靠CLAUDE.md的@引用載入。不是 Cursor 的.mdc。 - Codex 的
<codex-home>為$CODEX_HOME，未設定時為~/.codex。設定表是<codex-home>/pstack-models.md。模型列及default effort要貼入<codex-home>/AGENTS.md，不支援@引用。插件直接從設定表讀session hook，不要把這列貼進AGENTS.md。 - Pi 使用
$PI_CODING_AGENT_DIR/pstack-models.md，預設為~/.pi/agent/pstack-models.md。pstack 擴充直接讀取模型列與路由設定，不需引用行。 - GitHub Copilot 使用
${COPILOT_HOME:-~/.copilot}/pstack-models.md。插件掛鉤（Hook）驗證後注入模型列，僅安裝技能時另以平台讀取工具載入。模型選項來自task工具，不預設帳號可用模型。 - Muse 使用
${XDG_CONFIG_HOME:-~/.config}/muse/pstack-models.md。核准插件掛鉤後直接載入，不需引用行。 - MiniMax Code 的表固定為
~/.minimax/pstack-models.md，即使資料目錄搬移也一樣。代理讀模型列，或將模型列貼到其資料目錄的AGENTS.md，插件讀路由設定。 - opencode 使用
~/.config/opencode/pstack-models.md，在opencode.json的instructions陣列加入路徑。Gemini CLI 使用~/.gemini/pstack-models.md，由GEMINI.md的@引用載入。這兩項依發布文件描述，原文設定表未宣稱現場驗證。 - Prime Agent 沒有已記載的設定表路徑，模型由平台設定選擇，不自行猜路徑。
Claude Code 可用 /pstack:setup-pstack。Codex 插件可從 $ 技能選單選入 $pstack:setup-pstack。僅安裝技能時名稱沒有 pstack: 前綴。
操作步驟
- 讓代理列出本次工具實際接受的模型識別名稱（Model slug），讀取已授權的現有設定，列出過期角色與待更正值。
- 逐項確認角色模型及面板成員。
arena cross-judge pool是候選評審順序，不是所有候選都會同時評審。確認清單長度與預期成本。 - 選擇
default effort及需要個別覆寫的@level。Codex 的session需要目前回合的中繼資料；取不到時，改由你指定固定等級，不宣稱自動繼承成功。 - 決定
session hook為on或off。寫入前先查看完整檔案差異，包含平台所需的載入檔變更，核准後才寫入。 - 驗證模型與等級都可用，再核對設定表位置及載入機制。可另行選擇是否建立驗證技能，拒絕也不影響模型設定。
可直接使用的提示詞
用 pstack:setup-pstack 規劃我的 Codex 原生插件設定。
先列出實際可用模型、現有角色值、各角色的代理數，以及 default effort 的選項。
先不要寫檔。列出將修改的 pstack-models.md 與 AGENTS.md 差異，等我確認。
模型列與 default effort 要按 Codex 規則載入，session hook 留在設定表供插件讀取。
若 session 推理等級無法取得，請讓我選固定等級，不要猜。
不要安裝依賴，也不要順便建立驗證技能。預期結果與驗收
預期得到已確認的角色模型、推理等級、路由開關與寫入位置。每個真實模型名稱都要能在平台列出的集合找到，別名則應清楚表示沿用父模型。
確認檔案存在不等於載入成功。要檢查模型列確實進入對應工作階段，並分清設定表寫入、載入設定與插件掛鉤信任三件事。Codex 需要透過 /hooks 信任插件掛鉤；僅安裝技能沒有該插件掛鉤。
限制與權限
這項技能會完整重寫設定表，先保留並比較舊值。全域設定影響其他專案，必須明確確認範圍與差異。路由關閉不會卸載技能，也不是關閉所有平台掛鉤的通用開關。
各平台的模型名稱、推理等級與代理工具不同。不能拿 Claude 的預設面板保證 Codex、Pi 或 Copilot 可用，也不能因設定表記錄了選擇就保證工具能套用模型。缺工具或存取權限時應停止該設定步驟並標明缺口。