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

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

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

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

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

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

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

在 ~/.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 僅能提出審核意見與架構修正點，絕無法越權直接改動生產檔案。

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

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