项目自述名称：所在仓库自述为「Sentry Skills」（Sentry 官方多技能合集仓库），本技能自身标题为「PR Writer」。
1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | pr-writer-getsentry-skills | — |
| 作者/维护者 | Sentry（官方 getsentry 组织，主要贡献者 David Cramer，Sentry 联合创始人） | GitHub API |
| 来源链接 | https://github.com/getsentry/skills/tree/main/skills/pr-writer | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 896 | GitHub API |
| Forks（仓库整体） | 46 | GitHub API |
| 最新版本 | 未打 Release 标签，随仓库滚动更新（最近一次功能提交 2026-07-15） | 仓库直读 |
| 安装方式 | Claude Code 插件市场 / skills.sh CLI | 官方 README |
2. 功能介绍与亮点
核心能力：把一次分支变更整理成“给评审者的说明信”，而不是流水账、模板、校验日志或逐文件摘要。技能会先用 git/gh 读取当前分支、已有 PR、基准分支与完整 diff，确保描述基于整条分支的真实变化而非最近一次提交。
- 标题规范：
<type>(<scope>): <subject>结构，类型枚举覆盖 feat/fix/ref/perf/docs/test/build/ci/chore/style/meta/license/revert，明确禁止“update”“misc”“fix stuff”等空泛表述； - 正文形状自适应：按变更规模与风险选择最小必要结构——小改动只写一段话，功能/修复/重构说明变更行为与影响，破坏性变更必须给出受影响接口与迁移方式，跨领域改动要说明范围为何必要、评审该从哪里入手；
- 评审辅助工具菜单化：before/after 对比、Mermaid 图、截图、灰度/兼容/风险提示等作为可选项，只在真正降低评审者理解成本时使用，而非默认堆砌；
- 明确边界：不写默认 Summary/Changes/Test Plan 模板，不粘贴命令行日志或校验转储，不包含客户名称、邮箱、工单内容或密钥，issue 引用仅在分支、提交或用户输入中有据可查时使用；
- 配有 AXIS 自动化评测用例（
skills/pr-writer/evals/），对输出的标题格式、模板残留、评审有用性做确定性检查与模型评审双重把关，是同仓库多个技能里少见的自带回归测试实践。
3. 适用场景
所属分类：工程效率与代码质量。 面向任何使用 Git + GitHub 协作流程、需要频繁开 PR 的开发者与团队，尤其适合评审规范较严格、PR 描述质量直接影响评审效率的工程团队；个人开发者也可用它避免“PR 说明随手一句话带过”的问题。
4. 跨 Agent 兼容性
- Claude Code：原生支持，官方插件市场一键安装（
claude plugin marketplace add getsentry/skills）。 - Codex：支持，仓库通过 skills.sh 生态分发（
npx skills add getsentry/skills），官方文档注明兼容 Cursor、Cline、GitHub Copilot 等代理；仓库同时维护了面向 Codex 的调用策略配置基础设施。 - OpenClaw：未验证，抓取材料中未见明确说明。
- Hermes Agent：未验证，抓取材料中未见明确说明。
5. 推荐理由
把“写 PR 说明”这件常被应付了事的工作产品化成一套可执行规则——什么该写、什么时候该展开、什么时候该省略，并配有真实评测用例做质量校验，能实质减少评审来回追问背景的沟通成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集仓库整体星数不代表单个子技能热度；该子技能提交与维护均由同一位作者（Sentry 联合创始人）独立完成，未发现外部贡献者或第三方测评 |
| 可用性 | 8 | SKILL.md 结构清晰、含正反例与边界说明，安装为一条插件命令；唯一依赖是已认证的 gh CLI（免费、开发者常备工具）；最近一次功能提交在近一个月内 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单：
① 执行 git/gh 命令读取分支状态与创建/更新 PR 草稿，范围明确、可审计，不会自动批准或合并 PR；
② 联网行为仅通过用户自身已认证的 gh CLI 与 GitHub API 通信，目标透明；
③ 不索取或存储任何独立凭据，复用用户已有的 gh 登录态；
④ 全文通读 SKILL.md/SPEC.md，未见可疑指令或混淆内容；
⑤ 官方 Sentry 组织仓库，主要贡献者为公开身份的联合创始人，无造假迹象；
⑥ License 为 Apache-2.0，明确；
⑦ 最近一次功能性提交为 2026-07-15，属活跃维护。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 pr-writer 的差异 |
|---|---|---|
| pr-writer（本技能） | 撰写/刷新 PR 标题与正文 | 聚焦“提交评审前”的说明质量 |
| iterate-pr（同仓库） | 持续修复 CI 失败与评审反馈直至可合并 | 聚焦“提交评审后”的迭代闭环，保留人工审批与合并门禁；两者在同一 PR 生命周期中前后衔接、互不重叠 |
市面上通用代码助手大多把 PR 描述当作 commit 信息或模板的简单拼接，专门为“评审者阅读体验”单独建规则、并配自动化评测的技能并不多见，这是 pr-writer 与泛用型工具的主要差异。
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价。
9. 其他补充
技能自带 SPEC.md（意图、范围、已知局限、维护说明）与 EVAL.md（AXIS 评测运行方式），文档层次比多数同类技能更完整，便于后续维护者理解设计决策而非只读规则本身。
10. 安装使用方式
Claude Code：
claude plugin marketplace add getsentry/skills
claude plugin install sentry-skills@sentry-skills安装后需重启 Claude Code，技能会在打开或更新 PR 时按描述关键词自动触发。
其他兼容 Agent（含 Codex）：
npx skills add getsentry/skills使用前需确保本机已安装并登录 GitHub CLI（gh auth login），技能依赖它读取分支/PR 信息并创建、更新 PR。
11. 注意事项
- 依赖已认证的
ghCLI，未安装或未登录时无法工作； - 技能只负责撰写标题与正文，不涉及提交代码、运行 CI 或处理评审反馈，需要那类能力应配合同仓库的 iterate-pr 一起使用；
- 面向 Sentry 内部约定设计的标题类型枚举（如
ref、meta）与部分团队的 Conventional Commits 习惯略有出入，跨团队使用前建议先浏览一遍规则再决定是否需要微调。