mcpField
C
codex-review

codex-review

github.com/jezweb测试与质量1.1k556 次安装3 周前更新
代码仓库

关于 codex-review

codex-review 是一项通过 OpenAI Codex CLI 执行代码审查的技能，仅提供建议。它支持审查整个应用、未提交更改、分支或提交，并将发现保存为带时间戳的报告。

主要功能

  1. 01通过 OpenAI Codex CLI 执行审查
  2. 02按应用、更改、分支或提交限定范围
  3. 03使用专用审查提示词
  4. 04保存带时间戳的报告
  5. 05呈现高优先级发现

适用场景

  1. 01提交或发布前审查更改
  2. 02创建 PR 前自行检查
  3. 03调查难以明确定位的问题
  4. 04定期审查正在开发的项目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jezweb/claude-skills --skill codex-review

安装后在 Claude Code 中输入/codex-review确认已加载。

附带文件prompt.md

详细介绍

Codex Review

通过 OpenAI Codex CLI（codex review）进行独立代码审查。它的价值在于提供来自与编写代码的模型不同的模型系列的第二意见——Codex 能发现 Claude 因作者偏见而忽略的问题。

可与 brains-trust（通用多模型意见）互补。此技能专门用于代码审查：了解 Git 状态、使用经过调优的审查提示词，并保存结构化输出。

适用场景

  • 完成有意义的更改后，在提交或发布前
  • 打开 PR 前，使用独立审查者进行自我审查
  • 感觉哪里不对劲，却说不清具体问题时
  • 对正在积极开发的项目定期进行全应用审查
  • 用户明确要求进行“独立”或“第二意见”审查时

不要用于：

  • 微小更改（拼写错误、单行修复）
  • 研究问题或架构讨论——改用 brains-trust
  • 自动修复问题——此技能仅提供建议

预检

  1. 确认已安装 Codex CLI：

    which codex

    如果未安装：告知用户安装它（macOS 上运行 brew install codex，或参阅 https://github.com/openai/codex），然后停止。不要继续。

  2. 确认身份验证：首次调用 codex review 时，如果尚未登录，命令会明确报错。如果发生这种情况，指导用户运行 codex login，然后停止。

确定审查范围

根据用户的要求选择范围标志：

用户意图标志
“codex review” / “review the app” / “full review” / 默认不使用标志（审查当前 HEAD 的整个应用）
“review my changes” / “review what I just did” / “review uncommitted”--uncommitted
“review this branch vs main” / “review the PR”--base main（或用户指定的分支）
“review commit abc123”--commit abc123

默认是全应用审查。 单独一句“codex review”且没有限定条件，意味着审查 HEAD 上的整个代码库——而不只是未提交的更改。只有用户明确提及近期或未提交的工作时，才使用 --uncommitted。

如果范围含糊，只询问一次。不要猜测提交或分支。

执行审查

规范的审查提示词位于此技能旁边的 prompt.md 中。通过标准输入传入，避免 shell 转义：

mkdir -p .jez/reviews
TS=$(date +%Y-%m-%d-%H%M)
OUT=".jez/reviews/codex-${TS}.md"
SKILL_DIR="$(dirname "$0")"  # or use the skill's absolute path

# Example: uncommitted changes
cat "${SKILL_DIR}/prompt.md" | codex review --uncommitted - 2>&1 | tee "$OUT"

其他范围：

# Vs base branch
cat prompt.md | codex review --base main - 2>&1 | tee "$OUT"

# Specific commit
cat prompt.md | codex review --commit abc123 - 2>&1 | tee "$OUT"

# Current HEAD (no scope flag)
cat prompt.md | codex review - 2>&1 | tee "$OUT"

大型差异的 codex review 可能需要几分钟。请等待其运行完成。

向用户总结

Codex 完成后：

  1. 输出结果文件路径：Report saved to .jez/reviews/codex-<timestamp>.md
  2. 阅读保存的报告，提取最重要的发现（Critical 和 High 类别下的所有内容）
  3. 在聊天中直接展示这些发现，并保留文件:行号引用
  4. 提出是否要处理具体发现，例如：“要我修复 auth.ts:42 中的 SQL 注入问题吗？”

规则

  • 仅提供建议。 绝不要自动应用 Codex 的建议。阅读发现并与用户讨论，获得用户批准后再修复。
  • 不要将 Claude 的推理泄露到提示词中。 prompt.md 文件刻意保持中立——由 Codex 审查代码，而不是 Claude 对代码的描述。保持独立性是整个流程的核心。
  • 保存到 .jez/reviews/，绝不要保存到 .claude/（受保护目录）。
  • 每次运行生成一份报告。 不要覆盖报告——时间戳可确保每次运行的文件名唯一，方便用户进行比较。
  • 如实报告 Codex 的发现。 不要弱化、擅自评论或跳过你不同意的发现。如果你认为 Codex 的判断有误，应先展示 Codex 的说法，再以自己的观点说明。

验证

满足以下条件即表示此技能正常运行：

  • 预检能正确检测是否缺少 codex 二进制文件
  • 根据用户意图选择正确的范围标志
  • 报告文件以合理的时间戳保存在 .jez/reviews/ 中
  • 文件包含按严重性排序的发现，并附有文件:行号引用
  • Claude 能展示最重要的发现，且不自动修复

评论

支持 Markdown