SuperAPI AI 工具集

codex-review

办公与效率

查看项目

更新于 10-15 19:57

技能介绍

用途:codex-review 用于搭建跨智能体评审流程——Claude 实现,Codex(GPT)评审。Codex 运行在同一目录,可自行查看代码,因此无需把 git diff 传给评审方。

主要能力:脚本位于技能目录的 scripts/ 下,包括 codex-review.sh 与 codex-state.sh。支持会话初始化(init)、计划评审(plan,通过 --plan-file 传入计划文件路径,内容经 stdin 交给 Codex,不受计划长度限制)、代码评审(code,用文字描述改了什么与关键决策)。状态管理命令包括 show、dir、reset、reset --full、get、set,可读写 session_id、phase、iteration 等字段。评审结果分为 ## Blocking、## Non-blocking、## Pre-existing 三个部分,verdict.txt 只写入 APPROVED 或 CHANGES_REQUESTED。

使用方式:初始化会话示例:bash scripts/codex-review.sh init "Implement JWT authentication for API";计划评审:bash scripts/codex-review.sh plan --plan-file ~/.claude/plans/<slug>.md;代码评审:bash scripts/codex-review.sh code "..."。描述中含反引号、$ 或 $(...) 时应改用 --description-file 传文件。实现前先执行 bash scripts/codex-state.sh set phase implementing。退出码含义:0 为 APPROVED 或 CHANGES_REQUESTED,1 为 ERROR,2 为 ESCALATE,3 为 NO_SESSION。

限制与注意:所有 codex-review.sh 与 codex-state.sh 调用必须在 Bash 工具中以 dangerouslyDisableSandbox: true 执行,否则 Codex 会因 macOS system API 被沙箱拦截而崩溃。不要直接调用 codex exec。状态按分支隔离,同一分支同一时间只允许一个运行(.lock),读取状态不加锁。AUTO_REVIEW=true 时整个评审循环自动运行,插件钩子会阻止 ExitPlanMode 直到计划获批。STATUS.md 由脚本自动维护,不应手动编辑。其他细节(如具体模型、配置项取值)资料未提供。