2026年7月15日 2 分钟阅读

git-lrc 实战:在 Git Commit 时自动进行 AI 代码审查

tinyash 0 条评论

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

两条信息需要配置:

  1. LiveReview API Key:登录 Hexmos 账户获取
  2. 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 对话框即可完成审查流程。

最佳实践

  1. 先审查后修复:AI Agent 生成的代码不要直接 commit,先 git lrc review 再交给 Agent 修复
  2. 设置 Repository Rules:花 5 分钟写 3-5 条核心规则,能让审查质量提升明显
  3. 启用 Issue Navigator:按类别浏览问题比逐行滚动高效得多,优先修复 Critical 级别问题
  4. vouch 而不是 skip:vouch 至少留下了责任记录,skip 等于告诉团队「这行代码没人管」
  5. 配合 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 用户甚至不用离开终端

相关链接

发表评论

你的邮箱地址不会被公开,带 * 的为必填项。