用途
该技能用于自动化 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 执行结构化的代码评审。
限制
技能的具体收费、价格、平台支持范围,以及除上述内容外的其他功能细节暂未提供。