SuperAPI AI 工具集

implement-review

编程与开发

查看项目

更新于 11-06 21:07

技能介绍

用途

implement-review 是一个“暂存改动评审循环”技能。Claude Code 先检测改动的内容类型,把改动整理成评审请求发送给一个或多个评审方,再对反馈进行分类,修订后迭代,直到评审通过。

主要能力

Codex 评审的三条通道

  1. 终端中继(默认):用户在 Codex 交互终端窗口中打开会话,Claude Code 生成可复制粘贴的评审提示(含摘要、diff、视角、轮次),以代码块形式呈现,用户复制到 Codex 终端,再把反馈转回 Claude Code。
  2. Auto-terminal(可选启用):Claude Code 通过 codex exec --sandbox danger-full-access 以子进程方式调度 Codex。脚本把提示写入临时文件,通过 stdin 传入,并在 stdout 输出 state-dir 路径供后续阶段使用;Codex 按保存约定写出 Review-Codex.md,轮询在文件出现时触发。
  3. IDE 插件:由用户主动发起。

Auto-terminal 还支持显式指定跨厂商评审后端:GitHub Copilot CLI、Claude Code、Gemini(通过 Antigravity CLI)。其它评审方由用户在各自界面中临时驱动,只需遵守 Phase 1c 定义的 Review-<AgentName>.md 保存约定。

计划评审(Phase 0)

在暂存改动循环之前,可先对计划做设计评审。适用于系统设计、重构、论文大纲、提案结构、数据管线重设计、多阶段调试策略、教学/课程规划、发布流程变更、迁移计划,以及任何“工作形态先于并约束执行”的任务。评审方被要求直接阅读计划文件(或通过终端路径粘贴计划内容)并批评设计,而不是运行 git diff --cached。当评审不再有 High 级问题且无新的设计阻塞项后,再执行工作并回到常规暂存输出评审流程。

计划评审须包含对抗性的范围质疑,评审方必须明确表态:为什么是这个范围、需求能否由更小范围满足、延期是否有正当理由(每次延期都带有流程成本)、是否有更简单的路径。评审方不得在范围涉及多个维度或延期了面向用户的维度时,首轮就默认“无阻塞、可实施”。评审方也不应陷入边缘案例钓鱼、为流程而流程的仪式感、或为对抗而对抗。

使用方式

  • 计划写入 PLAN-<identifier>.md,放在任务最自然的位置;若位于 git 工作树内,加入 .git/info/exclude 避免被 git add -A 暂存。内容至少包含目的、非目标、结构、回归或失败分析、验证计划、开放问题,控制在 1–3 页。
  • 通过计划评审提示(而非暂存改动模板)发送;评审方有仓库访问权时直接读文件,快照型后端只看到导出的索引,需在请求中以 --- SUPPLIED INPUT: <path> --- 标题附上被 gitignore 的计划、未跟踪的证据笔记等。
  • 工作发布或提交后删除 PLAN 文件。
  • Auto-terminal 路径要求 PATH 中有 codex;派发前探测,缺失则按 Phase 1c 的故障转移队列处理,队列耗尽后本次会话默认回退到终端中继。非零退出、超时或 stdin 管道失败视为确认失败并走故障转移队列。
  • 配置边界:被调度的 Codex 默认只继承用户 config.toml 中的模型;通过 CODEX_DISPATCH_MODEL、CODEX_DISPATCH_REASONING 调整评审;CODEX_DISPATCH_ISOLATE_MCP=off 可让调度运行获得完整用户配置;CODEX_DISPATCH_SANDBOX 可收紧沙箱模式(workspace-write / read-only),适用于 CI 或多租户环境。

适用场景

  • 系统/代码:钩子或基础设施设计、跨切面重构、状态文件 schema、跨平台行为、发布 runbook 修订。
  • 研究输出:含具体目标的论文大纲、方法写作前的贡献声明、图表位置与论证流、审稿回复策略、多方法实验设计、消融计划。
  • 提案:完整大纲、预算与叙述耦合、广泛影响框架。
  • 运维:迁移计划、事件响应手册、数据管线重设计。
  • 行政/教学:课程大纲结构、实验室政策文件、委员会流程设计。

限制

  • Auto-terminal 无增量检查点保证:保存约定要求每轮完整评审原子发布,但不要求中间检查点;子进程退出码为 0 却未保存新评审时,健康检查会以缺失、过期或轮次错误拒绝,代价是一次完整 Codex 运行。
  • 默认 MCP 隔离下,被调度运行会丢弃 ~/.codex/config.toml 中的多数设置(包括 reasoning 设置、profile、自定义 provider 等),需要在环境变量或 AGENTS.md 中显式指定。
  • 评审提示必须与终端中继保持字节一致;不得调用 codex exec review 等自带评审模板的子命令,内嵌 diff 重试是明确例外。
  • 范围纪律(只读评审、将发现保存到 Review-Codex.md、不提交/推送/分支操作)在提示层面执行,而非受限工具白名单。