# Adaptive Task Routing for ChatGPT 與 Codex

[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md)

**先知道下一步怎麼做，也知道何時值得維持現況。**

Adaptive Task Routing 在重要工作階段開始前，評估對話環境、模型與推理設定。先顯示現在建議的動作，再用一句話解釋原因。適合任務的模型，不代表工作進行到一半就值得切過去。

判斷會考慮任務需求、目前設定是否足夠、剩餘工作量、對話延續與切換成本。保留適任設定也是正式結果；資訊不足時會說「暫時沿用」，不冒稱已確認適合。實際節省與可靠度改善仍需要證據。

## 運作方式

1. AI 先交付你要求的發現，或提出可執行計畫。
2. 路由區塊先顯示動作：維持、暫時沿用、開新對話、調整設定，或請你決定。啟用對話路由時，仍明確回答是否需要開新對話。
3. 預設 `ask` 在變更前或遇到關鍵阻礙時詢問；保留與不妨礙進度的不確定性，不中斷已授權工作。只要求計畫不等於授權實作。

簡短問題與未改變的階段不重複路由。對話與模型分開判斷；交接到新對話時也可能需要調整模型。

## 安裝

公開 Plugin 透過 OpenAI Plugins portal 管理。正式上架前，可從[最新版本](https://github.com/zyzdev/adaptive-task-routing/releases/tag/v0.5.0)下載 `adaptive-task-routing-openai-0.5.0.zip`，解壓縮後將該目錄註冊為本地 Plugin 來源或 Marketplace。

Codex CLI 可從已設定的 Marketplace 安裝；公開上架後，ChatGPT 與 Codex App 可直接從 Plugins Directory 選取。

## 第一次使用

啟用 Plugin 後，開新對話輸入：

> 請檢視這個專案並提出改善計畫，先不要修改檔案。

需要時可明確要求使用 adaptive-task-routing Skill。AI 應先交付計畫，再附路由建議；這段請求沒有授權實作。

## 你會看到什麼

以下是不同情境的範例，接在使用者要求的計畫或分析之後。「維持設定」範例假設核對工作已獲授權；只要求計畫時則以交付計畫結束。模型與原生推理設定僅為示意，依平台而異；「目前 AI」必須有實際觀察依據。

**不值得切換時**

```text
---

### Adaptive Task Routing

✓ 維持目前設定

目前設定足夠，而且剩餘工作不多，切換帶來的改善有限。

對話：留在目前對話，不需開新對話。
目前 AI：GPT-5.6 Sol / high。

不需操作，接著執行已授權的核對。
```

**值得切換時**

```text
---

### Adaptive Task Routing

↑ 建議調整 AI 設定

下一階段的驗證需求超過目前已觀察設定的能力。

對話：留在目前對話，不需開新對話。
任務適配設定：GPT-6 Astra / high。

要改用 GPT-6 Astra / high 嗎？
```

實際控制依平台提供。`auto` 只有驗證成功才說已套用；無法代為操作時說明實際處理方式。若目前設定資訊不足，改顯示「暫時沿用設定」、有用的任務適配設定與不確定原因；真正阻礙品質或進度的問題才需要你決定。

只要求計畫時，結尾會說明已交付計畫、尚未開始實作。需要交接時，顯示「對話：建議開新對話並交接必要脈絡，待你確認」，並提供下一階段需要的事實、限制與交接摘要。

## 模式與詳細程度

| 模式 | 行為 |
| --- | --- |
| `ask`（預設） | 變更前或有關鍵阻礙才詢問；保留與不阻礙工作的 defer，直接繼續已授權工作。 |
| `auto` | 只有切換值得、已授權、平台支援且能驗證時才套用；無法操作就說明實際結果，不忽略重大阻礙。 |
| `off` | 跳過指定 Router 及其輸出。 |

Context 與 Model 可分別設定。可直接說「這次關閉對話路由」、「模型路由改用 ask」或「這個對話的兩個路由都改用 auto」。單純改模式不授權任何工作。

預設顯示精簡版。說「顯示詳細說明」可查看**最低足夠設定、任務適配設定與升級理由**。適配設定回答本階段適合用什麼；建議動作回答現在應該做什麼。詳細版重用原評估，切換分數只供診斷；compact／detailed 是顯示偏好，不是額外模式。

確認保留時，精簡版只顯示已觀察的目前 AI；其他適配設定留到詳細說明。暫時沿用也可能來自切換成本或效益不明，不限於目前 AI 未知。

## 建議根據什麼？

- **對話環境：** 評估下一個任務需要沿用哪些資訊，以及舊任務的假設或限制是否可能干擾新工作，再建議保留對話、整理資訊後交接，或從新對話開始。
- **模型與推理強度：** 考量任務難度、模糊度、錯誤成本與驗證需求，提供最低足夠及任務適配設定，並說明提高設定是否值得。
- **模型資訊來源：** 優先使用目前環境可取得的資訊；無法取得時，依平台使用套件內有效的參考資料。參考資料不代表你的帳號一定能選用該模型。

完整判斷原則與平台限制可查閱[設計與架構](docs/architecture.zh-TW.md)。

## 移除

可透過 Plugins Directory 或已設定的 Codex Marketplace 移除。若是手動解壓縮的本地版本，請移除 Marketplace 項目並刪除該目錄。

套件、驗證與發布細節請參考[開發說明](DEVELOPMENT.md)。