- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add boshu2/agentops --skill codex-exec -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add boshu2/agentops --skill codex-exec -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add boshu2/agentops --skill codex-exec -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add boshu2/agentops --skill codex-exec -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/boshu2/agentops/tree/HEAD/plugin/skills/codex-exec来自发布者
Run exactly one caller-supplied Codex prompt as one process and capture its result. This skill does not choose work, retry, validate or continue. It worked when the command closes stdin, uses the sandbox the declared effects need, runs under one deadline fixed before the first attempt, and the report names the exit code's meaning instead of calling a timeout a result.
-s read-only for review or analysis,
workspace-write only for authorized edits, and network or wider access only
when the caller explicitly requires those effects. "In case it needs it" is
not a declared effect. -s limits only Codex's shell commands; the user's
config.toml still starts its MCP servers. For review and CI add
--ignore-user-config (auth still loads), or report the inherited MCP
servers as undeclared effects. A permission denial inside the run (EPERM,
"Operation not permitted") shows only what the mode blocks, not whether the
host or the code would fail. Quote it and list the check under
not_as_briefed as sandbox-limited: neither a pass nor a failed check. A
host-side observation still stands; a host run is the caller's decision.--ephemeral writes no session
file under $CODEX_HOME/sessions. A validator whose
judgment receipt the
caller requires runs without --ephemeral, and the caller copies that
run's rollout-*.jsonl into protected evidence storage. Add --ephemeral
only when no receipt is required.codex exec reads the prompt from stdin when no prompt
argument is given, and appends piped stdin to a prompt argument. A non-TTY run
(CI, a script) with an open stdin can wait forever: the stdin hang. Feed
the prompt on stdin and let it end, or redirect </dev/null.In an AgentOps source checkout, use the guarded library. It enforces the deadline, the combined output cap (10 MiB default), process-group cleanup and echo detection:
# AGENTOPS_ROOT: the agentops source checkout. DEADLINE_EPOCH: absolute Unix
# time fixed once by the caller and reused by every invocation in its scope.
. "$AGENTOPS_ROOT/scripts/lib/codex-exec.sh"
CODEX_EXEC_EXTRA_ARGS=(--ignore-user-config) # add --ephemeral only when no receipt is required
CODEX_EXEC_DIR="$WORKSPACE" CODEX_EXEC_SANDBOX=read-only \
CODEX_EXEC_PROMPT_FILE="$PROMPT_FILE" CODEX_EXEC_DEADLINE_EPOCH="$DEADLINE_EPOCH" \
CODEX_EXEC_MAX_OUTPUT_BYTES=10485760 CODEX_EXEC_OUT_FILE="$OUTPUT" \
codex_exec_guarded </dev/null
Outside a Git repository add CODEX_EXEC_SKIP_GIT_CHECK=1; to keep the final
message outside the cap, add -o "$LAST" to that array (assigned on its own line).
An installed skill ships no scripts, so scripts/lib/codex-exec.sh is absent
outside a source checkout. Run codex exec directly instead, with bash or zsh
(flags as of codex-cli 0.163.0; confirm with codex exec --help; add
--skip-git-repo-check and -o <file> as above):
case "${DEADLINE_EPOCH:-}" in ''|0*|*[!0-9]*) echo "no valid deadline; not launched" >&2; exit 2;; esac
TO=$(command -v timeout || command -v gtimeout) || { echo "no timeout; not launched" >&2; exit 2; }
remaining=$(( DEADLINE_EPOCH - $(date +%s) - 10 )) # keep the 10 s KILL grace inside
[ "$remaining" -gt 0 ] || { echo "deadline passed or within 10 s; not launched" >&2; exit 124; }
set -o pipefail # bash and zsh: $? is the failing stage, not head's
"$TO" -k 10 "$remaining" \
codex exec --ignore-user-config -C "$WORKSPACE" -s read-only - <"$PROMPT_FILE" 2>&1 \
| head -c 10485760 >"$OUTPUT"
rc=$? # 124 timed out, 137 killed after grace, 127 no codex, else codex's status
An output file exactly at the cap was truncated, and its status reflects the closed pipe, not a review. The fallback has no survivor check or echo detection; report both as not enforced.
Reserved codes are runtime evidence, never a semantic verdict. A Codex 124 or
137 returns 124 with the STALL line; a Codex 2, 122, 123, 129, 130 or 143
returns with no codex-exec: stderr line, so check stderr, the capture and
elapsed time before reading one as the runner's.
Guarded runner internals covers inputs, host
requirements, process supervision and the external sandbox wrapper.
command: exact argv or library call (prompt by reference)
sandbox: -s value and the declared effect that needs it
bound: absolute deadline and seconds remaining at launch
capture: output path, byte cap, truncated yes/no
exit: status and its meaning from the table
cleanup: library result, or "not enforced" for the direct fallback
not_as_briefed: steps the output reports refused or sandbox-limited, quoted | none reported
A Codex validator follows the judgment receipt convention and the model-dispatch recipe: a requested model flag or the model's own description does not prove which model ran.
Run one prompt through headless Codex and capture the result. Use when: wanting a one-shot `codex exec` run or CI step. Not for batches or retries.
---name: codex-execdescription: Run one prompt through headless Codex and capture the result. Use when: wanting a one-shot `codex exec` run or…---# plugin/skills/codex-exec/SKILL.md常见问题
从发布者处下载 plugin/skills/codex-exec/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/boshu2/agentops。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。