安裝模式與 Release Assets

選擇你的 V2 安裝模式

一般使用者若要完整功能，直接選 Plugin + MCP；目前環境不能載入 Plugin/MCP 時，再選純 SKILL。其他模式主要提供給平台整合者與評測維護者。

這些模式共用同一套 policy core，但 runtime boundary 不同。Router 只會使用 Host 真正提供的權限與能力，不會因為安裝了檔案就宣稱所有功能都可用。

主要安裝方式

Bundled Plugin + MCP

一般 Codex 使用者建議選這個模式。它會保存本機規劃與輔助技能同意狀態，並清楚回報哪些工具可直接執行。

Local-ready: plan_work、propose_support_consent、transition_support_consent 與 get_router_status
Runtime label: bundled-local-r0
系統需求: Codex Plugin/MCP、Python 3.11+、Node.js 24+

安裝 Plugin + MCP

Host integration

Verified-host integration

只有把 Router 接進自有平台的整合者才需要此模式。Scheduler、受保護的 route validation、gates 與 Goal progression，必須由 Host 提供可驗證的 ports 與 receipts。

最適合: Codex 或平台整合者
Authority: 由 Host 所有，不從本機檔案推測
Fallback: Typed capability-unavailable

檢查 Host boundary

授權後的 evaluation

Configured evaluation adapter

只有執行正式模型評測的維護者才需要設定此 adapter。它透過伺服器預先設定的 executable 執行 fresh Behavior 或 Outcome attempts，模型輸入不能自行選擇額度或發布狀態。

最適合: 執行 reviewed benchmark 的 maintainers
需要: Trusted adapter configuration 與明確 quota authorization
發布狀態: 取得 attestation 前維持 review-required

閱讀 evidence contract

Instruction-only fallback

純 SKILL

環境不能載入 Plugin/MCP 時選這個模式。它仍會尊重使用者指定的 SKILL 並揭露使用情況，但不提供可持久化的 Runtime 保證。

Runtime label: skill-only-fallback
目前 source 包含: SKILL.md、assets/personal-routing-profile.example.json、assets/workspace-routing-profile.example.json、references/evaluation-boundary.md、references/goal-protocol.md、references/personal-routing-profiles.md 與 references/routing-protocol.md
不包含: Durable resume、跨程序 CAS、sealed instrumentation

只使用 SKILL

Contributors 與 integrators

Source checkout

需要修改 Router 原始碼、文件或 Host adapter 時才使用 source checkout。Generated release files 不可手動編輯。

主要來源: Git repository 與 pinned dependency locks
Build output: Ignored dist/release/
驗證: Core、MCP、docs、site、install、SBOM、provenance

在 GitHub 查看 source

v2.0.2 的 Plugin 與純 SKILL 套件都包含 strict Personal 與 Workspace Routing Profile 範例。Skill-only 只有在 Host 授權 filesystem access 時，才能讀取固定的本機 Profile 路徑。

Marketplace 安裝

一般使用者請固定安裝已發布且不可變的 marketplace snapshot：

codex plugin marketplace add eric861129/Workflow-skill-router --ref v2.0.2
codex plugin add workflow-skill-router@workflow-skill-router
codex plugin list

需要修改 Router 的貢獻者，才使用 repository checkout：

git clone https://github.com/eric861129/Workflow-skill-router.git
Set-Location Workflow-skill-router
codex plugin marketplace add .
codex plugin add workflow-skill-router@workflow-skill-router

離線檢查 assets

請使用不可變的 v2.0.2 GitHub Release assets，不要從可變動的 raw/main/downloads 檔案安裝。

ZIP 用於離線檢查與 fallback installation。使用前必須驗證發布的 checksums、SBOM 與 provenance；不可把本機 prerelease build 當成已發布 asset。

安裝後驗證

Marketplace 安裝先確認 Codex 看得到 Plugin，重新啟動 Codex，再開新任務要求顯示 Workflow Skill Router 狀態：

codex plugin list

解壓縮的 Plugin package 請在 Plugin 根目錄執行：

python runtime/workflow_skill_router.pyz doctor

Repository contributor 則在 repository root 執行：

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

預期 bundled result：runtime_profile 是 bundled-local-r0、telemetry disabled，而且 plan_work、propose_support_consent、transition_support_consent 與 get_router_status 都是 local-ready。接著進入 V2 快速開始。