Repolode
mattzcarey

mattzcarey/shippie

可扩展的 AI 代码审查智能体,读取代码差异、探索代码库,并在 PR 中给出聚焦的审查评论。

Star
2,520
Fork
241
未关闭 Issue
31
最近提交
17天前

这是什么?

Shippie 是一个 AI 代码审查智能体,它读取代码差异,借助开发者常用工具探索周边代码库,然后给出审查评论。它关注的是人工审查者通常会发现的问题,例如泄露的密钥、低效或变慢的代码,以及潜在的 bug 和未处理的边界情况。

它可以作为 GitHub Action 运行,也可以在本地通过 `npx shippie review` 审查暂存区改动,或在 PR 中评论 `/shippie review` 按需触发。支持 Node、Cloudflare、GitHub Actions 和 GitLab CI 环境,模型方面兼容 Anthropic、OpenAI、OpenRouter 和 Cloudflare Workers AI。

Shippie 还可作为 Model Context Protocol (MCP) 客户端,接入浏览器自动化、可观测性和文档等外部工具。它会读取 AGENTS.md 或 CLAUDE.md 中的项目上下文,并支持 Agent Skills。

核心功能

  • 01审查代码差异,发现泄露的密钥、性能问题和潜在 bug。
  • 02支持 GitHub Action、本地暂存区审查,以及通过 `/shippie review` 按需触发。
  • 03兼容 Anthropic、OpenAI、OpenRouter 和 Cloudflare Workers AI 模型。
  • 04作为 MCP 客户端接入外部工具。
  • 05读取 AGENTS.md、CLAUDE.md 和 Agent Skills 作为项目上下文。
  • 06支持通过 task 工具把子任务委派给子智能体。

适用场景

  • 在 GitHub 仓库的每个 PR 中自动添加首轮审查评论。
  • 提交前在本地检查暂存区改动中是否有密钥或明显 bug。
  • 在 PR 中评论即可按需触发一次代码审查。
  • 通过 MCP 将审查智能体连接到浏览器或可观测性工具。

快速上手

  1. 1

    从 Anthropic、OpenAI、OpenRouter 或 Cloudflare Workers AI 等受支持的提供商获取 API 密钥

  2. 2

    生成 GitHub Action 工作流

    npx shippie init
  3. 3

    将提供商 API 密钥(例如 ANTHROPIC_API_KEY)添加为仓库 secret

  4. 4

    或者在本地审查已暂存的更改

    npx shippie review

使用前须知

  • 需要来自付费模型提供商的 API 密钥。
  • GitHub Action 需要完整检出代码(fetch-depth: 0)以及 PR 写入权限。
  • 本地模式只审查已暂存的更改(git diff --cached)。

收录于专题

标签

常见问题

shippie 是什么?
可扩展的 AI 代码审查智能体,读取代码差异、探索代码库,并在 PR 中给出聚焦的审查评论。 Shippie 是一个 AI 代码审查智能体,它读取代码差异,借助开发者常用工具探索周边代码库,然后给出审查评论。它关注的是人工审查者通常会发现的问题,例如泄露的密钥、低效或变慢的代码,以及潜在的 bug 和未处理的边界情况。
shippie 可以免费使用吗?用的什么许可证?
shippie 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
shippie 还在维护吗?
活跃维护中。shippie 最近一次提交是在 2026年10月21日。
shippie 适合用来做什么?
在 GitHub 仓库的每个 PR 中自动添加首轮审查评论。 提交前在本地检查暂存区改动中是否有密钥或明显 bug。 在 PR 中评论即可按需触发一次代码审查。 通过 MCP 将审查智能体连接到浏览器或可观测性工具。
shippie 怎么安装和运行?
从 Anthropic、OpenAI、OpenRouter 或 Cloudflare Workers AI 等受支持的提供商获取 API 密钥 生成 GitHub Action 工作流: npx shippie init 将提供商 API 密钥(例如 ANTHROPIC_API_KEY)添加为仓库 secret 或者在本地审查已暂存的更改: npx shippie review
在哪里获取 shippie?
源代码和安装说明在 GitHub 上:https://github.com/mattzcarey/shippie

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目