S
SkillNav

Codex CLI守护者

codex-cli-guardian

by alukardo

Codex CLI 会话守护者。管理 API Key、任务执行与结果摘要。提供后台模式运行、API Key 验证、会话锁定与PID追踪等功能。

4.2k效率与工作流未扫描2026年4月13日

安装

claude skill add --url https://github.com/openclaw/skills

文档

Codex-CLI-Guardian

Codex CLI 会话守护者 — 管理 API Key、任务执行与结果摘要

技能职责

  1. API Key 管理 — 首次引导输入并验证，验证通过才写入（init-setup）；codex-call 直接读取 credentials.env，不重复验证
  2. 任务执行 — 后台模式运行 Codex，主人可继续聊天
  3. 结果摘要 — 使用 -o 输出文件，只保存 Codex 完成语
  4. 并发控制 — PID 锁防止多任务同时执行
  5. 状态追踪 — 实时记录任务状态，支持超时警告
  6. Worker 编排 — 提供标准化 Worker 模板和编排模式

不是：coding-agent 的替代品，是其底层基础设施。

调用方式（重要）

必须使用 background:true，否则主 agent 会等待 Codex 执行完毕才响应：

bash
exec:
  command: bash bin/codex-call.sh "任务描述"
  background: true   # ← 必须加，默认行为

不加 background:true → 主 agent 阻塞 → 无法中途回复主人 加 background:true → 主 agent 立即返回 → 可以继续聊天

标准调用方式：

bash
exec background:true command:"bash bin/codex-call.sh \"任务描述\""

进度/状态查询（不走 exec，直接读文件）：

bash
# 读 state/current-task.json
# 读 state/tasks/ 最新任务历史

原因：进度查询走 exec 反而会产生新的 exec，形成嵌套，效率低。

多步骤任务编排

当主人描述的任务涉及多个阶段时，会自动加上步骤指引，引导 Codex 依次执行：

code
请按以下步骤执行：
1. 【侦察】先摸清现状和关键文件
2. 【评审】分析风险和可行方案
3. 【实施】执行核心工作
4. 【验证】确认结果正确

每步完成后简报。

常用步骤组合：

场景步骤组合
代码重构侦察 → 评审 → 实施 → 验证
复杂开发需求确认 → 搭建框架 → 核心功能 → 测试
Bug 修复复现 → 定位 → 修复 → 验证
批量修改扫描 → 分析 → 执行 → 确认

触发场景

两层确认机制

第一层：触发关键词

主人说以下内容时，进入「意图确认」流程：

关键词触发场景
写代码「帮我写代码」
写个「帮我写个爬虫」「写个脚本」
写一个「写一个计算器」
开发「帮我开发一个 API」
重构「帮我重构这个模块」
Codex「用 Codex 写」「用 Codex 跑」
脚本「写个脚本处理数据」
程序「写个程序」
/codex-guardian管理命令前缀

注意：单独说「代码」「谢谢」等词不触发。

第二层：确认流程

检测到关键词后，回复确认：

code
🔍 检测到代码开发意图，要用 Codex 执行吗？

任务：帮我写一个爬虫

→ 直接回「是」/「好」/「执行」 → 执行
→ 回「不用」/「取消」 → 取消

主人确认后，执行 codex-call.sh，后台运行。

触发短语（agent 识别后执行，无需确认）

触发短语执行动作
任务进度读取 state/current-task.json 展示状态
终止任务调用 session.sh kill
任务历史调用 session.sh list
/codex-guardian status调用 session.sh status
/codex-guardian reset调用 session.sh reset

执行步骤

code
1. 主人发起任务
      ↓
2. codex-call.sh 加载 Key（文件不存在 → 触发 init-setup）
      ↓
3. 检查 PID 锁 → 被占用 → 拒绝
      ↓（空闲）
4. 生成 task_id（如 20260404-001）
      ↓
5. 写入 state/current-task.json（status: running）
      ↓
6. codex-call.sh 启动后台子进程执行 codex exec
      ↓
7. codex-call.sh 主进程立即返回 task_id（不阻塞）
      ↓
8. Codex 执行中（主人可继续聊其他事）
      ↓
9. Codex 完成 → 写 state/tasks/<task_id>.json（摘要）
      ↓
10. 通知主人任务完成

超时策略：不自动终止。超时后继续运行，主人可随时说「终止任务」。

PID 锁逻辑

code
进入 → 检查 lock 文件 → PID 存在且进程存活 → 拒绝
                              → PID 不存在或进程已死 → 清理 → 继续

命令接口

codex-call.sh

bash
bash bin/codex-call.sh "<任务描述>"
  • 返回：{"task_id":"...","pid":...}
  • 始终后台执行，不阻塞

session.sh

bash
bash bin/session.sh status   # 健康检查（含超时警告）
bash bin/session.sh list     # 列出最近任务
bash bin/session.sh kill     # 终止当前任务
bash bin/session.sh reset    # 重置状态（不清历史）

init-setup.sh

bash
bash scripts/init-setup.sh        # 交互式设置向导
bash scripts/init-setup.sh check # 仅检查状态
  • 首次引导：输入 Key → 验证通过才写入
  • 已有 Key：询问是否重设

输出标准

任务完成

code
🚀 已启动任务 [20260404-001]：帮我写个爬虫
（后台执行中，你可以继续聊其他事情）

✅ 任务 [20260404-001] 完成：
spider.py 已创建完成，包含以下功能：
- 支持多页面爬取
- 自动去重

任务失败

code
❌ 任务 [20260404-001] 失败：
原因：API Key 无效或已过期

忙碌拒绝

code
⚠️ Codex 忙碌中，请稍后再试。

健康检查

code
=== Codex Guardian 状态 ===
任务状态   : idle
累计任务   : 5
最后使用   : 3 分钟前
当前任务   : 无

超时警告（>=25 分钟）

code
运行时长   : 25 分钟 / 30 分钟 ⚠️ 即将超时
如需终止任务，请说：「终止任务」

文件清单

路径用途
credentials.envAPI Key（skill 目录内，600 权限）
state/current-task.json运行中任务
state/tasks/*.json历史任务摘要
state/codex.lockPID 锁文件

安全原则

  1. API Key 不落日志
  2. credentials.env 权限 600
  3. credentials.env 已被 .gitignore 忽略，不会被 git 提交
  4. init-setup 验证 Key 通过才写入，失败不保存（codex-call 不验证 Key）

参见

  • REFERENCES.md — 完整格式标准
  • CLI.md — Codex CLI 正确用法
  • workers/ — Worker 模板
    • standard-preamble.md — Worker 前言
    • reviewer.md — 评审者
    • researcher.md — 研究者
    • implementer.md — 实现者
    • verifier.md — 验证者
    • scout.md — 侦察者
    • context-pack.md — Context Pack
    • patterns.md — 编排模式

相关 Skills

PPT处理

by anthropics

Universal
热门

处理 .pptx 全流程：创建演示文稿、提取和解析幻灯片内容、批量修改现有文件，支持模板套用、合并拆分、备注评论与版式调整。

✎ 涉及PPTX的创建、解析、修改到合并拆分都能一站搞定，连备注、模板和评论也能处理，做演示文稿特别省心。

效率与工作流
未扫描119.1k

技能工坊

by anthropics

Universal
热门

覆盖 Skill 从创建到迭代优化全流程：起草能力、补测试提示、跑评测与基准方差分析，并持续改写内容和描述，提升效果与触发准确率。

✎ 技能工坊把技能从创建、迭代到评测串成闭环，方差分析加描述优化，特别适合把触发准确率打磨得更稳。

效率与工作流
未扫描119.1k

Word文档

by anthropics

Universal
热门

覆盖Word/.docx文档的创建、读取、编辑与重排，适合生成报告、备忘录、信函和模板，也能处理目录、页眉页脚、页码、图片替换、查找替换、修订批注及内容提取整理。

✎ 搞定 .docx 的创建、改写与精排版，目录、批量替换、批注修订和图片更新都能自动化，做正式文档尤其省心。

效率与工作流
未扫描119.1k

相关 MCP 服务

文件系统

编辑精选

by Anthropic

热门

Filesystem 是 MCP 官方参考服务器，让 LLM 安全读写本地文件系统。

✎ 这个服务器解决了让 Claude 直接操作本地文件的痛点，比如自动整理文档或生成代码文件。适合需要自动化文件处理的开发者，但注意它只是参考实现，生产环境需自行加固安全。

效率与工作流
83.9k

io.github.wonderwhy-er/desktop-commander

编辑精选

by wonderwhy-er

热门

Desktop Commander 是让 AI 直接执行终端命令、管理文件和进程的 MCP 服务器。

✎ 这工具解决了 AI 无法直接操作本地环境的痛点，适合需要自动化脚本调试或文件批量处理的开发者。它能让你用自然语言指挥终端，但权限控制需谨慎，毕竟让 AI 执行 rm -rf 可不是闹着玩的。

效率与工作流
5.9k

EdgarTools

编辑精选

by dgunning

热门

EdgarTools 是无需 API 密钥即可解析 SEC EDGAR 财报的开源 Python 库。

✎ 这个工具解决了金融数据获取的痛点——直接让 AI 读取结构化财报，比如让 Claude 分析苹果的 10-K 文件。适合量化分析师或金融开发者快速构建数据管道。但注意，它依赖 SEC 网站稳定性，高峰期可能延迟。

效率与工作流
2.0k

评论