用途:在任意 AI 编码会话中运行 Codex 伴随运行时,管理后台任务、可恢复的多轮任务线程、对抗式代码审查以及任务生命周期(status、result、cancel)。
主要能力:提供 review(对当前仓库或基线分支做差异感知审查)、adversarial-review(结构化、以攻击视角优先给出发现的审查)、task(把诊断、研究或实现委派给持久化 Codex 线程)、status、result、cancel 等子命令。review 与 adversarial-review 为只读;task 可配置写入。对抗式审查返回符合 schema 的结构化结果,含 verdict、findings[](severity、title、body、file、line_start、line_end、confidence、recommendation)、summary、next_steps。所有命令支持 --json。
使用方式:脚本路径为 $SKILL_DIR/scripts/codex-companion.mjs。快速开始:node "$SKILL_DIR/scripts/codex-companion.mjs" review --base main;node "$SKILL_DIR/scripts/codex-companion.mjs" task "fix the bug";node "$SKILL_DIR/scripts/codex-companion.mjs" status;node "$SKILL_DIR/scripts/codex-companion.mjs" result <job-id>。可先设 COMPANION 变量再调用。继续先前工作时用 task --resume-last。
适用场景:需要稍后查看的后台任务、可恢复多轮任务线程、结构化对抗审查、任务生命周期管理时使用 codex-companion;一次性手动 codex review 或 codex exec 用 codex skill。
限制与前提:需已安装 Codex CLI(command -v codex 或 Get-Command codex),缺失时 npm install -g @openai/codex;未认证则 codex login,浏览器登录受阻可用 codex login --device-auth 或 codex login --with-api-key。任务状态默认存于系统临时目录 $TMPDIR/codex-companion/,每工作区最多保留 50 个任务,超出自动清理。该技能不实现 Claude 专属钩子或停止时审查门。其他细节暂未提供。