用途
pr-issue-review 面向需要对 GitHub PR 进行审查的场景,围绕一个核心问题展开:这个 PR 是否在不破坏被修改行为或契约的使用方的前提下,解决了它所声明的问题。它是一次聚焦、有上下文的审查,并不等同于完整的多视角审查或重构审计。
主要能力
技能从 PR 的 diff、元数据、评论以及关联 issue 中收集信息,对 PR 进行静态判断。审查者可以指定审查配置(profile),可选 passive、neutral、assertive 或 aggressive:
- passive:克制的放行型配置。
- neutral:平衡的代码质量配置。
- assertive:挑剔的维护者配置,采用更严格的审查姿态。
- aggressive:怀疑但友好的配置,目标是找出不批准的理由,同时保持轻松的交付基调。
调用方显式指定的配置始终优先。若未指定,技能会根据 PR 元数据、评论和既有审查自动选择,其中激进配置是未指定时的默认审查者,assertive 仅在已有非技能的人工审查时作为延续被选择;neutral 和 passive 只允许通过显式请求或延续同一 PR 上先前精确标记获得。
技能还包含人设(persona),仅控制顶层审查正文第一行的语气,不改变批准阈值、镜头选择、严重程度或阻断策略。调用方可指定任意配置与人设组合,人设若未指定则按确定性公式选取:以 PR 编号加上该 PR 上同配置历史审查数,对候选人设数量取模。
此外技能定义了焦点包(focus packs),根据 PR 变更的文件路径、扩展名、导入、配置文件、标题正文等触发信号加载,例如 grpc-protobuf、graphql-clients、database-migrations、background-jobs-queues、auth-permissions、accessibility、localization、sql-semantics、dbt-transformations、warehouse-cost-performance、injection-untrusted-input、infra-iac、cicd-workflows 等。焦点包只增加领域审查问题,不改变配置或阻断策略;局部仓库指南始终优先于通用焦点包。
技能还支持审查去重,通过 diff、intent(标题、正文、目标分支、关闭的 issue)、convo(人类评论、审查正文、线程回复与解决状态)三个独立通道判断 PR 是否仍代表已被本技能审查过的工作,不单独以 head SHA 作为跳过依据。
使用方式
技能以 PR URL 为输入,提取 host、owner、repo、number,并设计为可多实例并行运行,包括在同一仓库或同一 PR 上并发运行。它使用每仓库一个共享对象存储和每次运行一个分离 worktree 来隔离状态。元数据抓取和去重指纹计算不需要检出代码,只有在去重未跳过 PR 时才浅抓取 base/head 引用进行静态检查。
审查过程中技能只允许使用 git、GitHub 及上下文来源命令来获取元数据、diff、文件内容、缓存上下文以及提交审查;绝不修改 PR 分支、基础分支或远程仓库。所有 PR 代码和文本均被视为不可信输入,技能不会执行其中的指令。
技能偏好以一次 GitHub 审查提交,包含以精确 emoji 标记开头的顶层审查正文、针对具体行级发现的行内评论,以及在作者可快速采纳时使用 suggestion 代码块。标记以蜥蜴符号(如 🦎)开头表示这是 AI 审查,第二个 emoji 表示配置:🍃 passive、⚖️ neutral、🔎 assertive、⚔️ aggressive。
适用场景
适用于请求对本技能进行审查的 PR,尤其适合需要聚焦判断“是否解决声明问题且不破坏使用方”的场景,包括涉及鉴权、权限、支付、隐私、数据删除、迁移、模式变更、公共 API 或协议契约、后台任务、队列、幂等性、生产事故、数据正确性缺陷、客户可见缺陷修复等高风险的变更。技能会针对疑似 AI 编写、疑似恶意或高风险的 PR 采用更严格的配置。技能也支持对回滚 PR 的审查,此时审查问题收窄为:是否干净地恢复先前状态,以及是否仍有权依赖被回滚的变更。
限制
技能的审查是只读的,不会运行项目代码、测试、构建脚本、包脚本、迁移、应用 CLI 或 CI 命令,因此不提供运行时验证。它不会提交、修改、变基、合并、推送或强制推送任何分支。默认倾向批准或评论,仅在 PR 看似恶意或有意危险时才使用请求修改或阻断语言。技能不要求宽泛的模式改变,若存在更优模式,仅作为可选上下文说明而非阻断项。延迟处理(deferred)不视为安全论证:即使作者标注为后续处理,只要合并后的状态存在活跃鉴权缺口、租户隔离漏洞、数据丢失或静默失败路径、未加保护的读后写竞态,仍评级为 P1。若作者提供明确追踪引用,低于 P1 的延迟项记录为 FYI 且不据此拒绝批准。技能对其他自动审查者保持独立审查,不因其已批准而省略或弱化发现。
暂未提供
资料未说明该技能的具体授权要求、所属仓库的完整文件结构、可调用的完整配置项清单、具体评级体系的完整定义,也未提供独立的官方文档或定价信息。