用途:该技能在 dotnet/maui 与 dotnet/docs-maui 仓库中查找适合评审的开放拉取请求(PR),并按重要程度排序,便于维护者快速定位需要评审的 PR。
主要能力:按优先级(P/0)、已批准未合并、项目看板 Ready To Review、已分配里程碑、AI 智能体已评审、合作伙伴(如 Syncfusion)、社区贡献、近期等待评审以及 docs-maui 等待评审等类别筛选。支持按平台(android、ios、windows、maccatalyst、all)过滤,支持排除或仅包含特定作者,并可限制每个类别的返回数量。脚本内置里程碑排序逻辑(如 SR5 先于 SR6)。
使用方式:通过 PowerShell 执行脚本,例如查询默认行为:
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1
常用参数包括 -Category、-Platform、-Limit、-RecentLimit、-DocsLimit、-ExcludeAuthors、-IncludeAuthors、-OutputFormat。类别值有 default、milestoned、priority、recent、partner、community、docs-maui、approved、ready-to-review、agent-reviewed、all。
脚本参数中,-Limit 取值为 1-100,默认 100;-RecentLimit 与 -DocsLimit 默认为 5,且强制最小值为 5;-OutputFormat 支持 review、table、json,默认 review。若脚本失败(如 HTTP 502、网络或认证问题),应停止并报告错误,建议稍后重试,不应改用 gh 或 jq 直接查询,以免绕过里程碑优先级逻辑。若输出提示缺少 read:project 权限,需提醒用户执行 gh auth refresh -s read:project。展示结果时应覆盖脚本返回的所有类别,并给出 PR、标题、作者、指派、平台/仓库、状态、智能体评审、年龄、更新时间等列。
适用场景:维护者日常挑选评审对象、需要按里程碑或优先级推进评审、以及同时兼顾主仓库与文档仓库的评审任务。
限制:功能依赖 GitHub API 与相应权限(项目看板数据需 read:project 权限);仅面向 dotnet/maui 与 dotnet/docs-maui 两个仓库;未提供离线或非 GitHub 环境的使用方式。