Community编程与开发github.com

review-loop(审查循环)

审查并修复当前分支的差异,在推送或创建拉取请求前进行验证、审查、修复,直至一轮审查无问题。当要求进行审查循环或打开拉取请求前使用。

review-loop(审查循环) 是什么?

该技能(skill)是一个基于 Claude 的自动化审查循环工具,适用于当前分支与基础分支(如 origin/HEAD、origin/main)之间的差异(diff)。它通过反复执行“验证→审查→修复”步骤,确保代码在推送或创建拉取请求前达到无问题状态,同时明确不自动推送或创建拉取请求。该 skill 首先运行 .claude/verify.sh 脚本进行验证,若脚本缺失则提示用户初始化;然后获取 diff 内容(含未提交更改和未跟踪文件)并使用 code-review 技能或人工审查规则检查 bug、缺失错误路径等。每次修复后重新开始循环,最多连续三轮有发现则停止。最终报告将包含验证状态、循环次数、是否运行独立审查(可选的子代理模式)及留存的问题原因列表。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/103kaz/claude-code-loops/tree/HEAD/skills/review-loop

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

审查循环(review-loop)

在当前分支上运行开发循环:验证、审查差异、修复,并重复直到一轮审查无问题。范围仅限于差异,而非整个代码库。此技能不会推送或打开拉取请求;这些操作由用户自行完成。

步骤

  1. 运行 .claude/verify.sh。如果失败,请先修复。如果文件不存在,请告知用户并指向 /code-loops:init-verify,然后在报告中说明未进行验证并继续。
  2. 确定差异。第一轮:分支与其基础分支之间的差异(git diff origin/HEAD...HEAD,加上 git diff HEAD 用于未提交的更改,以及从 git status --short 读取的未跟踪文件)。如果 origin/HEAD 未设置,尝试 origin/main 或 origin/master;如果均不存在,请询问用户基础分支。如果差异为空(例如你当前就在基础分支上),报告无内容可审查并停止。如果未提交的更改看起来与分支工作无关,请不要修复;在报告中提及它们。后续轮次:仅针对上一轮你更改的内容。
  3. 审查差异。
    • 如果是代码更改,使用 code-review 技能,努力程度设为中等。如果该技能不可用,请自行阅读差异以查找 bug:错误结果、缺失的错误路径,以及更改所破坏的调用方。
    • 如果仅是文档更改(.md 及类似文件),请改用 /code-loops:doc-code-consistency 处理差异。
  4. 修复发现的问题。不要提交;留给用户处理。每次修复后,回到步骤 1。重复直到某轮审查无问题。决定不修复的问题,附上一行原因。如果连续三轮都出现发现(verify.sh 失败也算),则停止并报告剩余内容,不再继续。
  5. 如果差异更改了文档描述的代码,请在最后对差异运行一次 /code-loops:doc-code-consistency 并修复其发现。
  6. 提供一次独立审查(除非差异仅为文档)。询问用户(AskUserQuestion)是否运行,附带一行说明此差异是否值得审查(大小、风险区域);默认答案为否。如果同意,启动一个仅能看到差异(而非构建过程)的子代理。如果存在只读代理类型(例如 Explore),请使用;否则告知它不要编辑文件。让它查找能够破坏更改的输入、状态和顺序,并以 file:line 证据报告每个问题;如果 .claude/review/checklist.md 存在,则同时对照它进行检查。修复其发现,然后仅对那些修复运行步骤 1 和 3。如果子代理不可用,跳过此步骤并在报告中说明。
  7. 用几行报告:"结果:无发现",或"结果:保留发现"并列出每个发现及其原因。添加 verify.sh 是否通过、进行了多少轮以及是否运行了独立审查。

保持每轮简洁:阅读差异,而非存储库,且不要重复之前轮次的发现。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能