PR合并前还在手动对标题和代码？pr-finalize帮你两步搞定🔥

什么是pr-finalize

每次合并PR前，你是不是都要反复确认：标题写对了吗？描述和实际改动对得上吗？代码有没有低级错误？这些事情做起来不难，但就是烦。pr-finalize是一个专门为PR合并前检查设计的Skill，把”标题描述核查”和”代码审查”两件事合并成一个自动化流程，让你在合并前心里有底。

核心功能

pr-finalize的工作分两个阶段，逻辑清晰，互不干扰。

第一阶段：标题与描述核查

它会先读取当前PR的标题和描述，判断内容质量。如果原描述写得好，它只会补充缺失的部分（比如NOTE块或Issue链接），不会把你精心写的内容替换成模板。如果描述确实太简陋，它才会给出结构化的重写建议，包含根因分析、改动说明、不该做什么等对未来Agent友好的字段。

标题方面，它遵循一套可搜索的格式规范：

[Platform] Component: What changed (model change if any)

比如 [iOS] SafeArea: Return Empty for non-ISafeAreaView views (opt-in model)，这样的标题在git历史里一眼就能找到。

第二阶段：代码审查

描述确认后，它会对PR的diff进行代码审查，重点关注：代码可维护性、错误处理与边界条件、性能隐患（比如不必要的内存分配、N+1查询）、平台差异（iOS/Android/Windows）、以及可能影响现有代码的破坏性变更。审查结果分三级输出：🔴 严重问题、🟡 建议优化、✅ 没问题的部分。

有一点值得特别说明：pr-finalize是纯分析型Skill，它只输出分析结果给你看，绝对不会自动发评论、自动审批或自动拒绝PR。所有操作权限都在你手里。

适用平台

pr-finalize作为一个标准Skill，可以无缝集成到主流AI编程助手的工作流中。无论你用的是Cursor、GitHub Copilot、Claude Code、OpenAI Codex，还是Gemini Code Assist、文心快码、腾讯云CodeBuddy、华为云CodeArts，都可以直接调用这个Skill。它能显著增强AI对PR上下文的理解能力，让代码审查不再依赖人工逐行盯着看。

实操代码示例

调用方式非常直接，用GitHub CLI拉取PR信息就能触发分析：

# 获取PR当前状态（无需本地checkout）
gh pr view 12345 --json title,body
gh pr view 12345 --json files --jq '.files[].path'

# 查看提交信息
gh pr view 12345 --json commits --jq '.commits[].messageHeadline'

# 获取代码diff
gh pr diff 12345

把这些命令的输出交给pr-finalize，它就会开始两阶段分析，最终给你一份结构清晰的报告。

优势分析

市面上不少代码审查工具要么只看代码、不管描述，要么会直接修改PR内容，让人不放心。pr-finalize的差异化在几个地方：

• 描述质量优先：它会先评估现有描述的质量，而不是无脑套模板。好的描述会被保留，只补充缺失项。
• 对未来Agent友好：它要求PR描述包含”不该做什么”这类字段，防止未来的AI Agent重复踩坑。
• 严格的权限边界：不自动审批、不自动发评论，所有决策权归人类。这在团队协作场景里非常重要。
• 独立Skill设计：不依赖特定的PR创建流程，任何PR都能用，不只是配套工具创建的PR。

应用场景

• Review轮次多的PR：经过多轮修改后，描述往往和最终实现对不上。pr-finalize能快速发现这种”描述滞后”问题。
• 跨平台项目：iOS/Android/Windows各平台的改动边界容易混淆，代码审查阶段的平台差异检查能帮你提前发现问题。
• 新人提交的PR：描述质量参差不齐，pr-finalize能给出具体的改进建议，而不是直接否定。
• AI Agent生成的PR：AI写的代码和描述有时会有偏差，合并前跑一遍pr-finalize是个好习惯。

最佳实践

在工程落地时，有几个点值得注意。首先，把pr-finalize设置为合并前的固定检查步骤，而不是”感觉有问题才用”，养成习惯后能大幅减少合并后才发现描述错误的情况。

其次，充分利用”What NOT to Do”字段。当你在调试过程中尝试了某个方案但最终放弃，一定要把原因写进去。这对后续维护这段代码的人（无论是人还是AI）都是极有价值的信息。

另外，标题格式建议在团队内统一约定，比如是否强制加Platform前缀、Component命名规范等。pr-finalize会按照你的标题给出评估，前提是团队对”好标题”有共识。

如果你在管理多个项目的PR工作流，Skill优仓上有大量类似的工程效率类Skill，可以把pr-finalize和其他Skill（比如learn-from-pr、write-tests-agent）组合使用，搭建一套完整的PR自动化流水线，减少重复的人工操作。