该技能用于在用户要求创建 PR、提交审核或提及“PR 생성/만들기”时创建 GitHub Pull Request,并声明会覆盖默认的 PR 创建流程。
用途:面向需要按固定规范创建 Pull Request 的 GitHub 项目,尤其强调任务校验、测试执行与 Conventional Commits 格式。
主要能力:
- 校验环境:检查 GitHub CLI 版本与登录状态(gh --version && gh auth status),未安装时提示通过 brew install gh 安装并 gh auth login 登录。
- 确认目标分支:创建前必须询问用户,常见流向为 feature 分支到 develop(资料称约 90% 情况),以及 develop 到 master/main 的发布。
- 收集信息:获取当前分支、相对基础分支的提交列表、变更文件统计和远程跟踪状态。
- 查找任务文档:在 .kiro/specs//tasks.md、docs/specs//tasks.md、specs/*/tasks.md 或项目根目录的 tasks.md 中查找任务说明。
- 分析提交:识别类型(feat、fix、refactor、docs、test、chore、ci、perf、style)、作用域(kebab-case)、任务引用(如 task X.Y、Task X、#X.Y)以及破坏性变更标记。
- 运行测试:根据项目类型执行 make test、npm test 或 pytest,测试必须通过后才创建 PR。
- 确定 PR 类型:按分支流向映射 PR 类型与标题前缀,例如 feature/* 到 develop 用 feat(scope):,fix/* 到 develop 用 fix(scope):,hotfix/* 到 main 用 hotfix(scope):,develop 到 main 用 release:,refactor/* 到 develop 用 refactor(scope):。
- 生成内容:标题格式为 <type>(<scope>): <description>,类型取主导提交类型(feat > fix > refactor),作用域取提交中最常见的作用域,描述使用祈使语气、小写、不加句号、不超过 50 字符;正文包含 Summary、Changes、Test Plan、Related 等段落。
- 建议标签:按提交类型映射标签,如 feat 对应 feature、enhancement,fix 对应 bug、bugfix,refactor 对应 refactoring、tech-debt,docs 对应 documentation,ci 对应 ci/cd,security 对应 security,并可通过 gh label list 查看可用标签。
- 创建 PR:先向用户展示内容,确认后使用 gh pr create 指定标题、正文、基础分支和标签,正文通过 HEREDOC 保留格式。
使用方式:按快速开始步骤检查 gh、收集信息、运行测试,再执行 gh pr create;完整流程按核心工作流逐步执行。信息收集清单包括当前分支、与用户确认的基础分支、带类型和作用域的提交列表、变更文件摘要、任务文档(若存在)、测试结果(必须通过)和仓库可用标签。
重要规则:绝不修改仓库文件(只读分析);始终与用户确认目标分支;始终在创建前运行测试;始终在创建前展示 PR 内容以供批准;未经用户确认绝不创建 PR;正文始终使用 HEREDOC。相关技能包括 git-commit(提交信息格式与约定)、pr-merge(合并已有 PR)、pr-review(处理 PR 评审意见)。
限制:资料未说明该技能支持的平台范围、收费方式、价格或具体效果;其行为依赖项目自身测试命令与 GitHub CLI 环境。