SuperAPI AI 工具集

pr

编程与开发

查看项目

更新于 10-16 06:04

技能介绍

用途

该技能用于自动化 Git 与 GitHub 协作流程,重点围绕 Pull Request(PR)的管理。它把常见的 PR 创建、草稿 PR 创建和 PR 代码评审三类操作整理为标准化工作流,适合在开发协作中快速发起和处理 PR。

主要能力

技能提供三类核心操作:

  • 创建 PR:生成带有完整描述的正式 PR。
  • 创建草稿 PR:创建进行中的(WIP)PR,且不会自动触发评审。
  • 评审 PR:对代码进行分析并给出严重程度评级。

技能内还汇总了一批常用 GitHub CLI 命令,按用途分为几组:

PR 信息:

gh pr view [number]                    # View PR
gh pr list                             # List PRs
gh pr diff [number]                    # Get diff

PR 创建:

gh pr create --title "" --body ""      # Regular PR
gh pr create --draft --title "" --body ""  # Draft PR

PR 更新:

gh pr edit --body ""                   # Update description
gh pr comment [number] --body ""       # Add comment
gh pr ready [number]                   # Mark draft ready

评审:

gh pr review [number] --approve --body ""
gh pr review [number] --request-changes --body ""
gh pr view [number] --comments         # View comments

Git 命令:

git branch --show-current              # Current branch
git status                             # Check changes
git diff [--cached]                    # View changes
git log --oneline -n 5                 # Recent commits

使用方式

技能通过用户请求中的关键词判断应执行的操作,并加载对应的参考文件:

  • 用户说 "Create a PR" → 读取 references/create.md
  • 用户说 "Create a draft PR" 或 "Draft PR" → 读取 references/draft.md
  • 用户说 "Review PR" 或 "Review this PR" → 读取 references/review.md

每个参考文件包含该操作的完整工作流、模板和最佳实践。

约定规范

技能规定了分支命名约定:

  • feature/description:新功能
  • fix/bug-description:缺陷修复
  • refactor/component-name:代码重构
  • docs/update-readme:文档
  • test/add-unit-tests:测试补充

提交信息约定:

  • feat::新功能
  • fix::缺陷修复
  • refactor::代码重构
  • docs::文档
  • test::测试
  • chore::维护
  • style::格式调整

适用场景

适用于需要按统一流程创建、更新和评审 GitHub PR 的开发协作场景,包括提交正式 PR、提交草稿 PR 以便进行中工作获得反馈、以及对已有 PR 执行结构化的代码评审。

限制

技能的具体收费、价格、平台支持范围,以及除上述内容外的其他功能细节暂未提供。