SuperAPI AI 工具集

pr

编程与开发

查看项目

更新于 10-16 05:30

技能介绍

用途

该技能用于自动化 Git 与 GitHub 工作流,围绕拉取请求提供三类核心操作:创建普通 PR、创建草稿 PR、审查 PR。用户提出相应请求后,技能会按对应工作流执行。

主要能力

创建 PR

创建普通 PR,并生成较完整的描述信息。对应操作是用户请求“创建 PR”时,读取创建参考文档(references/create.md),其中包含完整工作流、模板与最佳实践。

创建草稿 PR

创建进行中(WIP)的草稿 PR,不会自动触发审查。对应操作是用户请求“创建草稿 PR”或“草稿 PR”时,读取草稿参考文档(references/draft.md)。

审查 PR

对代码进行分析,并给出严重程度评级。对应操作是用户请求“审查 PR”或“审查这个 PR”时,读取审查参考文档(references/review.md)。

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

使用方式

技能提供常用 GitHub CLI 命令,分为几类:

PR 信息相关:

gh pr view [number]                    # 查看 PR
gh pr list                             # 列出 PR
gh pr diff [number]                    # 获取 diff

PR 创建相关:

gh pr create --title "" --body ""          # 普通 PR
gh pr create --draft --title "" --body ""  # 草稿 PR

PR 更新相关:

gh pr edit --body ""                   # 更新描述
gh pr comment [number] --body ""       # 添加评论
gh pr ready [number]                   # 将草稿标记为可审查

审查相关:

gh pr review [number] --approve --body ""
gh pr review [number] --request-changes --body ""
gh pr view [number] --comments         # 查看评论

Git 命令相关:

git branch --show-current              # 当前分支
git status                             # 检查改动
git diff [--cached]                    # 查看改动
git log --oneline -n 5                 # 最近提交

工作流选择

根据用户请求确定操作:

  • “创建 PR” → 读取 references/create.md
  • “创建草稿 PR”或“草稿 PR” → 读取 references/draft.md
  • “审查 PR”或“审查这个 PR” → 读取 references/review.md

命名与提交约定

分支命名约定:

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

提交信息约定:

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

适用场景

适用于需要按既定工作流创建 GitHub 普通 PR、草稿 PR,或对 PR 进行代码审查并获取严重程度评级的场景,也适用于需要参考分支命名和提交信息约定的开发协作流程。

限制

资料未说明该技能的安装方式、收费情况、支持平台及其他未提及的限制。