让AI替你干GitHub的活mercury-agent 创建PR、代码审查与Issue管理实战指南【免费下载链接】mercury-agentSoul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.项目地址: https://gitcode.com/gh_mirrors/me/mercury-agentmercury-agent 是一款可 7×24 小时运行的 AI 智能体配置好 GitHub Token 后它能替你创建 PR、审查代码、管理 Issue——你只管用自然语言下指令剩下的交给它。本文带你 3 分钟完成 GitHub 助手配置并演示 PR 创建、代码审查与 Issue 管理三大实战场景新手也能快速上手。为什么需要 AI 接管 GitHub 日常操作每天在 GitHub 上重复着这些操作建分支、提交、开 PR、贴描述、查 Issue、审 diff……机械且耗时。mercury-agent 把这套流程压缩成一句话协作提交——它参与的每个 commit 都会自动带上Co-authored-by: Mercury标记一句话建 PR——为这次改动创建 PR它会自动暂存、提交、推送并开 PRIssue 管家——看看未关闭的 Issue或给登录崩溃提个 bug代码审查——Review PR #5它读完 diff 并直接发布审查意见通用 API 出口——github_api工具可访问任意 GitHub API 端点快速配置一条命令开启 GitHub 工具GitHub 工具是条件注册的只有配置了GITHUB_TOKEN后才会出现在工具集中否则对话中不可用见 registry.ts。一键配置步骤运行诊断命令按提示填写 4 个字段mercury doctor字段说明GitHub 用户名用于提交署名和 API 调用身份识别Co-authored-by自动填充无需操作GitHub PAT 令牌个人访问令牌切勿外泄仅保存在本地~/.mercury/.env只直连 GitHub API默认仓库可选设置后说建个 Issue就不用每次指定仓库推荐在 GitHub 的设置 → 开发者设置 → 细粒度个人访问令牌中创建令牌权限勾选Contents / Pull requests / Issues均选读写。配置成功后会看到✓ GitHub tools registered (5) 至此5 个 GitHub 工具正式注册进智能体工具箱。5 个 GitHub 工具一览工具能力create_pr创建 PR支持标题、描述、源/目标分支、草稿状态review_pr拉取 PR 详情与 diff生成审查总结并可发布评论list_issues按状态open/closed/all、标签筛选并列出 Issuecreate_issue创建 Issue支持 Markdown 正文与标签github_api原始 API 访问覆盖以上工具未涉及的任意端点实战一一句话创建 PR假设你已经让 mercury-agent 修好了一个 bug直接说为这次改动创建一个 PR。背后的执行链路是git_add→git_commit→git_push→create_pr全程无需你敲一条命令。其中提交信息会自动追加Co-authored-by: Mercury mercurycosmicstack.org尾注实现方式见 git-commit.tscreate_pr通过标准 REST 端点/repos/{owner}/{repo}/pulls发起 POST 请求支持draft参数创建草稿 PR核心实现见 create-pr.ts 小建议改动没把握时先说创建草稿 PR验收通过再让它转为正式 PR。实战二AI 代码审查diff 自动读给你听说一句Review PR #5review_pr工具会做三件事抓取元信息——标题、作者、分支、状态以及改动文件数、增删行数读取 diff——自动截断到前 200 行防止刷屏见 review-pr.ts发布审查意见——带上你的评论直接 POST 到 PR 的 reviews 接口审查总结示例输出PR #5: 修复登录超时 Author: hotheadhacker Branch: fix/login-timeout → main Changed files: 3 | Additions: 42 | Deletions: -7对新手来说这是边看 AI 审查边学的好机会——它能指出你遗漏的边界条件、命名问题审查意见会像同事一样直接贴在 PR 上。实战三Issue 管理从巡检到提报巡检未关闭的 Issue说看看有哪些 open 的 Issuelist_issues会按最近更新时间倒序返回每条附带编号、标题、标签和作者Issues in me/my-project (open): #12 [bug] 登录页白屏 (open, by alice) #9 [enhancement] 支持暗色主题 (open, by bob)也支持按标签过滤比如只看 label 为 bug 的 Issue底层参数封装见 list-issues.ts。一键提报 bug说给登录崩溃提个 bug Issue打上 bug 标签create_issue就会带着标题、Markdown 正文和标签列表提交创建成功即返回 Issue 链接实现见 create-issue.ts。进阶玩法github_api 万能出口当现成工具不够用时github_api是逃生舱支持 GET/POST/PUT/PATCH/DELETE 五种方法推文件PUT /repos/{owner}/{repo}/contents/{path}——本地git push因认证问题失败时可绕过本地 git 直接经 API 提交文件且自动注入 Mercury 共同作者信息见 github-api.ts查分支 / 取文件 / 搜代码GET /repos/.../branches、GET /search/code?q...等安全兜底请求目标被强制锁定在 GitHub API 官方域名token 绝不会随请求泄露到任何第三方主机见 utils/github.ts此外当 API 速率配额低于 100 时智能体会自动告警避免高频调用被封禁。安全与权限要点 ⚠️PAT 仅存本地保存在~/.mercury/下的配置文件中仅发往 GitHub API切勿提交到仓库或分享给他人怀疑泄露时立即轮换写操作需审批git commit、git push等写操作默认走权限确认流程见 git-commit.tsAI 不能越权动手最小权限原则PAT 只勾选必要权限并设置有效期常见问题问题解决方法对话中看不到 GitHub 工具运行mercury doctor确认GITHUB_TOKEN已配置API 报错 403 / rate limit检查令牌权限与剩余配额降低调用频率提交署名想自定义在~/.mercury/.env中设置GITHUB_EMAIL写在最后从mercury doctor一行配置到 PR 创建、代码审查、Issue 巡检的全流程自动化mercury-agent 的 GitHub 助手把开发者从机械操作中解放出来。更多细节可参考官方文档 github-companion 与 内置工具清单。现在就去试试那句为这次改动创建一个 PR吧【免费下载链接】mercury-agentSoul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.项目地址: https://gitcode.com/gh_mirrors/me/mercury-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考