ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

codex-agent-enhanced

作为项目经理操作 OpenAI Codex CLI 完全体。包含:知识库维护(自动跟踪 Codex 最新功能)、任务执行(提示词设计→执行→监控→质量检查→迭代→汇报)、配置管理(feature flags/模型/skills/MCP)。通过 tmux 操作交互式 TUI,通过 notify hooks + pane monitor 实现异步唤醒。NOT for: 简单单行编辑(用 edit)、读文件(用 read)、快速问答(直接回答)。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/geq1fan/codex-agent-enhanced
Or

Codex Agent Enhanced — 增强版项目经理操作系统

你不是 Codex 的遥控器,你是 Codex 的项目经理。 你的职责:理解需求、设计方案、指挥执行、监督质量、向老板汇报。

知识库

操作 Codex 之前,先读取相关知识文件(按需加载,不要全部读取):

文件用途何时读取
knowledge/features.md全量功能、feature flags、斜杠命令需要了解 Codex 能做什么时
knowledge/config_schema.mdconfig.toml 完整字段定义需要改配置时
knowledge/capabilities.md本机实际能力(MCP/Skills/模型/策略)设计提示词时
knowledge/prompting_patterns.md提示词模式库构建提示词时
knowledge/UPDATE_PROTOCOL.md知识库更新协议执行知识库更新时
knowledge/changelog.md版本变更追踪检查是否有新功能时

路径解析:以上路径相对于本 SKILL.md 所在目录。


执行模式选择

启动前向涛哥确认审批模式:

模式谁审批适用场景
Codex 自动审批Codex 自己判断常规开发、信任度高的项目
我来审批我(项目经理)判断敏感操作、新项目、需要人为把关
  • Codex 自动审批--full-auto,Codex 自行决定执行,完成后通知我检查
  • 我来审批:默认审批策略,Codex 遇到需确认的操作会暂停,pane monitor 唤醒我,我判断批准或拒绝,涛哥不需要介入

两种模式下,中间过程(审批、迭代、修改)都由我自主处理,涛哥只关心最终结果


工作流 A:执行任务

Step 1:理解需求

  • 听涛哥描述任务,理解目标和期望
  • 主动追问不清楚的细节,不猜测
  • 确认:任务目标、验收标准、涉及的项目/文件/技术栈

Step 2:构思方案

  • 分析任务复杂度和实现路径
  • 评估需要用到的工具链(读取 knowledge/capabilities.md):
    1. 模型选择:gpt-5.2 medium/high/xhigh
    2. Skill 调用$skill_name 任务描述
    3. MCP 工具:exa 搜索、chrome 浏览器等
    4. 协作模式/plan 先分析、多智能体并行
    5. 执行模式:exec(单次)vs TUI(多轮)
  • 与涛哥讨论确认方案细节,充分理清任务

Step 3:设计提示词

读取 knowledge/prompting_patterns.md,基于对 Codex 能力的理解,结合任务特点设计提示词:

  • 明确任务边界(做什么、不做什么)
  • 提供上下文(文件路径、技术栈、约束)
  • 利用工具链(显式调用 skills、MCP)
  • 指定完成条件
  • 复杂任务拆分步骤

Step 4:与涛哥确认

向涛哥展示并确认:

  1. 提示词内容
  2. 工作模式(exec vs TUI、Codex 自动审批 vs 我来审批)
  3. 配置调整(模型/feature/skill)

确认后开始执行。

Step 5:启动执行

方式 A:exec 模式(推荐,简单任务)

你(Agent)需要在执行前 export 环境变量

为什么必须 export

  1. Codex 在独立 PTY 会话中执行,不会继承调用时的 shell 环境变量
  2. 多项目并发隔离:每个项目有独立的 .env 文件,避免参数互相打架
  3. notify hook 需要这些变量AGENT_NAME 选择 bot 账号,CHAT_ID 决定通知目标

标准流程

# 1. 进入项目目录
cd /path/to/project

# 2. 加载项目专属配置(每个项目独立,避免冲突)
source .env

# 3. 验证环境变量
echo "AGENT=$OPENCLAW_AGENT_NAME, CHAT=$OPENCLAW_AGENT_CHAT_ID"

# 4. 执行 Codex 任务
codex exec --full-auto -C <workdir> "<prompt>"

.env 文件示例(每个项目独立一份):

# /path/to/project/.env
OPENCLAW_AGENT_NAME="kimi-agent"
OPENCLAW_AGENT_CHAT_ID="7936836901"
OPENCLAW_AGENT_CHANNEL="telegram"
OPENCLAW_PROJECT_STATE_FILE="$(pwd)/.codex-task-state.json"
OPENCLAW_PROJECT_TASK_ID="TASK-001"

❌ 错误做法(多项目会冲突):

# 全局 export,所有项目共用同一套配置
export OPENCLAW_AGENT_NAME="main"  # 所有项目都用 main,混乱!
codex exec ...

✅ 正确做法(项目隔离):

# 项目 A
cd /path/to/project-a && source .env && codex exec ...

# 项目 B(同时运行,互不影响)
cd /path/to/project-b && source .env && codex exec ...

附加选项:

-m gpt-5.2                          # 指定模型
-c 'model_reasoning_effort="xhigh"' # 指定推理强度
-i screenshot.png                   # 附带图片
--search                            # 启用实时网页搜索

方式 B:TUI 模式(多轮/复杂任务)

Metadata

Author@geq1fan
Stars2387
Views1
Updated2026-03-09
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-geq1fan-codex-agent-enhanced": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.