git-lrc 实战:在 Git Commit 时自动进行 AI 代码审查
AI 编码 Agent 飞速生成代码的同时,也在悄悄引入隐患——逻辑被删除、约束被放松、凭据被泄露。等 PR 时再发现问题,故障已经在生产环境了。有没有办法在代码落地之前就拦住这些问题?
为什么需要 Commit 时审查
传统代码审查发生在 PR 阶段——代码已经提交、推送、可见。而 AI Agent 生成代码时,经常:
- 删掉你认为理所当然的边界检查
- 引入未授权的云服务调用
- 把 API 密钥硬编码进源码
- 悄悄改变函数的行为逻辑
等到 Code Review 时发现问题,git log 里已经多了一条永远的历史记录。审查时机越早,修复成本越低——而 Git Commit 是代码进入永久历史前的最后一个可控节点。
git-lrc 是什么
git-lrc 是一个 Go 语言编写的 AI 代码审查工具(1,430+ GitHub ⭐),它像 Git Hook 一样挂在 git commit 命令上——每次提交前自动运行 AI 审查,在代码进入仓库之前发现问题。
核心特性:
- Commit 时自动触发:
git commit前自动运行 AI 审查,支持 10 大风险类别、100+ 具体模式 - Issue Navigator:按严重程度和类别组织审查结果,支持 Claude Code 直接修复
- Summary Deck:每个 Review 自动生成变更摘要幻灯片
- Git Log 追踪:每次提交的审查记录(审查次数、覆盖率)自动追加到 commit message
- Repository Rules:通过
.lrc/目录定义团队自定义规则 - claude-lrc 集成:在 Claude Code 中以
/lrc:review等斜杠命令执行相同审查
git-lrc 使用 Sustainable Use License(源码可用,免费个人使用),每月 30K LOC 免费额度。
安装与配置
一行命令安装
curl -L https://hexmos.com/ipm-install | bash && ipm i HexmosTech/git-lrc iwr https://hexmos.com/ipm-install-ps | iex; ipm i HexmosTech/git-lrc
或者通过独立安装脚本:
curl -fsSL https://hexmos.com/lrc-install.sh | bash iwr -useb https://hexmos.com/lrc-install.ps1 | iex
1 分钟快速配置
git lrc setup
两条信息需要配置:
- LiveReview API Key:登录 Hexmos 账户获取
- Free Gemini API Key:从 Google AI Studio 免费获取
配置一次后生效,所有 Git 仓库自动激活。
实战场景一:Commit 时自动审查
最常见的用法——让 git-lrc 在每次 git commit 时自动运行审查。
git add . git commit -m "feat: add payment validation"
审查发现的问题以 GitHub 风格的行内注释展示在 Web UI 上,你可以:
- Commit:认可审查结果,提交代码
- Commit & Push:提交并推送
- Skip:中止提交,先去修复问题
Git log 会自动记录审查状态:
LiveReview Pre-Commit Check: ran (iter:3, coverage:85%)
这样你和整个团队都能清楚看到哪些 commit 经过了审查、覆盖率如何。
实战场景二:审查 → 修复 → 再审查迭代
AI Agent 生成代码后,理想的流程是先审查、再修复、再确认。
git lrc review git add . git lrc review git lrc review --vouch git commit -m "feat: add payment validation"
--vouch 表示「我已审过这轮代码,我为此负责」——AI 审查不再重复运行,但覆盖率数据会记录到 git log。
如果确实不需要审查,也可以直接跳过:
git lrc review --skip
实战场景三:用 Repository Rules 定制审查标准
通用 AI 审查不了解你的团队偏好。git-lrc 通过 .lrc/ 目录让团队定义自己的审查规则:
lrc config init
项目根目录自动生成 .lrc/ 结构:
.lrc/
├── README.md # 说明文件
├── ignore # 跳过审查的文件模式(类似 .gitignore)
└── rules/
├── INSTRUCTIONS.md # 核心规则(AI 先读这个)
├── design.md
├── security.md
└── style.md
规则示例(rules/INSTRUCTIONS.md):
- Direct SQL is preferred over ORM abstractions. - Avoid new infrastructure dependencies. - Prefer explicit implementations over abstraction layers. - Reliability matters more than latency.
规则包上限 3000 字符——这迫使团队只保留最重要的、真正能改变审查结果的原则。
验证规则是否有效:
lrc config check # 验证规则格式和大小 lrc config preview # 预览实际发送给 AI 的指令集
claude-lrc:在 Claude Code 中使用
安装 git-lrc 后,claude-lrc 自动可用,支持在 Claude Code 中直接执行审查:
| 操作 | 命令 |
| —————- | ———————- |
| 自然语言审查 | review with lrc |
| 斜杠命令审查 | /lrc:review |
| 质量担保 | /lrc:vouch |
| 跳过审查 | /lrc:skip |
无需离开 Claude Code 对话框即可完成审查流程。
最佳实践
- 先审查后修复:AI Agent 生成的代码不要直接 commit,先
git lrc review再交给 Agent 修复 - 设置 Repository Rules:花 5 分钟写 3-5 条核心规则,能让审查质量提升明显
- 启用 Issue Navigator:按类别浏览问题比逐行滚动高效得多,优先修复 Critical 级别问题
- vouch 而不是 skip:vouch 至少留下了责任记录,skip 等于告诉团队「这行代码没人管」
- 配合 Bring Your Own Key:除了默认的 Gemini,还支持 OpenAI、Claude、DeepSeek、OpenRouter,选择你最信任的模型做审查
总结
git-lrc 把 AI 代码审查的时机从 PR 阶段提前到了 Git Commit 阶段。对于重度使用 Claude Code、Codex CLI、Cursor 等 AI 编码 Agent 的开发者来说,这意味着:
- 问题在进入永久历史之前被发现
- 每个 commit 的审查覆盖率有据可查
- 团队可以定义自己的审查规则
- Claude Code 用户甚至不用离开终端
相关链接