用途:对 Pull Request 的变更内容进行分诊,为后续代码评审阶段结构化输出所需信息;设计上假定以轻量模型(Haiku)运行,以降低 CI 环境成本。
主要能力:通过 gh pr view 与 gh pr diff 获取 PR 信息、变更文件列表与差分;对变更文件做 added/modified/deleted 分类;检测所用语言与框架;判定变更类别(权限、DB、RLS、API、测试、配置、技能);判定所需参考文件;检测 Minor/Suggestion 级表层问题;生成 200 字以内的差分摘要与需关注的评审要点。
使用方式:用 gh pr view <PR番号> --json title,body,headRefName,baseRefName,changedFiles 获取 PR 信息,用 gh pr diff <PR番号> --name-only 获取变更文件列表;changedFiles 小于 15 时再用 gh pr diff <PR番号> 获取代码差分,表层检查目标文件多时可用 gh pr diff <PR番号> -- <file> 逐个获取;检查 .pr-review-state.json 是否存在以决定是否启用增量模式;最终将结果写入 .pr-triage.json。增量模式下以 git diff <last_reviewed_commit>..HEAD --name-only 定位自上次评审后变更的文件,未变更文件的 surface_issues 以 "carried_over": true 沿用,仅对变更文件重做表层检查,并在输出中加入 incremental、base_commit、changed_since_last_review、unchanged_since_last_review、resolved_issues 字段。若 .pr-review-state.json 不存在或格式非法(如 JSON 解析错误),则输出警告并执行全量分诊,不得基于损坏的状态文件运行增量模式。
所需参考判定:TypeScript/JavaScript 变更对应 typescript-best-practices.md;认证授权相关变更对应 authorization-review-general.md;PostgreSQL RLS 相关变更对应 authorization-review-postgres-rls.md;SKILL.md 变更对应 skill-review.md;CI 环境需要投稿 GitHub 时始终包含 github-pr-review-actions.md。
限制:changedFiles 为 15 以上时跳过差分获取,仅依据文件名与 PR 说明分析;表层检查仅覆盖指定类型的问题(any 类型、var、空接口、魔法数字、命名规则、新文件缺测试)。输出结构、字段与格式以资料给定为准,具体价格、平台支持范围等未提供。