
OmX Agent Tiers 指南用 role、tier、posture 與 exactModel 四維控制 Agent 路由的推理成本【免費(fèi)下載鏈接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex導(dǎo)讀Agent Tiers 是 OmXOh My codeX中用于控制 Agent 路由時(shí)推理成本與工作風(fēng)格的一套實(shí)用指南解決的核心問題是當(dāng)一個(gè)角色既要做快速檢索、又要做深度實(shí)現(xiàn)時(shí)如何在責(zé)任與推理開銷之間取得平衡。本文基于 docs/shared/agent-tiers.md 展開并結(jié)合倉庫中的 src/agents/definitions.ts、src/agents/native-config.ts 與 src/config/models.ts 等源碼講清楚LOW/STANDARD/THOROUGH三個(gè) tier 的選型規(guī)則、frontier-orchestrator/deep-worker/fast-lane三種 posture 的行為差異以及exactModel如何繞過 tier 默認(rèn)值。讀完你既能照單配置各角色的模型與推理檔位也能理解 OmX 底層是如何把這些元數(shù)據(jù)落成 Codex 原生 Agent TOML 的。一、心智模型把責(zé)任、深度、風(fēng)格三件事分開1.1 三個(gè)易混概念的解耦agent-tiers.md 開篇強(qiáng)調(diào)OmX 把過去混在一起的Agent 該干什么拆成了三個(gè)正交維度維度含義取值示例role該 Agent 負(fù)責(zé)什么executor、planner、architecttier該角色要投入多少推理/成本LOW、STANDARD、THOROUGHposture角色以何種風(fēng)格運(yùn)作frontier-orchestrator、deep-worker、fast-laneexactModel可選的角色級模型鎖定gpt-5.6-sol、gpt-5.6-terra一句話概括用 role 選責(zé)任用 tier 選深度用 posture 選風(fēng)格。exactModel是當(dāng)某個(gè)角色需要特定模型契約時(shí)才使用的繞行通道它優(yōu)先于 tier 默認(rèn)值。這一設(shè)計(jì)在源碼里有直接對應(yīng) src/agents/definitions.ts 的AgentDefinition接口同時(shí)攜帶reasoningEffort、posture、modelClass、routingRole、tools、category、可選exactModel與可選nativeSubagentDelegation等字段其中exactModel的類型被限定為gpt-5.6-terra | gpt-5.6-sol兩個(gè)已知?jiǎng)e名。1.2 tier 只是深度維度不等于模型強(qiáng)綁定需要澄清tier 描述的是推理深度檔位而真正決定跑哪個(gè)模型的是源碼中的modelClassfrontier/standard/fast與exactModel的組合。從源碼實(shí)現(xiàn)看模型解析順序?yàn)閜er-agentagentModels[role]覆蓋 exactModel精確鎖定 modelClass按車道路由見 src/agents/native-config.ts 的resolveAgentModel。因此 tier 與模型是預(yù)算意圖與物理資源的關(guān)系兩者配合而非等同。二、三個(gè) Tier 的定位與典型角色2.1 LOW快查與窄檢查適用場景簡單探索、風(fēng)格檢查、輕量文檔編輯。典型角色explore、style-reviewer、writer。源碼佐證在 definitions.ts 中explore的reasoningEffort為low、modelClass為fast、tools為read-onlystyle-reviewer同樣為low推理、fast模型類definitions.ts。它們都走 spark/fast 車道模型解析見resolveAgentModel中case fast默認(rèn)取getSparkDefaultModel內(nèi)置默認(rèn)gpt-5.6-luna見 src/config/models.ts。2.2 STANDARD實(shí)現(xiàn)、調(diào)試與常規(guī)驗(yàn)證的默認(rèn)檔適用場景絕大多數(shù)代碼改動(dòng)、調(diào)試、常規(guī)驗(yàn)證。典型角色executor、debugger、test-engineer、quality-reviewer。源碼佐證executor的reasoningEffort為medium、modelClass為standarddefinitions.ts。executor還是源碼中的一個(gè)特殊案例生成原生 Agent TOML 時(shí)它優(yōu)先讀取 Codexconfig.toml根model否則回落到主/frontier 默認(rèn)見 native-config.ts 與 docs/reference/omx-config-schema-routing.md 的說明。2.3 THOROUGH架構(gòu)、安全敏感與多文件高影響改動(dòng)適用場景架構(gòu)設(shè)計(jì)、安全/信任邊界改動(dòng)、跨大量文件的大型重構(gòu)。典型角色architect、critic、security-reviewer、executor。重要遷移提示文檔明確標(biāo)注deep-executor已廢棄實(shí)現(xiàn)類路由統(tǒng)一走executor。源碼佐證architect使用reasoningEffort: xhigh且exactModel: gpt-5.6-soldefinitions.tscritic為high推理、frontier模型類definitions.ts。注意reasoningEffort的合法取值是low | medium | high | xhigh四檔見 definitions.ts而 per-agent 配置層面還允許max見 src/config/models.ts 的PER_AGENT_REASONING_EFFORTS。2.4 三個(gè) Tier 的選型速查表Tier什么時(shí)候用典型角色推理檔位示例LOW任務(wù)有界、非侵入explore、style-reviewer、writerlowSTANDARD默認(rèn)起點(diǎn)覆蓋大部分改動(dòng)executor、debugger、test-engineer、quality-reviewermediumTHOROUGH安全/架構(gòu)/大規(guī)模多文件architect、critic、security-reviewerhigh/xhigh三、Selection Rulestier 的實(shí)戰(zhàn)選擇規(guī)則agent-tiers.md 給出了四條可直接照做的規(guī)則大多數(shù)代碼改動(dòng)從STANDARD起步——不要一開始就拉滿成本。僅在任務(wù)有界且非侵入時(shí)使用LOW——例如只查一個(gè)符號(hào)、改一處注釋。滿足以下任一條件就升級到THOROUGH安全 / 認(rèn)證 / 信任邊界相關(guān)改動(dòng)影響全系統(tǒng)的架構(gòu)決策跨大量文件的大型重構(gòu)。Ralph 完成度檢查至少使用STANDARD檔的 architect 驗(yàn)證。其中第 4 條是團(tuán)隊(duì)級完成度檢查的硬性下限實(shí)踐中對應(yīng) Ralplan/Ralph 流程里的 architect 角色驗(yàn)證環(huán)節(jié)關(guān)于 Ralplan 中planner/architect/critic的角色分工與 posture 歸屬可進(jìn)一步參考 docs/reference/omx-config-schema-routing.md。四、Posture Guidance三種工作風(fēng)格的行為契約posture 決定了角色拿到任務(wù)后怎么行事OmX 會(huì)在生成 Agent 指令時(shí)注入對應(yīng)的 posture overlay 文本見 src/agents/native-config.ts 的POSTURE_OVERLAYS每條都是一段posture_overlay ... /posture_overlay指令塊。4.1 frontier-orchestrator可操控前沿模型 領(lǐng)導(dǎo)型角色定位適合可引導(dǎo)性強(qiáng)的前沿模型與 leader 型角色。優(yōu)先級意圖分類、委派、驗(yàn)證、架構(gòu)判斷。典型角色planner、analyst、architect、critic、code-reviewer。指令要點(diǎn)來自POSTURE_OVERLAYS源碼實(shí)施前先做意圖分類存在專家時(shí)默認(rèn)委派與編排把第一個(gè)決策當(dāng)成路由問題研究 vs 規(guī)劃 vs 實(shí)現(xiàn) vs 驗(yàn)證在實(shí)現(xiàn)前簡潔地質(zhì)疑可能引發(fā)問題的用戶假設(shè)保持顯式的 executor 交接邊界不吸收本應(yīng)由專門 executor 承擔(dān)的深度實(shí)現(xiàn)工作。Ralplan 的落地細(xì)節(jié)文檔明確說明planner鎖定精確模型gpt-5.6-sol medium 推理architect鎖定精確模型gpt-5.6-sol xhigh 推理critic共識(shí)門禁保持在前沿車道。這一點(diǎn)與源碼完全一致planner與architect在 definitions.ts 中都帶exactModel: gpt-5.6-sol且 native-config.test.ts 用測試斷言了這兩個(gè)角色生成的 TOML 固定為model gpt-5.6-sol、推理檔位分別為medium與xhigh。4.2 deep-worker把實(shí)現(xiàn)干到底的深度工作者定位適合實(shí)現(xiàn)密集型角色承擔(dān)任務(wù)直到完成。優(yōu)先級直接執(zhí)行、最小化 diff、嚴(yán)格驗(yàn)證。典型角色executor、debugger、test-engineer、build-fixer。指令要點(diǎn)任務(wù)一旦明確是實(shí)現(xiàn)導(dǎo)向就偏向直接執(zhí)行與端到端完成先探索再實(shí)施最小改動(dòng)并匹配既有模式驗(yàn)證必須嚴(yán)格診斷、測試與構(gòu)建證據(jù)是宣稱完成前的強(qiáng)制項(xiàng)只有當(dāng)方法確實(shí)失敗或架構(gòu)權(quán)衡超出本地實(shí)現(xiàn)范圍時(shí)才升級。4.3 fast-lane廉價(jià)/快速模型的快速通道定位適合用于 triage、搜索與窄范圍綜合的廉價(jià)/快速模型。優(yōu)先級快速路由、簡潔搜索、及時(shí)升級而非深度自主工作。典型角色explore、writer以及輕量研究/搜索專家。指令要點(diǎn)面向快速 triage、搜索、輕量綜合與窄路由決策優(yōu)化除非任務(wù)高度有界且顯然否則不啟動(dòng)深度實(shí)現(xiàn)任務(wù)一旦膨脹就升級到 frontier-orchestrator 或 deep-worker 角色保持質(zhì)量優(yōu)先、范圍感知模糊場景下保守。五、exactModel繞過 tier 默認(rèn)值的角色級模型鎖定5.1 什么時(shí)候需要 exactModel當(dāng)某個(gè)角色對模型契約有硬性要求時(shí)例如 planner 的規(guī)劃穩(wěn)定性、architect 的長程權(quán)衡判斷tier 默認(rèn)的按模型類路由不足以表達(dá)這種必須用某個(gè)模型的約束此時(shí)用exactModel直接鎖定。5.2 倉庫中的兩個(gè)精確鎖定實(shí)例角色exactModelreasoningEffort來源plannergpt-5.6-solmediumdefinitions.tsarchitectgpt-5.6-solxhighdefinitions.tsresearchergpt-5.6-terrahighdefinitions.ts5.3 解析優(yōu)先級與運(yùn)行時(shí)行為從 native-config.ts 的resolveAgentModel可以確認(rèn)完整解析鏈agentModels[role]per-agent 覆蓋優(yōu)先其次exactModel最后按modelClass路由。當(dāng)解析出的模型恰好等于精確鎖定時(shí)composeRoleInstructions還會(huì)追加一段exact_model_guidance強(qiáng)制要求嚴(yán)格執(zhí)行順序inspect → plan → act → verify只有實(shí)現(xiàn)完成且新驗(yàn)證通過后才能宣稱完成遇到阻塞如實(shí)報(bào)告、不編造結(jié)果見 native-config.ts 與 native-config.test.ts 的斷言。5.4 配置層如何覆蓋雖然exactModel是內(nèi)建鎖定但用戶仍可通過.omx-config.json的agentModels與agentReasoning塊做 per-agent 覆蓋。配置結(jié)構(gòu)見 src/config/models.ts 的文檔注釋{ agentReasoning: { architect: xhigh }, agentModels: { architect: gpt-5.6-sol } }agentModels[role]優(yōu)先生效其次是內(nèi)建exactModel最后才是modelClass車道路由。測試 native-config.test.ts 驗(yàn)證了agentModels 覆蓋精確鎖定后不會(huì)殘留過期的 exact 指導(dǎo)文本native-config.test.ts 則驗(yàn)證了 per-agent 推理檔位支持max而ultra會(huì)被回落到high。六、落地鏈路從定義到 Codex 原生 Agent TOML理解 tier/posture 的最終落點(diǎn)是看 OmX 如何把 definitions.ts 里的定義轉(zhuǎn)換成 Codex CLI 可用的原生 Agent 配置定義層AGENT_DEFINITIONS 集中聲明所有角色的reasoningEffort、posture、modelClass、routingRole、tools、category與可選exactModel。指令合成層composeRoleInstructions 把prompts/role.md的提示詞與 posture overlay、modelClass overlay、exact-model guidance、native subagent 葉子護(hù)欄拼接并寫入## OMX Agent Metadata包含 role、posture、model_class、routing_role、resolved_model 等元數(shù)據(jù)。模型解析層resolveAgentModel 按per-agent 覆蓋 exactModel modelClass決策modelClass: frontier走主/frontier 默認(rèn)gpt-5.6-solfast走 spark 默認(rèn)gpt-5.6-lunastandard走標(biāo)準(zhǔn)車道未配置時(shí)繼承主/frontier可用OMX_DEFAULT_STANDARD_MODEL顯式切到更便宜的模型見 models.ts。TOML 生成層generateAgentToml 輸出包含model、model_provider、model_reasoning_effort、developer_instructions的獨(dú)立 TOML再由 installNativeAgentConfigs 安裝到~/.codex/agents/或./.codex/agents/。對應(yīng)的角色提示詞文件全部位于 prompts/ 目錄如 executor.md、architect.md、planner.md定義完整性由 src/agents/tests/definitions.test.ts 與 src/agents/tests/native-config.test.ts 雙重守護(hù)——例如definitions.test.ts斷言reasoningEffort為必填且僅允許low | medium | high | xhigh并逐角色核對 plannermedium、architectxhigh、critichigh的檔位。七、與模型車道配置的關(guān)系tier、posture 與模型車道最終統(tǒng)一在 docs/reference/omx-config-schema-routing.md 描述的模型路由體系里。要點(diǎn)歸納內(nèi)置默認(rèn)三車道gpt-5.6-solfrontier、gpt-5.6-terrastandard、gpt-5.6-lunaspark/fast見 src/config/models.ts。環(huán)境變量覆蓋OMX_DEFAULT_FRONTIER_MODEL是主/frontier 默認(rèn)的最強(qiáng)環(huán)境配置OMX_DEFAULT_STANDARD_MODEL是可選的 standard 車道覆蓋OMX_DEFAULT_SPARK_MODEL與OMX_SPARK_MODEL控制 spark 車道。省略 standard 覆蓋時(shí)standard 角色默認(rèn)繼承 leader/frontier 模型見 models.ts 與 omx-config-schema-routing.md。一個(gè)容易踩的細(xì)節(jié)原生 Agent TOML 生成路徑中frontier 角色與executor特殊場景先讀 Codexconfig.toml根model再回落到主默認(rèn)——因此顯式寫在config.toml的根model不會(huì)被.omx-config.json的env.OMX_DEFAULT_FRONTIER_MODEL覆蓋見 omx-config-schema-routing.md 的專門說明。結(jié)語OmX 的 Agent Tiers 把角色責(zé)任、推理深度、工作風(fēng)格拆成三個(gè)正交維度并輔以exactModel做角色級精確鎖定讓路由決策既直觀先定 role再選 tier再定 posture又可預(yù)測每層都有明確的模型解析優(yōu)先級。本文對應(yīng)的權(quán)威定義位于 docs/shared/agent-tiers.md其底層實(shí)現(xiàn)可分別在 src/agents/definitions.ts、src/agents/native-config.ts 與 src/config/models.ts 中逐行核對兩側(cè)相互印證是理解 OmX 多智能體編排成本控制的完整入口。【免費(fèi)下載鏈接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考