codex

Codex 是一項為 Hermes Agent 設計的專業技能，旨在將代理與 OpenAI Codex CLI 連結，實現直接在終端機內進行複雜、自主的程式碼操作。此技能主要針對軟體工程師、開發人員及 DevOps 從業人員，他們需要自動化複雜的編程工作流程、管理技術債或在多個專案中處理重複的批次操作。透過利用 Codex CLI，代理能作為自主編碼助手，與本地檔案系統及版本控制記錄進行互動。

• 執行單次編碼任務，例如實作新功能、草擬重構建議或編寫單元測試。

• 執行自動化 Pull Request (PR) 審查，將目標分支複製到暫時工作區，並利用 Codex 分析與基礎分支的差異。

• 進行批次問題修復，透過建立並行的 Git 工作樹 (worktrees)，讓代理的多個執行個體能同時解決不同的錯誤，互不干擾。

• 支援多種執行模式，包括全自動模式 (針對自動批准的沙盒修改) 以及 YOLO 模式 (針對高速、直接的修改)。

• 先進的流程管理能力，允許代理在背景處理長時間執行的操作，並透過終端機輸入進行監控、查詢進度及介入批准。

• 前置需求：確保已安裝 Node.js 以執行 npm 套件 @openai/codex，並配置有效的 OpenAI API 金鑰。

• 執行環境：此技能嚴格要求在 Git 儲存庫環境下運行；若需進行草稿工作，請使用建議的模式：先建立暫時目錄並初始化 Git 儲存庫，再執行指令。

• PTY 需求：在終端機呼叫中務必設定 pty=true 以保持互動性，因為 Codex 是終端機應用程式，若沒有虛擬終端將會導致程式掛起。

• 資源管理：針對長程任務請使用 background=true，並利用提供的流程管理工具 (poll, log, submit, kill) 有效監控及控制代理狀態。

• 安全性：使用 --yolo 旗標時請務必謹慎，因為它會繞過沙盒保護並直接寫入檔案系統；建議僅在低風險或隔離的測試環境中使用。