Agent Skills
返回列表
💻

Sentry 规范 PR 创建器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/create-pr。

技能介绍

问题:PR 描述常常像提交日志

工程师创建 PR 时容易把 diff、测试步骤、模板复选框堆在一起,审查者难以快速判断变更动机、影响面和需要重点看的区域。尤其在一个仓库中同时处理功能、修复和重构时,缺乏统一提交信息与 PR 结构会让审查反复拉扯。

工作方式:从提交状态到可审查 PR

该技能围绕 GitHub CLI gh 的已认证环境运行。它先检查分支是否干净、与远程同步,以及是否需要变基;如果存在未提交变更,会先引导使用 sentry-skills:commit 处理。随后分析变更范围,按 Sentry 工程实践生成 PR 标题和描述。

核心输出包括:

  • 标题遵循 feat(scope)、fix(scope)、ref 等提交约定
  • 描述聚焦为什么改、上下文、需要重点审查的点
  • 使用 Fixes #1234、Refs LINEAR-ABC-123 等语法关联 Issue
  • 建议每个功能或修复单独 PR,保持较小范围便于审查

适用边界

它适合需要在创建 PR 阶段约束标题、描述和 Issue 引用的场景。若仓库强依赖 PR 模板,技能会忽略仓库模板而采用 Sentry 结构。编辑已存在 PR 时,它建议用 gh api 而不是 gh pr edit,因为后者与 GitHub 经典版 Projects 弃用相关存在缺陷。没有认证 gh 或未完成提交时,不应直接创建 PR。

使用场景

  • 提交功能分支后,需要按 Sentry 规范生成 feat(scope) 标题和说明变更原因的 PR 描述。
  • 修复缺陷前,先确认没有未提交变更,再创建包含 Fixes #1234 和审查重点的 PR。
  • 准备重构时,将改动限制为单一 ref 范围,并生成不含复选框测试步骤的简洁描述。
  • 创建草稿 PR 获取早期反馈,之后需要用 gh api 更新 PR 内容而不是 gh pr edit。

适合人员

  • 需要在 Sentry 规范仓库提交功能 PR 的工程师,希望标题和描述一次符合审查要求。
  • 负责代码审查的维护者,希望 PR 描述突出变更原因、关联 Issue 和需细看区域。
  • 使用 GitHub CLI 管理 PR 的研发工程师,希望创建前先确认提交、同步和变基状态。
  • 处理缺陷修复和 Issue 关联的工程师,希望正确写入 Fixes 或 Refs 而不关闭无关工单。