核心用法
gh-modify-pr 是一款面向 GitHub 协作开发的自动化技能,核心功能是将 PR(Pull Request)中的评审意见转化为可执行的代码修改,并在本地完成 commit。使用时只需提供 PR URL,技能即可自动完成以下流程:
1. 解析 PR 信息:提取仓库 owner/repo、PR 编号、标题、分支等元数据
2. 抓取评审意见:通过 GitHub CLI (gh) 和 REST API 获取内联评论(inline comments)
3. 本地环境准备:若工作区无仓库则自动克隆,存在则 checkout 到 PR 分支
4. 智能代码修改:解析评论内容,定位需修改的文件行,实施精确编辑
5. 本地提交:生成清晰的 commit message,记录变更
6. 可选推送:仅在用户明确批准后才执行 git push
显著优点
- 评审驱动开发闭环:将"看评论-改代码-提commit"的繁琐流程自动化,减少上下文切换
- 精准定位修改:基于 GitHub PR 评论的 diff 位置信息,避免人工定位行号的误差
- 安全可控:默认仅本地提交,推送需显式授权,防止误操作覆盖远程
- 环境自适应:自动检测本地仓库状态,智能处理克隆/分支切换
- 审计友好:完整记录操作日志,包含失败尝试,便于追溯
潜在局限
- 评论理解依赖 NLP 解析:非结构化评论(如"这里不太对")可能需要人工澄清
- 仅支持 GitHub 生态:依赖
ghCLI 和 GitHub API,不兼容 GitLab、Bitbucket 等 - 二进制/大规模重构受限:复杂跨文件重构可能超出单轮修改能力
- 权限前置:需预配置 SSH key 或 HTTPS token 才能克隆私有仓库
适合人群
- 高频处理 PR 评审的后端/全栈开发者
- 维护多个开源项目的技术负责人
- 希望减少机械劳动、专注代码逻辑的效率追求者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 误解析风险 | AI 误解评论意图导致错误修改 | 技能内置"模糊即询问"规则,强制澄清 |
| 代码冲突 | 本地分支与远程不同步 | 自动检测,提示用户先同步 |
| 凭证泄露 | 克隆私有仓时 token 暴露 | 依赖系统级凭证管理,不硬编码 |
| 未授权推送 | 自动 push 造成意外发布 | 默认禁用推送,需显式确认 |
---
> 来源说明:本技能基于 GitHub 官方 CLI 工具链(gh + git),命令集经过官方长期验证,稳定性高。