codex-cli-review

用途

codex-cli-review 是一个通过 Codex CLI 执行代码审查的技能（Skill），具备完整磁盘读取权限（full disk access）。它主要用于需要 Codex 独立探索整个项目（全盘读取）的场景，以及对未提交变更（uncommitted changes）进行审查。

触发关键词：codex cli review、cli review、script review。

适用与不适用场景

适用场景：

需要 Codex 独立探索整个项目（全盘读取）
不需要 MCP 的上下文持久化（context persistence）功能
希望使用 Codex CLI 的原生审查格式

不适用场景：

需要迭代审查（应使用 /codex-review-fast --continue）
需要跟进 Codex（应使用 MCP 版本）
只想查看 diff 而不等待 Codex 探索（应使用 /codex-review-fast）

与 MCP 版本的差异

独立探索：CLI 版本支持全盘读取；MCP 版本需要显式指示
上下文持久化：CLI 版本无；MCP 版本使用 threadId
迭代审查：CLI 版本每次运行相互独立；MCP 版本支持 --continue
格式：CLI 版本使用 Codex 原生格式；MCP 版本使用自定义提示格式
执行方式：CLI 版本通过脚本调用；MCP 版本通过 MCP 工具调用

工作流程

步骤 1：检查变更

执行 git status --porcelain
无变更则提前退出

步骤 2：执行 Codex CLI

命令：codex review --uncommitted -c 'sandbox_permissions=["disk-full-read-access"]'
Codex 将独立完成：读取变更文件、探索相关依赖、检查现有测试、理解项目结构

步骤 3：输出审查结果

采用 Codex 原生格式：摘要（Summary）、问题（Issues，分为 Critical/Major/Minor/Suggestion）、建议（Recommendations）

使用方式

脚本调用：

bash skills/codex-cli-review/scripts/review.sh [options]

选项参数：

--base <branch>：与指定分支进行比较
--title "<text>"：设置审查标题
--prompt "<text>"：自定义审查指令

输入/输出契约：

输入：包含变更的 Git 工作目录
输出：Codex 审查报告（stdout）
退出码：0 表示成功，非 0 表示失败

输出格式示例：

Codex CLI Review Report

Findings

P0/P1/P2

[file:line] Issue → Fix recommendation

Merge Gate

✅ Ready / ⛔ Blocked

验证要点

脚本执行无错误
Codex 已探索项目（输出中可见文件引用）
输出包含问题分类

使用示例

审查未提交的变更

/codex-cli-review

与 main 分支比较

/codex-cli-review --base main

带标题

/codex-cli-review --title "Feature: User Auth"

自定义审查指令

/codex-cli-review --prompt "Focus on security and performance"

技能介绍

用途