Codex代码审查技能：AI智能代码审核工具，自动化检查与CHANGELOG更新

codex-review by benedictking/codex-review

323 周安装量

11 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/benedictking/codex-review --skill codex-review

开发自动化代码规范

🇨🇳中文介绍

Codex 代码审查技能

触发条件

当用户输入包含以下内容时触发：

“代码审核”、“代码审查”、“审查代码”、“审核代码”
“review”、“code review”、“review code”、“codex 审核”
“帮我审核”、“检查代码”、“审一下”、“看看代码”

核心概念：意图 vs 实现

单独运行 codex review --uncommitted 只向 AI 展示了“做了什么（实现）”。先记录意图则告诉 AI“你原本想做什么（意图）”。

“代码变更 + 意图描述”作为组合输入是提高 AI 代码审查质量最有效的方式。

技能架构

本技能分两个阶段运行：

准备阶段（当前上下文）：检查工作目录，更新 CHANGELOG
审查阶段（隔离上下文）：调用 Task 工具执行 Lint + codex review（使用上下文：fork 以减少上下文浪费）

执行步骤

0. [第一步] 检查工作目录状态

git diff --name-only && git status --short

根据输出决定审查模式：

存在未提交的更改 → 继续执行步骤 1-4（正常流程）
工作目录干净 → 直接调用 codex-runner：codex review --commit HEAD

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. [强制] 检查 CHANGELOG 是否已更新

在任何审查之前，必须检查 CHANGELOG.md 是否包含当前变更的描述。

# 检查 CHANGELOG.md 是否在未提交的更改中
git diff --name-only | grep -E "(CHANGELOG|changelog)"

如果 CHANGELOG 未更新，你必须自动执行以下操作（不要要求用户手动操作）：

分析变更：运行 git diff --stat 和 git diff 以获取完整的变更信息
自动生成 CHANGELOG 条目：根据代码变更生成合规的条目
写入 CHANGELOG.md：使用 Edit 工具将条目插入到 [Unreleased] 部分的顶部
继续审查流程：CHANGELOG 更新后立即进行后续步骤

自动生成的 CHANGELOG 条目格式：

## [Unreleased]

### Added / Changed / Fixed

- 功能描述：解决了什么问题或实现了什么功能
- 影响文件：主要修改的文件/模块

示例 - 自动生成流程：

1. 检测到 CHANGELOG 未更新
2. 运行 git diff --stat，发现 handlers/responses.go 被修改（+88 行）
3. 运行 git diff 分析详情：添加了 CompactHandler 函数
4. 自动生成条目：
   ### Added
   - 添加了 `/v1/responses/compact` 端点用于对话上下文压缩
   - 支持多通道故障转移和请求体大小限制
5. 使用 Edit 工具写入 CHANGELOG.md
6. 继续执行 lint 和 codex review

2. [关键] 暂存所有新文件

在调用 codex review 之前，必须将所有新文件（未跟踪的文件）添加到 git 暂存区，否则 codex 将报告 P1 错误。

# 检查新文件
git status --short | grep "^??"

如果存在新文件，自动执行：

# 安全地暂存所有新文件（处理空列表和特殊文件名）
git ls-files --others --exclude-standard -z | while IFS= read -r -d '' f; do git add -- "$f"; done

-z 使用空字符分隔文件名，正确处理包含空格/换行符的文件名
while IFS= read -r -d '' 逐个读取文件名
git add -- "$f" 使用 -- 分隔符，正确处理以 - 开头的文件名
当没有新文件时，循环体不执行，安全跳过
这不会暂存已修改的文件，仅处理新文件
codex 需要文件被 git 跟踪才能进行适当的审查

3. 评估任务难度并调用 codex-runner

统计变更规模：

# 获取所有变更（已暂存 + 未暂存）的摘要行
# 重要：必须使用 'HEAD' 作为基准以包含已暂存和未暂存的变更
git diff --stat HEAD | tail -1

为什么使用 git diff --stat HEAD：

git diff --stat 只显示未暂存的变更
git diff --cached --stat 只显示已暂存的变更
git diff --stat HEAD 显示已暂存和未暂存的变更总和
最后一行（tail -1）是包含总文件数和行变更的摘要行

难度评估标准：

模型 + 推理努力组合：

组合	质量	时间	超时	推荐用于
`model=gpt-5.2 model_reasoning_effort=xhigh`	最佳	~15-20 分钟	40 分钟	关键代码、架构变更
`model=gpt-5.3-codex model_reasoning_effort=xhigh`	高	~8-9 分钟	15 分钟	困难任务（默认）
`model=gpt-5.2 model_reasoning_effort=high`	高	~8-9 分钟	15 分钟	困难任务的替代方案
`model=gpt-5.3-codex model_reasoning_effort=high`	良好	~5-6 分钟	10 分钟	普通任务（默认）

关键任务（满足任一条件，使用最佳质量模型）：

修改文件数 ≥ 30
总代码变更（新增行 + 删除行）≥ 2000 行
涉及核心架构/算法变更（用户明确提及）
配置：--config model=gpt-5.2 --config model_reasoning_effort=xhigh，超时 40 分钟

困难任务（满足任一条件）：

修改文件数 ≥ 10
总代码变更（新增行 + 删除行） ≥ 500 行
单项指标：新增行 ≥ 300 行或删除行 ≥ 300 行
跨模块重构
默认配置：--config model=gpt-5.3-codex --config model_reasoning_effort=xhigh，超时 15 分钟

普通任务（其他情况）：

默认配置：--config model=gpt-5.3-codex --config model_reasoning_effort=high，超时 10 分钟

你必须正确解析 git diff --stat HEAD 的输出以确定难度：

# 获取摘要行（git diff --stat HEAD 的最后一行）
git diff --stat HEAD | tail -1
# 示例输出：
# "20 files changed, 342 insertions(+), 985 deletions(-)"
# "1 file changed, 50 insertions(+)"  # 无删除
# "3 files changed, 120 deletions(-)"  # 无新增

关键：为什么摘要行很重要：

每个文件显示单独的统计信息：file.go | 171 ++++++++++++++++++++-
只有最后一行有总计：6 files changed, 1341 insertions(+), 18 deletions(-)
你必须使用 tail -1 提取最后一行以获得准确的总数

从 “X file(s) changed” 中提取文件数（处理 “1 file” 和 “N files” 两种情况）
如果存在，从 “Y insertion(s)(+)” 中提取新增行数（处理 “1 insertion” 和 “N insertions” 两种情况），否则为 0
如果存在，从 “Z deletion(s)(-)” 中提取删除行数（处理 “1 deletion” 和 “N deletions” 两种情况），否则为 0
计算总变更行数 = 新增行数 + 删除行数

重要边界情况：

单个文件："1 file changed"（单数形式）
无新增行：Git 完全省略 "insertions(+)" → 视为 0
无删除行：Git 完全省略 "deletions(-)" → 视为 0
纯重命名：可能显示 "0 insertions(+), 0 deletions(-)" 或两者都省略

决策逻辑（按顺序检查，首次匹配生效）：

如果文件数 >= 30 或总变更行数 >= 2000 → 关键任务（gpt-5.2 + xhigh）
如果文件数 >= 10 → 困难任务（gpt-5.3-codex + xhigh）
如果总变更行数 >= 500 → 困难任务（gpt-5.3-codex + xhigh）
如果新增行数 >= 300 或删除行数 >= 300 → 困难任务（gpt-5.3-codex + xhigh）
否则 → 普通任务（gpt-5.3-codex + high）

⭐ “50 files changed, 2000 insertions(+), 1500 deletions(-)” → 关键任务，使用 model=gpt-5.2 model_reasoning_effort=xhigh，超时 40 分钟（核心架构变更）
✅ “20 files changed, 342 insertions(+), 985 deletions(-)” → 困难任务，使用 model=gpt-5.3-codex model_reasoning_effort=xhigh，超时 15 分钟
✅ “5 files changed, 600 insertions(+), 50 deletions(-)” → 困难任务，使用 model=gpt-5.3-codex model_reasoning_effort=xhigh，超时 15 分钟
❌ “3 files changed, 150 insertions(+), 80 deletions(-)” → 普通任务，使用 model=gpt-5.3-codex model_reasoning_effort=high，超时 10 分钟
❌ “1 file changed, 50 insertions(+)” → 普通任务，使用 model=gpt-5.3-codex model_reasoning_effort=high，超时 10 分钟

调用 codex-runner 子任务：

使用 Task 工具调用 codex-runner，传递完整的命令（包括 Lint + codex review）：

Task parameters:
- subagent_type: Bash
- description: "执行 Lint 和 codex review"
- timeout: 900000（困难任务 15 分钟）或 600000（普通任务 10 分钟）
- prompt: 根据项目类型和难度选择相应的命令

Go 项目 - 困难任务：
  go fmt ./... && go vet ./... && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=xhigh
  （超时：900000）

Go 项目 - 普通任务：
  go fmt ./... && go vet ./... && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=high
  （超时：600000）

Node 项目 - 困难任务：
  npm run lint:fix && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=xhigh
  （超时：900000）

Node 项目 - 普通任务：
  npm run lint:fix && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=high
  （超时：600000）

Python 项目 - 困难任务：
  black . && ruff check --fix . && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=xhigh
  （超时：900000）

Python 项目 - 普通任务：
  black . && ruff check --fix . && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=high
  （超时：600000）

干净工作目录：
  codex review --commit HEAD --config model=gpt-5.3-codex --config model_reasoning_effort=high
  （超时：600000）

如果 Codex 发现 Changelog 描述与代码逻辑不一致：

代码错误 → 修复代码
描述不准确 → 更新 Changelog

[关卡] 检查 CHANGELOG - 如果未更新则自动生成并写入（利用当前上下文理解变更意图）
[准备] 暂存未跟踪的文件 - 将所有新文件添加到 git 暂存区（避免 codex P1 错误）
[执行] 任务 → Lint + codex review - 调用 Task 工具执行 Lint 和 codex（隔离上下文，减少浪费）
[修复] 自我修正 - 当意图 ≠ 实现时，修复代码或更新描述

Codex Review 命令参考

codex review [OPTIONS] [PROMPT]

注意：[PROMPT] 参数不能与 --uncommitted、--base 或 --commit 一起使用。

选项	描述	示例
`--uncommitted`	审查工作目录中所有未提交的更改（已暂存 + 未暂存 + 未跟踪）	`codex review --uncommitted`
`--base <BRANCH>`	审查相对于指定基础分支的更改	`codex review --base main`
`--commit <SHA>`	审查指定提交引入的更改	`codex review --commit HEAD`
`--title <TITLE>`	可选的提交标题，显示在审查摘要中	`codex review --uncommitted --title "feat: add JSON parser"`
`-c, --config <key=value>`	覆盖配置值	`codex review --uncommitted -c model="o3"`

# 1. 审查所有未提交的更改（最常见）
codex review --uncommitted

# 2. 审查最新提交
codex review --commit HEAD

# 3. 审查特定提交
codex review --commit abc1234

# 4. 审查当前分支相对于 main 的所有更改
codex review --base main

# 5. 审查当前分支相对于 develop 的所有更改
codex review --base develop

# 6. 附带标题进行审查（标题显示在审查摘要中）
codex review --uncommitted --title "fix: resolve JSON parsing errors"

# 7. 使用特定模型进行审查
codex review --uncommitted -c model="o3"

--uncommitted、--base、--commit 互斥，不能一起使用
[PROMPT] 参数与上述三个选项互斥
必须在 git 仓库目录中执行

确保在 git 仓库目录中执行
超时时间根据任务难度自动调整：
- 困难任务：15 分钟（timeout: 900000）
- 普通任务：10 分钟（timeout: 600000）
codex 命令必须正确配置并已登录
对于大型变更，codex 会自动分批处理
CHANGELOG.md 必须在未提交的更改中，否则 Codex 无法看到意图描述

为什么分离上下文？

CHANGELOG 更新需要当前上下文：理解用户之前的对话和任务意图，以生成准确的变更描述
Codex 审查不需要对话历史：只需要代码变更和 CHANGELOG，独立运行更高效
减少令牌消耗：codex review 作为独立子任务运行，不携带无关的对话上下文

2026 年 1 月 19 日

🇺🇸English

Codex Code Review Skill

Trigger Conditions

Triggered when user input contains:

"代码审核", "代码审查", "审查代码", "审核代码"
"review", "code review", "review code", "codex 审核"
"帮我审核", "检查代码", "审一下", "看看代码"

Core Concept: Intention vs Implementation

Running codex review --uncommitted alone only shows AI "what was done (Implementation)". Recording intention first tells AI "what you wanted to do (Intention)".

"Code changes + intention description" as combined input is the most effective way to improve AI code review quality.

Skill Architecture

This skill operates in two phases:

Preparation Phase (current context): Check working directory, update CHANGELOG
Review Phase (isolated context): Invoke Task tool to execute Lint + codex review (using context: fork to reduce context waste)

Execution Steps

0. [First] Check Working Directory Status

git diff --name-only && git status --short

Decide review mode based on output:

Has uncommitted changes → Continue with steps 1-4 (normal flow)
Clean working directory → Directly invoke codex-runner: codex review --commit HEAD

1. [Mandatory] Check if CHANGELOG is Updated

Before any review, must check if CHANGELOG.md contains description of current changes.

# Check if CHANGELOG.md is in uncommitted changes
git diff --name-only | grep -E "(CHANGELOG|changelog)"

If CHANGELOG is not updated, you must automatically perform the following (don't ask user to do it manually):

Analyze changes : Run git diff --stat and git diff to get complete changes
Auto-generate CHANGELOG entry : Generate compliant entry based on code changes
Write to CHANGELOG.md : Use Edit tool to insert entry at top of [Unreleased] section
Continue review flow : Immediately proceed to next steps after CHANGELOG update

Auto-generated CHANGELOG entry format:

## [Unreleased]

### Added / Changed / Fixed

- Feature description: what problem was solved or what functionality was implemented
- Affected files: main modified files/modules

Example - Auto-generation Flow:

1. Detected CHANGELOG not updated
2. Run git diff --stat, found handlers/responses.go modified (+88 lines)
3. Run git diff to analyze details: added CompactHandler function
4. Auto-generate entry:
   ### Added
   - Added `/v1/responses/compact` endpoint for conversation context compression
   - Supports multi-channel failover and request body size limits
5. Use Edit tool to write to CHANGELOG.md
6. Continue with lint and codex review

2. [Critical] Stage All New Files

Before invoking codex review, must add all new files (untracked files) to git staging area, otherwise codex will report P1 error.

# Check for new files
git status --short | grep "^??"

If there are new files, automatically execute:

# Safely stage all new files (handles empty list and special filenames)
git ls-files --others --exclude-standard -z | while IFS= read -r -d '' f; do git add -- "$f"; done

Explanation:

-z uses null character to separate filenames, correctly handles filenames with spaces/newlines
while IFS= read -r -d '' reads filenames one by one
git add -- "$f" uses -- separator, correctly handles filenames starting with -
When no new files exist, loop body doesn't execute, safely skipped
This won't stage modified files, only handles new files
codex needs files to be tracked by git for proper review

3. Evaluate Task Difficulty and Invoke codex-runner

Count change scale:

# Get summary line for ALL changes (staged + unstaged)
# IMPORTANT: Must use 'HEAD' as base to include both staged and unstaged changes
git diff --stat HEAD | tail -1

Why usegit diff --stat HEAD:

git diff --stat only shows unstaged changes
git diff --cached --stat only shows staged changes
git diff --stat HEAD shows BOTH staged and unstaged changes combined
The last line (tail -1) is the summary line with total file count and line changes

Difficulty Assessment Criteria:

Model + Reasoning Effort Combinations:

Combination	Quality	Time	Timeout	Recommended For
`model=gpt-5.2 model_reasoning_effort=xhigh`	Best	~15-20 min	40 min	Critical code, architecture changes
`model=gpt-5.3-codex model_reasoning_effort=xhigh`	High	~8-9 min	15 min	Difficult tasks (default)
`model=gpt-5.2 model_reasoning_effort=high`	High	~8-9 min	15 min	Alternative for difficult tasks

Critical Tasks (meets any condition, use best quality model):

Modified files ≥ 30
Total code changes (insertions + deletions) ≥ 2000 lines
Involves core architecture/algorithm changes (user explicitly mentioned)
Config: --config model=gpt-5.2 --config model_reasoning_effort=xhigh, timeout 40 minutes

Difficult Tasks (meets any condition):

Modified files ≥ 10
Total code changes (insertions + deletions) ≥ 500 lines
Single metric: insertions ≥ 300 lines OR deletions ≥ 300 lines
Cross-module refactoring
Default config: --config model=gpt-5.3-codex --config model_reasoning_effort=xhigh, timeout 15 minutes

Normal Tasks (other cases):

Default config: --config model=gpt-5.3-codex --config model_reasoning_effort=high, timeout 10 minutes

Evaluation Method:

You MUST parse the git diff --stat HEAD output correctly to determine difficulty:

# Get the summary line (last line of git diff --stat HEAD)
git diff --stat HEAD | tail -1
# Example outputs:
# "20 files changed, 342 insertions(+), 985 deletions(-)"
# "1 file changed, 50 insertions(+)"  # No deletions
# "3 files changed, 120 deletions(-)"  # No insertions

Critical: Why the summary line matters:

Each file shows individual stats: file.go | 171 ++++++++++++++++++++-
Only the LAST line has the total: 6 files changed, 1341 insertions(+), 18 deletions(-)
You must extract the last line with tail -1 to get accurate totals

Parsing Rules:

Extract file count from "X file(s) changed" (handle both "1 file" and "N files")
Extract insertions from "Y insertion(s)(+)" if present (handle both "1 insertion" and "N insertions"), otherwise 0
Extract deletions from "Z deletion(s)(-)" if present (handle both "1 deletion" and "N deletions"), otherwise 0
Calculate total changes = insertions + deletions

Important Edge Cases:

Single file: "1 file changed" (singular form)
No insertions: Git omits "insertions(+)" entirely → treat as 0
No deletions: Git omits "deletions(-)" entirely → treat as 0
Pure rename: May show "0 insertions(+), 0 deletions(-)" or omit both

Decision Logic (check in order, first match wins):

IF file_count >= 30 OR total_changes >= 2000 → Critical (gpt-5.2 + xhigh)
IF file_count >= 10 → Difficult (gpt-5.3-codex + xhigh)
IF total_changes >= 500 → Difficult (gpt-5.3-codex + xhigh)
IF insertions >= 300 OR deletions >= 300 → Difficult (gpt-5.3-codex + xhigh)
ELSE → Normal (gpt-5.3-codex + high)

Example Cases:

⭐ "50 files changed, 2000 insertions(+), 1500 deletions(-)" → 关键任务 ，使用 model=gpt-5.2 model_reasoning_effort=xhigh，超时 40 分钟（核心架构变更）
✅ "20 files changed, 342 insertions(+), 985 deletions(-)" → 困难任务 ，使用 model=gpt-5.3-codex model_reasoning_effort=xhigh，超时 15 分钟
✅ "5 files changed, 600 insertions(+), 50 deletions(-)" → 困难任务 ，使用 model=gpt-5.3-codex model_reasoning_effort=xhigh，超时 15 分钟
❌ "3 files changed, 150 insertions(+), 80 deletions(-)" → 普通任务 ，使用 model=gpt-5.3-codex model_reasoning_effort=high，超时 10 分钟
❌ "1 file changed, 50 insertions(+)" → 普通任务 ，使用 model=gpt-5.3-codex model_reasoning_effort=high，超时 10 分钟

Invoke codex-runner Subtask:

Use Task tool to invoke codex-runner, passing complete command (including Lint + codex review):

Task parameters:
- subagent_type: Bash
- description: "Execute Lint and codex review"
- timeout: 900000 (15 minutes for difficult tasks) or 600000 (10 minutes for normal tasks)
- prompt: Choose corresponding command based on project type and difficulty

Go project - Difficult task:
  go fmt ./... && go vet ./... && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=xhigh
  (timeout: 900000)

Go project - Normal task:
  go fmt ./... && go vet ./... && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=high
  (timeout: 600000)

Node project - Difficult task:
  npm run lint:fix && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=xhigh
  (timeout: 900000)

Node project - Normal task:
  npm run lint:fix && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=high
  (timeout: 600000)

Python project - Difficult task:
  black . && ruff check --fix . && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=xhigh
  (timeout: 900000)

Python project - Normal task:
  black . && ruff check --fix . && codex review --uncommitted --config model=gpt-5.3-codex --config model_reasoning_effort=high
  (timeout: 600000)

Clean working directory:
  codex review --commit HEAD --config model=gpt-5.3-codex --config model_reasoning_effort=high
  (timeout: 600000)

4. Self-Correction

If Codex finds Changelog description inconsistent with code logic:

Code error → Fix code
Description inaccurate → Update Changelog

Complete Review Protocol

[GATE] Check CHANGELOG - Auto-generate and write if not updated (leverage current context to understand change intention)
[PREPARE] Stage Untracked Files - Add all new files to git staging area (avoid codex P1 error)
[EXEC] Task → Lint + codex review - Invoke Task tool to execute Lint and codex (isolated context, reduce waste)
[FIX] Self-Correction - Fix code or update description when intention ≠ implementation

Codex Review Command Reference

Basic Syntax

codex review [OPTIONS] [PROMPT]

Note : [PROMPT] parameter cannot be used with --uncommitted, --base, or --commit.

Common Options

Option	Description	Example
`--uncommitted`	Review all uncommitted changes in working directory (staged + unstaged + untracked)	`codex review --uncommitted`
`--base <BRANCH>`	Review changes relative to specified base branch	`codex review --base main`
`--commit <SHA>`	Review changes introduced by specified commit	`codex review --commit HEAD`

Usage Examples

# 1. Review all uncommitted changes (most common)
codex review --uncommitted

# 2. Review latest commit
codex review --commit HEAD

# 3. Review specific commit
codex review --commit abc1234

# 4. Review all changes in current branch relative to main
codex review --base main

# 5. Review changes in current branch relative to develop
codex review --base develop

# 6. Review with title (title shown in review summary)
codex review --uncommitted --title "fix: resolve JSON parsing errors"

# 7. Review using specific model
codex review --uncommitted -c model="o3"

Important Limitations

--uncommitted, --base, --commit are mutually exclusive, cannot be used together
[PROMPT] parameter is mutually exclusive with the above three options
Must be executed in a git repository directory

Important Notes

Ensure execution in git repository directory
Timeout automatically adjusted based on task difficulty:
- Difficult tasks: 15 minutes (timeout: 900000)
- Normal tasks: 10 minutes (timeout: 600000)
codex command must be properly configured and logged in
codex automatically processes in batches for large changes
CHANGELOG.md must be in uncommitted changes, otherwise Codex cannot see intention description

Design Rationale

Why separate contexts?

CHANGELOG update needs current context : Understanding user's previous conversation and task intention to generate accurate change description
Codex review doesn't need conversation history : Only needs code changes and CHANGELOG, more efficient to run independently
Reduce token consumption : codex review as independent subtask, doesn't carry irrelevant conversation context

Weekly Installs

292

Repository

benedictking/co…x-review

GitHub Stars

First Seen

Jan 19, 2026

Security Audits

Gen Agent Trust HubPass SocketFail SnykPass

Installed on

codex264

opencode247

gemini-cli243

claude-code221

github-copilot164

cursor158

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

138,300 周安装

model=gpt-5.3-codex model_reasoning_effort=high