SuperAPI AI 工具集

cy-impl-peer-review

智能体与模型

查看项目

更新于 10-15 20:27

技能介绍

用途:在用户明确要求对刚完成(或暂停)的实现做一轮审查时,用 Claude Opus 对当前代码 diff 做跨 LLM 对等审查。审查范围是 diff 本身及用户指定的上下文文件,与任何 PRD/任务跟踪系统解耦。

主要能力:解析 diff 范围,校验就绪标记,组装审查提示词,调用一次 Opus 审查,汇总为 blockers、risks、nits、verdict(SHIP / FIX_BEFORE_SHIP / REWORK),并按用户选择执行本地修复,可再开启新轮次。

使用方式:默认无参数即可运行。可选参数:--files 限定审查路径;--context 提供规格、ADR、设计文档等上下文文件;--base 指定 diff 基准(默认 main,可用 HEAD~N 或 --staged);--out 指定产物目录(默认仓库根 .peer-reviews/<UTC时间戳>/)。核心命令为 compozy exec --ide claude --model opus --reasoning-effort xhigh --format json --prompt-file <out>/impl-review-prompt-roundN.md。每轮产物含 diff、提示词、结果 JSON、摘要与修复记录,按 -roundN 版本化,不覆盖上一轮。

适用场景:实现完成后希望获得独立第二意见、识别阻断项与潜在风险时。

限制:不能自动运行;每轮只调用一次 compozy exec;不会自动采纳发现、提交、推送、开 PR 或调用 provider review fetcher。审查需用户明确请求;修复后需重跑验证(如 make verify)。若模型配置错误(如模型不存在)、compozy exec 不在 PATH、就绪检查失败、diff 为空、diff 过大(超 5000 行或 80 个文件)或 Opus 输出为空,会报错或要求用户确认,不静默重试。附带模板文件为只读,不应修改。