这个Skill在做什么
做过.NET MAUI开发的人都懂那种痛：仓库里几十个open PR堆在那，不知道先看哪个，P/0的紧急需求淹没在社区贡献里，milestone快到了还没人动。find-reviewable-pr这个Skill就是专门解决这个问题的——它会自动扫描dotnet/maui和dotnet/docs-maui两个仓库，按照优先级把PR分好类，直接告诉你该先看哪个。
核心功能
这个Skill的核心是一套完整的PR优先级排序逻辑，分9个层级，从高到低依次是：
- P/0紧急PR：阻塞发布的关键问题，永远排第一
- 已审批未合并：有人工approval但还没merge的，CI绿了直接合
- 项目看板Ready To Review列：需要
read:project权限，从MAUI SDK项目板拉取 - Milestone PR：按SR编号从小到大排（SR5优先于SR6），有截止日期的优先
- AI Agent已审阅：被AI工作流分析过的PR，通过label识别
- Partner PR：Syncfusion等合作伙伴的贡献，有商业优先级
- 社区贡献：外部贡献者的PR，需要更细致的review
- 近期等待Review：最近两周创建的PR，快速响应留住贡献者
- docs-maui文档PR：文档类PR单独列出，默认最少显示5条
每条PR还会标注复杂度：5个文件以内、200行以内是Easy；6-15个文件或200-500行是Medium；超过15个文件或500行就是Complex。一眼就能判断这个PR要花多少时间。
适用平台
find-reviewable-pr作为一个PowerShell脚本驱动的Skill，可以无缝集成到主流AI编程助手的工作流中。无论你用的是Cursor、GitHub Copilot、Claude Code还是OpenAI Codex，都可以直接在对话里说”帮我找一个PR来review”，AI会自动调用这个Skill，把结果整理好呈现给你。对于用Gemini Code Assist、文心快码、腾讯云CodeBuddy或华为云CodeArts的团队，这个Skill同样能作为上下文增强工具，让AI更准确地理解当前仓库的review状态。
实操代码示例
最常用的几个命令，直接复制就能跑：
# 默认模式：只看P/0和milestone PR，排除changes-requested
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1
# 看所有分类
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category all
# 只看已审批等待合并的
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category approved
# 只看Android平台相关PR
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Platform android
# 排除特定作者，每类最多显示5条
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -ExcludeAuthors PureWeen,rmarinho -Limit 5输出格式支持三种：review（默认，适合人工阅读）、table（表格）、json（适合接入自动化流水线）。
优势分析
跟直接用gh pr list手动查相比，这个Skill的核心优势在于排序逻辑不可替代。milestone的SR编号排序（SR5必须在SR6前面）、P/0永远置顶、社区PR和Partner PR分开处理——这些逻辑如果用ad-hoc的gh命令拼，很容易出错。Skill的文档里明确写了：脚本失败时直接停下来报错，不要尝试fallback查询，因为fallback会绕过这套排序逻辑，返回错误的顺序。这种”宁可报错也不给错误结果”的设计思路，在团队协作场景里非常重要。
另一个亮点是双仓库覆盖。dotnet/maui和dotnet/docs-maui同时扫描，文档PR和代码PR分开展示，不会互相干扰，也不会漏掉文档侧的review需求。
应用场景
- 每日站会前：团队lead跑一次默认模式，5秒钟知道今天最紧急的PR是哪几个，直接分配给对应的人
- Release冲刺阶段：用
-Category milestoned专注当前milestone的PR，配合-Limit控制每次处理量，不被其他噪音干扰 - 社区维护日：用
-Category community专门处理外部贡献，快速响应提升社区活跃度 - CI/CD集成：用
-OutputFormat json把结果接入Slack通知或内部看板，自动推送待review列表给相关人员 - 跨平台专项review：用
-Platform android或-Platform ios过滤，让平台专家只看自己负责的部分
最佳实践
用这个Skill有几个点值得注意。首先是权限配置：如果输出里出现缺少read:project权限的警告，项目看板数据就拿不到，跑一下gh auth refresh -s read:project补上就行。这个权限对于”Ready To Review”分类是必须的。
其次是结果展示完整性：AI助手在呈现结果时，必须把所有分类都展示出来，不能因为某个分类PR数量少就省略。每个分类表格应该包含PR编号、标题、作者、Assignees、平台/仓库、状态、AI Review情况、创建时间、最后更新时间这几列，信息缺一不可。
还有一个容易忽略的点：脚本报错时不要自作主张。遇到HTTP 502或网络错误，直接告诉用户”GitHub API暂时不可用，稍后重试”，不要用gh命令手动查作为替代，因为那样会破坏优先级排序的准确性。
对于需要管理大量开源仓库review流程的团队，像find-reviewable-pr这样的Skill能显著降低review协调的沟通成本。Skill优仓上汇聚了大量类似的工程效率类Skill，覆盖代码review、CI/CD、文档生成等场景，如果你的团队在搭建AI辅助的开发工作流，可以去Skill优仓找找有没有能直接复用的现成方案，省去从零搭建的时间。
暂无评论内容