RepoPilot

RepoPilot

对 Git 更改进行本地、确定性的审查。

RepoPilot 帮助开发者和团队在合并前检查更改。它会报告有关安全边界、行为、本地导入和导出，以及通过依赖关系图受影响文件的结构性证据。同一项审查可以在终端、CI 中运行，也可以通过 Agent 集成运行。

分析在运行它的机器或 CI 运行器上执行。它不会将源代码发送到托管服务，也不会调用内置语言模型。发现会指出相关代码并说明需要检查的内容；审查者仍需自行判断更改对其应用是否安全。

示例：削弱自身测试的更改

此更改从 applyDiscount 中移除了范围检查。同一更改还跳过了因此会失败的测试，从另一个测试中删除断言，并允许 CI 测试步骤失败而不导致任务失败。所有仍在运行的检查都通过了。repopilot review . 会在给出判断后立即列出这些问题：

Decision: REVIEW (Change Proof: REVIEW)
...
Checks this change weakened (details under Review signals):
  ⚑ check gate relaxed — .github/workflows/ci.yml:10
  ⚑ assertions removed — src/pricing.test.ts:5
  ⚑ test skipped — src/pricing.test.ts:9

再往下，每条信号都会说明原因：

    ⚑ check gate relaxed — .github/workflows/ci.yml:10  check step `npm test` in job `test` now has `continue-on-error: true`
    ⚑ assertions removed — src/pricing.test.ts:5  "applyDiscount > takes a percentage off the total": assertions 2 → 1
    ⚑ test skipped — src/pricing.test.ts:9  `it.skip` added on "rejects a discount above 100%"; its result no longer fails the run

这些是一次运行的摘录（录屏）。使用 scripts/demo-weakened-tests.sh <empty-dir> 重放，然后运行 repopilot review <empty-dir>。

安装并审查

cargo install repopilot
# or
npm install -g repopilot

repopilot review . --base origin/main

对于未提交的工作，运行 repopilot review .。首屏会给出一个 PASS、REVIEW、BLOCK 或 NOT ASSESSED 判断，以及判断原因、覆盖范围限制和下一步操作。

审查可能会发现：

• 身份验证、请求信任、部署、依赖项或机密配置方面的更改；
• 新增或移除的行为，例如网络调用、子进程、文件系统写入、SQL 或错误处理；
• 更改后的输入到接收端路径、算法结构，或本地导入／导出契约；
• 更改导致不再运行或被削弱的测试：已提交的专注标记（例如 it.only）、新跳过的测试（it.skip、@pytest.mark.skip、t.Skip、 #[ignore]）、移除或替换的测试用例、丢失断言的测试、新增的 lint、 类型或覆盖率抑制，以及放宽的 CI 或工具门槛 （continue-on-error、|| true、降低覆盖率阈值、关闭严格模式），以免绿色运行掩盖这些问题；
• 直接依赖方，以及更改文件造成的更广泛影响。

信号是供参考的证据。例如，taint-lite 信号表明，在已更改的源代码中，一个可识别的输入可以到达一个可识别的接收端。请结合应用的上下文和已配置的检查确认其影响。

示例：审查图像处理更改

Wagtail 示例在单文件更改中移除了一项授权检查，并将请求数据传递给子进程。RepoPilot 会报告边界更改和从输入到进程的流向。

在固定版本的测试仓库中重放此示例：

python3 scripts/zoo.py clone --only wagtail
scripts/demo-agent-edit.sh .zoo/wagtail
repopilot review .zoo/wagtail

报告的流向是一条值得调查的路径。RepoPilot 无法证明它可被利用，也无法证明应用是安全的。

在团队中使用

基于高置信度信号，为分支审查设置门禁：

repopilot review . --base origin/main --fail-on-review definitely

只有在明确使用 --verify 选择了仓库配置的检查项，且这些检查项在被审查的修订版本上通过时，审查才会标记为 VERIFIED。使用 repopilot init --suggestions-output repopilot-suggestions.toml 为初次设置生成建议；该文件与活动配置分开。请参阅配置。

如需更全面地查看仓库，请运行 repopilot scan .。使用 repopilot baseline create . 接纳现有发现项，然后再对新工作设置门禁。

Agent 和 CI 集成

同一审查既可检查人工完成的工作，也可检查编码 Agent 完成的工作。记录一个起点，然后审查此后所做的更改：

repopilot snapshot
# Work happens here.
repopilot review --since-snapshot

如果工作树已有未提交更改，标记也会记录这些文件的基线提交，因此后续审查只涵盖快照之后的更改。它会显示更改内容，而不会显示是谁做了更改。 请参阅常见工作流。

在 Claude Code 中，RepoPilot 插件会在每个会话中运行这一流程，并阻止 Claude 在未解释其跳过、聚焦、移除或弱化的测试之前结束会话：

/plugin marketplace add MykytaStel/repopilot
/plugin install repopilot@repopilot

Codex 可安装相同的插件（codex plugin marketplace add MykytaStel/repopilot，然后运行 codex plugin add repopilot@repopilot）。Gemini CLI 可将其作为扩展安装（gemini extensions install https://github.com/MykytaStel/repopilot），Cursor 则通过项目钩子运行它。对于 GitHub Copilot 编码 Agent 和其他 Agent，RepoPilot 提供设置步骤、一个 MCP 条目以及一段 AGENTS.md 代码片段。请参阅保护 Agent 运行。

RepoPilot 还提供本地 stdio MCP 服务和 GitHub Action。MCP 服务可让 Agent 使用本地扫描和审查工具。Action 会在 Actions 运行器上运行 RepoPilot，并可发布 SARIF 或拉取请求摘要。 请参阅保护 Agent 运行、MCP 服务 和 GitHub 集成。MCP Registry 名称：mcp-name: io.github.MykytaStel/repopilot。

更多功能

• repopilot ai context . 会生成本地交接材料，其中包含仓库信息、发现项和按优先级排序的计划。它不会调用模型。
• repopilot init 会创建配置或集成文件，供审查使用。
• 报告支持控制台、Markdown、JSON、HTML 和 SARIF 格式。

文档

• 安装 · 常见工作流 · CLI 参考
• 当前架构 · 报告与架构 · 安全模型
• 语言支持 · 规则参考 · 路线图
• 最新稳定版发行说明 · 发行证据 · 维护者文档

贡献指南和开发环境设置：CONTRIBUTING.md。

许可证

您可选择依据 Apache License, Version 2.0 或 MIT license 获得许可。