V2 快速開始

1. 選擇 runtime

Codex 支援時安裝 Plugin + MCP；只需要指令式 fallback 時安裝純 SKILL。除非是在測試 precedence，否則不要用相同 identity 同時安裝兩者。

2. 驗證標籤

Plugin checkout：

python plugins/workflow-skill-router/runtime/workflow_skill_router.pyz doctor

預期結果：runtime_profile 是 bundled-local-r0；plan_work、propose_support_consent、transition_support_consent 與 get_router_status 都是 local-ready。純 SKILL 任務必須標示 skill-only-fallback。

3. 試跑三種需求

小型自動 route：

替一個 API error response 補上文件。

預期 envelope：single。使用者沒有指定 SKILL，因此不應出現輔助技能 consent prompt。

Explicit Skill Lock：

只使用 api-designer。未詢問前不要加入輔助技能。

預期：指定的 SKILL 維持主要規劃選擇；任何指定範圍外的輔助建議都必須取得同意，被拒絕後不納入計畫。計畫本身不能證明 Skill 已實際啟用。

Managed Goal：

繼續跨 API、Web 與 docs 的 migration Goal。

預期本機行為取決於工作圖。有效的 Router-owned graph 可讓 get_next_work 回傳下一個本機 Work Item，並標示 authority_mode=router-local、host_goal_mutated=false。若已綁定 Native Goal，排程仍需要已驗證的 Host 能力；缺少時回傳 typed capability-unavailable。get_router_status 仍可讀取。本機計畫或下一步不能證明 Skill 已啟用，也不會授予部署權限。

4. 試跑 Personal Routing Profile

Personal Routing Profiles 隨 v2.0.0-beta.2 提供。請在 contributor checkout 中試跑使用者自訂 Skill Tree：

Copy-Item starter/v2/workflow-skill-router/assets/personal-routing-profile.example.json ./my-profile.json
python plugins/workflow-skill-router/runtime/workflow_skill_router.pyz profile validate .\my-profile.json
python plugins/workflow-skill-router/runtime/workflow_skill_router.pyz profile install .\my-profile.json
python plugins/workflow-skill-router/runtime/workflow_skill_router.pyz profile preview --objective "交付 API" --work-mode phased --domain api

Workspace Profile 放在 .codex/workflow-skill-router.json。Preview 必須回報 intended-unverified；Runtime Capability Discovery 仍控制 activation。Skill-only 只能依相同 contract 做 skill-only-fallback。

5. 檢查證據

開啟首頁 Flight Recorder，展開每個 MCP step 查看已去識別化的 request/response JSON。runtime-trace 是 bundled local evidence；fixture-trace 透過測試 ports 證明 Host contract，不是 live Host connection。