任務形狀
先分類工作，再選工具
Router 會先拆出任務性質、工作階段與技術領域，避免 Agent 把所有需求都當成一般實作任務處理。
AI Agent Skill Routing Pattern | Workflow Skill Router
Codex SKILL / Routing Layer
Workflow Skill Router
在 Codex 開始工作前，先說清楚由哪個 skill 主導、哪些 skill 協助，以及原因。
這個 SKILL 會輸出什麼
一份可審查的 routing contract
讀取
使用者任務、目前階段、可用的 SKILL catalog。
選擇
一個 Primary skill，加上少量真正降低風險的 Supporting skills。
輸出
Route、skill list、reason，以及開工前可檢查的 review point。
邊界
只收斂 skill 組合；工具權限與 approval policy 仍由既有機制處理。
邊界很清楚：它只做 skill selection，不授權工具，也不取代 approval policy。
讓多技能 Agent 有清楚入口
Agent 通常不是缺工具，而是每個相關 workflow 都在搶注意力。這個 router 會先把任務意圖整理成小而清楚、可被使用者修正的 skill set，再把授權與核准交回既有治理層。
閱讀客製化指南 Router 的判斷方式 01 02 03
Primary owner
只選一個主要 SKILL 負責
Primary skill 負責主要推理路徑；Supporting skills 可以協助，但不應該互相搶主導權。
聚焦支援
只加入真正降低風險的 SKILL
Route 會保持小而清楚：通常是一個 Primary skill，加上一到三個處理 API、資料庫、瀏覽器驗證、文件、CI 或 release 的 Supporting skills。
重點是讓執行前就能被檢查
使用者看到的是一份短短的 routing contract，可以在 Agent 修改檔案前先修正方向，而不是讓 Agent 一次背著所有 workflow 往前衝。
用一份參考範本，設計自己的 Router
範例不是另一個要照抄的成品。Template Skill Catalog 只示範 public-safe skills 如何被分類與 routing，方便你回頭用 Blank Router 做自己的版本。
查看 Reference Template Template Skill Catalog
下載包內容，就是範例內容
讀者不需要在三個情境頁之間猜哪個才是主範本。這裡直接把 template zip 的 public-safe skills 分類成可複製 routes。
資料庫 / 效能 / 慢查詢
Primary: database-optimizer
Supporting: sql-pro, systematic-debugging為看得見的成果設計
降低上下文噪音
Route 小到使用者可以在 Agent 修改檔案前先修正方向。
更快導入
新使用者可以下載範本、檢查 catalog，再把 routes 改成自己的 Agent 環境。
更安全分享
公開範例保持 generic，組織內規則則可以放在 private overlay。
發布前先驗證
Proof flow 會先驗證 router 結構、掃描 sample skill catalog、驗證 public route cases、評估 routing quality，並執行 unit tests，再分享 repo。
80 routing scenarios 12 route cases 0% violation rate
# 1. 驗證 router 結構
python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog
# 2. 掃描 skill catalog
python scripts/scan-skills.py ./sample-skills \
--out /tmp/skill-index.json \
--markdown /tmp/skill-index.md \
--warnings /tmp/skill-warnings.md \
--suggest-tree /tmp/suggested-skill-tree.md \
--fail-on-private \
--fail-on-duplicates
# 3. 評估 routing quality
python scripts/evaluate-routing.py \
--scenarios evaluation/scenarios.example.jsonl \
--predictions evaluation/predictions.example.jsonl \
--report /tmp/routing-report.md \
--json-report /tmp/routing-report.json \
--fail-on-violations \
--strict
python -m unittest discover -s tests