pr-triage

PR Triage Bot

Prax 的杀手锏在这：不只"让 LLM 看 diff 给点评"，而是真的 checkout 出来、真的跑测试、真的看新增依赖有没有 CVE。结果比纯 LLM 评论可信一个量级。

何时触发

• 用户粘 PR URL 或说"triage #42"
• cron 每天早上 8 点扫 open PRs
• GitHub webhook 触发（需要额外 hook 配置，本 skill 不负责触发）

输入

• 必需：PR URL 或 #NNN（本仓库的话）或 PR 分支名
• 可选：仓库路径（默认当前 cwd）

预检（不满足就停）

# 1. 在 git 仓库里
git rev-parse --show-toplevel

# 2. 有 gh CLI 吗？
command -v gh && gh auth status 2>/dev/null

没 gh 时走 降级路径（见 Step 2b）。没 git 仓库直接报错。

输出

一份 markdown 审查笔记：

.prax/pr-triage/pr-<NNN>-<YYYYMMDD-HHMMSS>.md

不自动 approve / merge / close / comment 到 GitHub。所有外部动作都必须用户明确再触发一次。

工作流程

Step 1：拿 PR metadata

# 完整路径
gh pr view <url> --json number,title,body,files,author,baseRefName,headRefName,additions,deletions,commits

# 提炼
NUM=$(echo $JSON | jq -r '.number')
TITLE=$(echo $JSON | jq -r '.title')
BASE=$(echo $JSON | jq -r '.baseRefName')
HEAD=$(echo $JSON | jq -r '.headRefName')
STATS="+$(echo $JSON | jq -r '.additions'),-$(echo $JSON | jq -r '.deletions')"
FILES=$(echo $JSON | jq -r '.files | length')

Step 2：拿 diff 本体

gh pr diff <url> > /tmp/pr-<NUM>.diff
wc -l /tmp/pr-<NUM>.diff

Step 2b：gh 不可用的降级

没 gh CLI 时：

# 本仓库的 PR：如果本地 remotes 里有 pull/<num>/head refspec
git fetch origin pull/<NUM>/head:pr-<NUM> 2>/dev/null
git diff origin/<base>...pr-<NUM> > /tmp/pr-<NUM>.diff

如果连 fetch 也不行（外网受限）→ 退化成只读远端分支名模式，不跑测试，只产出分类 + 手动审查清单。

Step 3：分类（硬枚举）

用 PR title + 首个 commit message + files-changed 启发式：

分类	证据
feature	title 含 feat(...) / 新文件多 / +100 以上
bug	title 含 fix(...) / 行数均衡增删
refactor	title 含 refactor / 纯结构调整
chore	title 含 chore / 仅 config/yaml
docs	仅 *.md 变更
hotfix	含 hotfix 或 urgent

一个 PR 可以多标签，取最强一个作为主分类。

Step 4：风险评分

硬规则，每触发一条加一分：

规则	分数
patch > 500 行	+2
patch > 1000 行	+3（累加）
触达 >10 个文件	+2
改 package.json/requirements.txt/Cargo.toml/go.mod 且有新增依赖	+2
改 auth/security/permission/middleware 相关文件	+2
改 CI / .github/workflows/	+2
改数据库迁移文件	+3
PR body 空	+1
没测试伴随（仅 src 没 test）	+2