Codex · Lean Sol Agent Tree
OPENAI CODEX ARCHITECTURE · LEAN AGENT TREE · TIERED ROUTING

OpenAI Codex Agent Routing Blueprint GPT-6.1 Sol 分級代理樹
與極簡工程架構。
以 1/5 成本打造接近 Astra 等級的自主工程團隊。

解構 @cyrilXBT 發布的 Lean Agent Tree 架構實踐。為什麼盲目將所有工程任務丟給旗艦模型 Astra 是無效益的預算浪費？透過 6.1 Sol（$0.10/M 緩存輸入） 作為規劃核心、低成本 Luna 承接狹窄探索、僅在有證據需呈報時喚醒 Astra，建立「單一任務單一負責人、依證據呈報」的高產能工程體系。

核心中樞
6.1 Sol
低/中 effort 調度，兼具深度推理與程式碼實作能力。
快取讀取
$0.10 /M
超低緩存輸入成本，支撐高頻調度與長上下文迭代。
成本比例
1/5 Price
相比全量調用 Astra 旗艦模型，直接節省 80% Token 支出。
核心鐵律
On Evidence
單一任務單一負責人，唯有具備確鑿測試證據方可呈報。
01 / 核心哲學 TIERED ARCHITECTURE VS FLAT FRONTIER BURN

將每個任務無差別送往旗艦模型，只是在燃燒五倍預算

架構師手記 ARCHITECT'S NOTE

在 OpenAI Codex 與自主代理開發環境中，將所有常規任務一律送交旗艦模型 Astra 會在數天內消耗殆盡 API 配額。成熟工程架構的核心在於「模型分級路由」：由 6.1 Sol 掌舵規劃、極速低費的 Luna 承接確定性資訊檢索，昂貴的旗艦模型僅在獨立審核與關鍵邊界時喚醒。

01

分級代理樹（Tiered Agent Tree）是唯一理性的工程架構

旗艦模型不是廉價工人，而是高階審核者。把瑣碎的程式庫搜尋、語法搬移與格式整理交給旗艦模型，對最終交付品質毫無助益，只會徒增 5 倍算力支出。合理的代理樹能讓主力運算維持在低費率層次。

02

成本路由機制：讓便宜模型擋下 80% 的機械計算

Luna 處理窄域調查與精確檢索，本地 CPU 工具（ripgrep、AST 解析、單元測試）以 $0 成本執行確定性步驟。GPT-6.1 Sol 僅在需要重型推理的邏輯分支觸發，保持 Astra 常態處於休眠（Cold）狀態。

03

單一任務單一負責人，依證據向上呈報（Escalate on Evidence）

禁止多個 Agent 模糊共有單一任務，禁止無依據的盲目向上呈報。任何子代理向上請示時，必須強制附帶複現紀錄、測試斷言與失敗證據，由主幹驗證確認無法自動化收斂後，方可呈報 Astra 審核。

02 / 代理樹拓撲 LEAN AGENT TREE TOPOLOGY · CODEX BLUEPRINT
02

代理樹拓撲 Lean Agent Tree Topology

以 GPT-6.1 Sol 為調度主幹，依需求按需派發 Luna 探路與 Sol 工人，Astra 僅負責最終審核。

4 Core Roles
Tiered Tree
OpenAI Codex Spec
01/04
Root Node · GPT-6.1 Sol (medium) 調度主幹

掌控全域規劃與整合驗證，依需求動態派發子代理

維持會話主幹乾淨，專注工作拆解、上下文收斂與最終整合驗收

作為代理樹的核心大腦，Sol medium 負責接收人類使用者的工程目標。它不親自進行漫無目的的全文搜尋，而是將任務分解為具備嚴格輸入輸出的子合約：
• 按需委派 (Delegate on Demand)：將檔案探路與資料查找派發給 Luna，將具體模組實作派發給 Sol worker。
• 整合與驗證 (Integrate & Verify)：接收子代理提交之程式碼 diff，執行本地編譯與測試套件，確保主幹健康。

✓ 樹頂調度主幹 Delegate on Demand Integrate & Verify Clean Root
Role Orchestrator Model GPT-6.1 Sol Effort Medium
02
Explorer & Researcher · GPT-6 Luna (high) 雙探路節點

低成本極速探索，鎖定有界調查與精準文件檢索

以高 effort 驅動超低費率模型，承接 80% 的日常搜尋開銷

專門承接消耗大量上下文的探索任務，保持唯讀模式，嚴禁修改任何專案原始碼：
• Explorer (有界調查)：遍歷專案檔案目錄、定位異常報錯函式、查明相依套件版本與設定相容性。
• Researcher (精準檢索)：查閱第三方官方文件、擷取範例程式碼片段、搜尋團隊內部過往類似 PR。
將龐大搜尋歷史留在子代理對話中，僅向主幹回報精煉結論，徹底防範主幹上下文膨脹。

★ 80% 成本防線 GPT-6 Luna 唯讀探索 隔離膨脹
Role Explorer/Search Model GPT-6 Luna Effort High
03
Code Worker · GPT-6.1 Sol (high) 實作工程師

專注單一功能模組，實作與單元測試同步交付

以旗艦級程式碼編寫水準，在隔離環境中完成嚴格定義的改動

僅在 Explorer 完成邊界調研、主幹敲定規格後方才觸發。Worker 在獨立的工作區或分支中專注編寫：
• 雙重產出要求：必須同時產出功能實作與完整的單元測試斷言，嚴禁無測試裸奔交付。
• 自律驗證迴圈：在本地環境預先執行 linter 與測試指令，通過後方能將 diff 與測試報告回傳主幹。
單次工作任務嚴格限定於單一模組，完成即銷毀，杜絕長會話記憶衰減。

✓ 確定性交付 Implementation Unit Tests Self-Verifying
Role Code Worker Model GPT-6.1 Sol Effort High
04
Independent Reviewer · GPT-6 Astra (low) 審查防線

常態保持冷機休眠，僅在重大邊界與確鑿證據下喚醒

昂貴旗艦只做裁判不做工人，杜絕高資費常態燃燒

Astra 在這套架構中被嚴格限制為「獨立第三方審核者」，日常任務一律不指派給它：
• 喚醒條件 (Only if Needed)：當 Sol 主幹整合失敗且重試兩次無果、或即將變更核心資安與認證模組時，由主幹帶著完整失敗證據上傳。
• 低強度推理 (Low Effort)：由於輸入材料已包含精準 diff 與失敗日誌，Astra 無需漫長思考即可一眼看出深層盲點，極速裁決後立即重回休眠。

! 僅限必要時喚醒 Cold Standby Low Effort Escalate on Evidence
Role Reviewer Model GPT-6 Astra Status Cold Standby
03 / 成本路由 TOKEN ECONOMICS · ROUTING HIERARCHY
03

成本路由 Cost Routing & Token Economics

運用 $0.10/M 緩存輸入與分級觸發條件，讓 80% 的日常推理完全避開高價旗艦模型。

1/5 Token Price
$0.10 Cached Input
Zero Frontier Waste
01/04
Economics · 6.1 Sol 的 1/5 資費與 $0.10 快取輸入

以旗艦級推理能力的五分之一單價，支撐全日無間斷運算

接近 Astra 水準的高階編碼能力，搭配低廉緩存費率

GPT-6.1 Sol 在程式架構與複雜除錯評測上具備與 Astra 同等量級之水準，但 Token 計費僅為後者的五分之一（1/5）。更關鍵的是其 $0.10 每百萬 token 的緩存讀取費率，使得在多次互動中重讀專案設定、系統提示詞與型態定義的成本幾乎可忽略不計。
這讓一人工程團隊得以在不透支額度的前提下，全天候執行高頻次的原型驗證與重構。

★ 80% 成本節省 1/5 Token Price $0.10 Cache Read Astra Parity
Price Ratio 0.2x Astra Cache Input $0.10/M
02
Offloading · 零成本本地 CPU 工具防線

機械性步驟徹底脫離 LLM，交由本機 CPU 工具零成本執行

讓模型專注決策分支，確定性操作絕不浪費 Token

社群實戰驗證（@Kizuno18、@ADLXBT）：任何具備確定性演算法的工作，均應在本地環境以原生 CLI 工具處置：
• ripgrep / fd：毫秒級掃描檔案目錄與關鍵字，絕不調用 LLM 逐行閱讀目錄。
• AST Parser / Tree-sitter：分析抽象語法樹與函式呼叫關聯，產出結構化清單。
• 本地編譯器與單元測試：由本機 Node/Rust 執行型態檢查與測試斷言，不消耗任何遠端推論成本。

✓ 零 Token 消耗 ripgrep / AST 本地編譯器 Deterministic $0
Cost $0.00 USD Speed <10ms CLI
03
Filter Gate · 雙層本地驗證過濾網

在向旗艦呈報之前，由 Sol 主幹攔截 90% 低階回歸錯誤

只有通過本地自動化沙箱驗證的候選方案，方能進入審查門禁

針對社群成員 @itsthedonhashim 的架構優化建議，在呈報 Astra 之前設立強制本地過濾門禁：
1. Worker 提交程式碼後，由主幹自動觸發本地測試套件（如 npm test 或 cargo test）。
2. 若存在語法錯誤或斷言失敗，直接交由 Sol 原地修復，禁止驚動 Astra。
3. 僅當所有機械測試均為綠燈，但涉及跨服務架構邊界或高風險資安邏輯時，才具備向 Astra 發起獨立審查之資格。

✓ 雙層過濾機制 Local Sandbox 90% 攔截率 Zero Trivial Escalation
Interception 90%+ Gate Rule Test Green
04
Tuning · 非對稱思考強度（Effort）矩陣

依節點任務特性精準配置，拒絕全域 High 的算力黑洞

調度用 medium、工人用 high、旗艦審查用 low

盲目在所有 Agent 上啟用高思考深度只會拉長反饋延遲並倍增輸出支出。代理樹遵循嚴格非對稱矩陣：
• Root (Sol)：設為 medium（或低難度下設 low），保持專案調度敏捷流暢。
• Explorer (Luna)：設為 high，以便宜模型的高思考深度保障目錄檢索無死角。
• Worker (Sol)：設為 high，確保實作邏輯與測試案例滴水不漏。
• Reviewer (Astra)：設為 low，因材料高度精煉，僅需最低思考即可精確裁決。

✓ 矩陣化調控 Root: Medium Luna: High Worker: High Astra: Low
Root Effort Medium Review Effort Low
04 / Codex 落地配置 CODEX CONFIG.TOML & SUBAGENT DEFINITIONS
04

Codex 配置 Codex Harness & Subagents

透過 ~/.codex/config.toml 與專屬代理 TOML 檔案，將代理樹架構直接編譯進 CLI 執行環境。

config.toml
Subagent TOMLs
OpenAI Codex Native
01/04
Config · ~/.codex/config.toml 全域預設子模型

在配置層鎖定低成本基線，預設派發一律走 gpt-6-luna

來自 Codex 官方文檔與社群 @tinprofile 的實裝驗證

無需在每條提示詞中反覆叮嚀模型切換，直接在全域設定檔固化子代理調度底線：
[agents]
default_subagent_model = "gpt-6-luna"
max_parallel_subagents = 4
當 Sol 主幹動態派發探路者或檢索任務時，Codex 執行緒將自動調用極低成本的 Luna 模型，從源頭鎖住 80% 的日常推理開銷。

✓ 官方設定原生支援 config.toml default_subagent_model 全域成本鎖
Config config.toml Default gpt-6-luna Concurrency 4 Max
02
Agent Profile · ~/.codex/agents/review-astra.toml 審查防線

拔除檔案寫入權限，將 Astra 隔離為唯讀獨立審核者

專為獨立審查打造之 Profile，嚴禁參與常規開發與原始碼修改

在 ~/.codex/agents/review-astra.toml 宣告專屬審查代理規格：
name = "review-astra"
model = "gpt-6-astra"
effort = "low"
tools = ["view_file", "search_web"]
enable_write_tools = false
徹底剝離 write_to_file 與 run_command 工具，確保 Astra 僅能提出審核意見與架構修正點，絕無法越權直接改動生產檔案。

! 權限嚴格隔離 Read-Only review-astra Write Disabled
Agent review-astra Write Tool Disabled Effort Low
03
Isolation · 分支隔離模式與防衝突協同

多代理並行不打架：Worker 走 branch 隔離，探路者走唯讀共享

利用 Codex 的 workspace 隔離機制杜絕檔案併發衝突

• 探路者 (Luna)：宣告 workspace = "inherit"，共享當前工作目錄的完整檔案樹，專注快速索引與符號定位。
• 程式碼工人 (Sol)：宣告 workspace = "branch"，在獨立的分支副本中編寫程式碼與測試案例，完全與主幹隔離。
• 主幹整合 (Sol)：Worker 完成後回傳 diff，主幹在本地執行 linter 與測試驗收，通過後始由主幹自動執行合併。

✓ 零衝突協同 Branch Mode Workspace Isolation Clean Merging
Worker Mode Branch Explorer Inherit
04
Protocol · AGENTS.md 委派協議強制約束

將分級路由寫入專案引導文檔，落實「依證據呈報」之鋼鐵法則

約束主幹不得盲目調用旗艦，亦不得盲信子代理回報

在專案 AGENTS.md 中明訂以下協同規則：
1. 遇目錄調查、相依性檢索，一律派發至 Luna 子代理。
2. Worker 交付產出時，主幹必須親自查驗 diff 與測試結果，嚴禁盲目採納口頭結論。
3. 僅在連續兩次修復失敗、或觸及安全防線時，方得附帶完整測試日誌喚醒 review-astra。
4. 任何對外發布、資料庫遷移與資金相關操作，一律等待人類最終授權。

✓ 自律工程規範 AGENTS.md Evidence Check Escalate on Evidence
Doc Target AGENTS.md Rule Strict Handoff
05 / 執行規範與指令庫 PRODUCTION PROMPT TEMPLATES · ONE OWNER PER TASK

實戰提示詞模板與「單一責任人」執行規範

提供調度中樞、探路者與獨立審查者的開箱即用生產級提示詞，落實「依證據呈報」之工程防線。

01 · 調度主幹 · Root Orchestrator

GPT-6.1 Sol 調度中樞母版提示詞

你是工程調度大腦（GPT-6.1 Sol，medium effort）。你的職責是拆解架構需求，按需派發子代理，並在本地沙箱整合驗證產出。
• 遇檔案遍歷與套件文件：立即委派至 default_subagent (Luna)。
• 遇程式碼編寫：委派至 worker 分支，且強制要求提交單元測試。
• 驗收交付：接收 diff 後親自執行本地測試套件，確認綠燈方得合併。
• 鐵律：單一任務單一負責人，無明確測試失敗證據絕不向上呈報 Astra。

02 · 探路與檢索 · Explorer & Researcher

GPT-6 Luna 窄域唯讀探路者指令

你是窄域調查與精確檢索代理（GPT-6 Luna，high effort）。
• 核心任務：快速定位檔案符號、查驗報錯堆疊、擷取第三方套件規格。
• 權限邊界：嚴格維持唯讀模式，禁止修改任何專案檔案或建立暫存檔案。
• 交付格式：以簡潔 Markdown 列出精確檔案路徑、行號與程式碼片段，省略一切社交客套與長篇背景。

03 · 獨立審查者 · Reviewer Astra

GPT-6 Astra 獨立架構與資安審核母版

你是獨立架構與安全審核者（GPT-6 Astra，low effort）。
• 喚醒條件：僅在 Sol 主幹提交具體測試失敗證據、或涉及核心認證/金流修改時介入。
• 審查重點：型態安全性、並發競爭條件、邊界溢出與潛在資安漏洞。
• 交付合約：僅回傳裁決結果（PASS/FAIL）與前 3 大阻擋發布的具體瑕疵點，不直接編寫或修改程式碼。

04 · 工程鐵律 · Four Iron Guardrails

防範算力黑洞的 四項絕對禁忌

1. 禁止無端調用旗艦：常規程式碼改動與除錯禁止直連 Astra，嚴格守住 80% 預算紅線。
2. 禁止無界全域漫遊：Luna 調查必須限定目標目錄或符號，禁止全專案無差別傾印。
3. 禁止無測試裸奔交付：Worker 產出的每一段程式碼均必須伴隨可執行的測試案例。
4. 禁止繞過人工直接發布：生產合併、雲端支付與資料清除必須強制保留人工終端審批。

想為你的工程團隊導入 Codex 分級代理樹？

樹狀拓撲已經開源。
接上 企業交付管線這一段，
是 Tenten 在做的事。

Tenten 是 AI-First 設計與技術顧問公司。我們協助軟體工程團隊將 OpenAI Codex、GPT-6.1 Sol、Luna 與 Astra 審核網接進真實 CI/CD 流程 — 透過成本分級路由與本地工具過濾，讓你的團隊以 1/5 預算達成 5 倍交付產能。

預約 30 分鐘架構諮詢 → 查看原始推文 · @cyrilXBT
Tenten 如何協助你部署 Codex 代理樹
Codex 代理拓撲設計
依既有代碼庫與任務邊界配置 Sol、Luna 與 Astra 專屬 TOML，鎖定全域成本。
本地 CPU 工具防線整合
整合 ripgrep、AST 解析與自動化沙箱測試，在進入雲端推論前攔截 90% 錯誤。
企業級 CI/CD 審核門禁
落實「依證據呈報」與人在迴路審查機制，確保自主代理產出無縫併入 Production。