Agent Skills › openai/codex-plugin-cc › codex-cli-runtime

codex-cli-runtime

GitHub

Codex运行时辅助技能，用于在救援子代理中调用codex-companion执行任务。负责参数映射、提示词重写及结果透传，禁止自行分析或修改代码，确保请求准确转发至后端引擎。

plugins/codex/skills/codex-cli-runtime/SKILL.md openai/codex-plugin-cc

Trigger Scenarios

需要在codex-rescue子代理中调用Codex运行时需要将用户请求转化为Codex task命令并转发

Install

npx skills add openai/codex-plugin-cc --skill codex-cli-runtime -g -y

More Options

Non-standard path

npx skills add https://github.com/openai/codex-plugin-cc/tree/main/plugins/codex/skills/codex-cli-runtime -g -y

Use without installing

npx skills use openai/codex-plugin-cc@codex-cli-runtime

指定 Agent (Claude Code)

npx skills add openai/codex-plugin-cc --skill codex-cli-runtime -a claude-code -g -y

安装 repo 全部 skill

npx skills add openai/codex-plugin-cc --all -g -y

预览 repo 内 skill

npx skills add openai/codex-plugin-cc --list

SKILL.md

Frontmatter

{
    "name": "codex-cli-runtime",
    "description": "Internal helper contract for calling the codex-companion runtime from Claude Code",
    "user-invocable": false
}

Codex Runtime

Use this skill only inside the codex:codex-rescue subagent.

Primary helper:

node "${CLAUDE_PLUGIN_ROOT}/scripts/codex-companion.mjs" task "<raw arguments>"

Execution rules:

The rescue subagent is a forwarder, not an orchestrator. Its only job is to invoke task once and return that stdout unchanged.
Prefer the helper over hand-rolled git, direct Codex CLI strings, or any other Bash activity.
Do not call setup, review, adversarial-review, status, result, or cancel from codex:codex-rescue.
Use task for every rescue request, including diagnosis, planning, research, and explicit fix requests.
You may use the gpt-5-4-prompting skill to rewrite the user's request into a tighter Codex prompt before the single task call.
That prompt drafting is the only Claude-side work allowed. Do not inspect the repo, solve the task yourself, or add independent analysis outside the forwarded prompt text.
Leave --effort unset unless the user explicitly requests a specific effort.
Leave model unset by default. Add --model only when the user explicitly asks for one.
Map spark to --model gpt-5.3-codex-spark.
Default to a write-capable Codex run by adding --write unless the user explicitly asks for read-only behavior or only wants review, diagnosis, or research without edits.

Command selection:

Use exactly one task invocation per rescue handoff.
If the forwarded request includes --background or --wait, treat that as Claude-side execution control only. Strip it before calling task, and do not treat it as part of the natural-language task text.
If the forwarded request includes --model, normalize spark to gpt-5.3-codex-spark and pass it through to task.
If the forwarded request includes --effort, pass it through to task.
If the forwarded request includes --resume, strip that token from the task text and add --resume-last.
If the forwarded request includes --fresh, strip that token from the task text and do not add --resume-last.
--resume: always use task --resume-last, even if the request text is ambiguous.
--fresh: always use a fresh task run, even if the request sounds like a follow-up.
--effort: accepted values are none, minimal, low, medium, high, xhigh.
task --resume-last: internal helper for "keep going", "resume", "apply the top fix", or "dig deeper" after a previous rescue run.

Safety rules:

Default to write-capable Codex work in codex:codex-rescue unless the user explicitly asks for read-only behavior.
Preserve the user's task text as-is apart from stripping routing flags.
Do not inspect the repository, read files, grep, monitor progress, poll status, fetch results, cancel jobs, summarize output, or do any follow-up work of your own.
Return the stdout of the task command exactly as-is.
If the Bash call fails or Codex cannot be invoked, return nothing.