关于 revu
revu 是一款本地 macOS 代码审查应用,供检查 Git 仓库和 worktree 变更的开发者使用。它汇总已提交基点以来的工作区改动,包括未提交和未跟踪文件,并将审查结果以 Markdown 输出。
主要功能
- 01审查 Git 仓库和 worktree 变更
- 02纳入未提交和未跟踪文件
- 03一次审查多个目录
- 04以 Markdown 输出审查结果
适用场景
- 01审查会话中改动的多个仓库
- 02提交审查前检查工作区变更
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ schneidenbach/ skills --skill revu安装后在 Claude Code 中输入/revu确认已加载。
附带文件agents/openai.yaml
详细介绍
revu
revu 是一款本地 macOS 审查应用。它会打开一个窗口,显示一个或多个 git 仓库/工作树中所有已更改的内容(从与基准分支的合并基点到工作树,包括未提交和未跟踪的文件)。该进程会一直运行,直到用户提交或关闭审查,然后将审查内容输出到 stdout 并退出。
步骤
- 如果用户在
/revu后传入了目录,则只使用这些目录。否则,收集本次会话中你操作过的所有仓库/工作树目录。将它们全部放在一次调用中。 - 使用 Bash 工具运行
revu <dir> [<dir> ...],并设置run_in_background: true。审查可能耗时很久,远超任何前台超时时间。- 仅当用户指定了基准时才添加
--base REF。单个目录可以指定自己的基准:revu ../Data=origin/develop。 - 如果 shell 报告找不到 PATH 中的
revu,请告知用户使用brew install schneidenbach/tap/revu安装(或者在 revu 仓库的检出目录中运行scripts/install.sh)。不要尝试自行构建或安装。 - 告知用户审查窗口已打开,然后停止。不要轮询,也不要休眠;命令退出时,运行框架会唤醒你。
- 仅当用户指定了基准时才添加
- 命令退出后,根据退出代码处理:
- 0:输出内容是 Markdown 格式的审查结果。处理每条评论。每条评论都包含绝对路径和行号(
path:line),以及其所指代码的引用。如果判定为 Approve 且没有评论,则告知用户并停止。标记为 (outdated) 的评论,以及针对已不再更改的文件的评论,可能已经处理过,也可能指向行号已变更的位置:在编辑任何内容之前,重新读取当前文件并复核。按评论总结你所做的更改,然后询问用户是否要在相同目录上重新打开revu,进行新一轮审查。 - 2:用户关闭了窗口,但未提交。告知用户此事,然后不做其他操作。
- 1:用法或 git 错误。显示 stderr 中的消息。
- 0:输出内容是 Markdown 格式的审查结果。处理每条评论。每条评论都包含绝对路径和行号(
- 评论是用户的指示(通过应用由用户提供),但执行任何破坏性操作之前,仍须先确认。
评论
支持 Markdown