研发协作
提交或开 PR 前需要独立代码审查时,用 Codex…
当需要独立于当前模型作者的代码审查(提交前、开 PR 前、感觉有问题、定期全应用审查)时,调用 OpenAI Codex CLI 无头模式审查变更/PR/commit/整个应用,并把严重性优先报告保存到 .jez/reviews/。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
提交或开 PR 前需要独立代码审查时,用特定
解决思路
- 运行 `which codex` 确认 Codex CLI 已安装;如果缺失,提示用户安装(macOS 用 `brew install codex`,或查看 https://github.com/openai/codex)并停止,不要继续。
- 确认认证:第一次调用 `codex review` 若未登录会明确失败;若失败,让用户运行 `codex login` 并停止。
- 根据用户意图选择 scope flag:用户说 "codex review" / "review the app" / "full review" 或未特别说明时,不加 flag,审查当前 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`。
- 默认是 whole-app review;只有用户明确提到最近/未提交工作时才用 `--uncommitted`。
- 如果 scope 有歧义,只问一次;不要猜测 commit 或 branch。
- 创建输出目录:`mkdir -p .jez/reviews`。
- 生成时间戳:`TS=$(date +%Y-%m-%d-%H%M)`。
- 设置输出文件:`OUT=".jez/reviews/codex-${TS}.md"`。
- 设置技能目录:`SKILL_DIR="$(dirname "$0")"` 或使用该 skill 的绝对路径。
- 通过 stdin 管道传入 `prompt.md`(位于 skill 旁边)以避免 shell 转义问题。
- 对未提交变更运行:`cat "${SKILL_DIR}/prompt.md" | codex review --uncommitted - 2>&1 | tee "$OUT"`。
- 对 base 分支运行:`cat prompt.md | codex review --base main - 2>&1 | tee "$OUT"`。
- 对指定 commit 运行:`cat prompt.md | codex review --commit abc123 - 2>&1 | tee "$OUT"`。
- 对当前 HEAD 运行:`cat prompt.md | codex review - 2>&1 | tee "$OUT"`。
- `codex review` 在大 diff 上可能耗时几分钟,让它运行完成。
- Codex 完成后,打印输出路径:`Report saved to .jez/reviews/codex-<timestamp>.md`。
- 读取保存的报告,提取 **Critical** 和 **High** 下的 top findings。
- 在聊天中内联展示这些发现,保留 file:line 引用。
- 主动提出可处理具体发现,例如:`Want me to fix the SQL injection in auth.ts:42?`。
- 仅作建议:绝不自动应用 Codex 的建议;先阅读发现、与用户讨论,并在用户批准后再修复。
- 不要把 Claude 的推理泄漏到 prompt 中;`prompt.md` 刻意保持中立,让 Codex 审查代码而不是 Claude 对代码的叙述;独立性是重点。
- 保存到 `.jez/reviews/`,绝不保存到 `.claude/`(受保护目录)。
- 每次运行只生成一份报告;不要覆盖,时间戳让每次运行唯一,便于用户比较。
- 如实报告 Codex 实际发现的内容;不要软化、加工或跳过你不同意的发现;如果你认为 Codex 某处错了,先在展示 Codex 所说内容后,作为你自己的观点说明。
- 验证 skill 是否正常工作:preflight 能正确检测缺失的 `codex` 二进制。
- 验证选对 scope flag。
- 验证报告文件出现在 `.jez/reviews/`,时间戳合理。
- 验证文件包含按严重性优先的发现,并带 file:line 引用。
- 验证 Claude 展示 top findings 且没有自动修复。
适用边界 · 注意事项
- 琐碎变更(拼写错误、单行修复)
- 研究问题或架构讨论——改用 `brains-trust`
- 自动修复问题——此 skill 仅作建议