AgentSkillsCN

gh-pr-results-review

通过GitHub CLI审查GitHub拉取请求的CI结果,并从GitHub Actions日志中提取可操作的失败详情。当被要求检查失败的PR检查、查看lint/测试/类型检查错误、识别失败的作业,或总结PR流水线为何失败、应优先修复哪些问题时使用此功能。

SKILL.md
--- frontmatter
name: gh-pr-results-review
description: Review GitHub pull request CI outcomes with the GitHub CLI and extract actionable failure details from GitHub Actions logs. Use when asked to check failing PR checks, inspect lint/test/type-check errors, identify failing jobs, or summarize why a PR pipeline failed and what to fix first.

GH PR Results Review

Workflow

  1. Identify the PR number and check status.
  • Run:
bash
gh pr checks <pr-number> 2>&1
  • Capture failing checks, durations, run URL, and job URLs.
  • If no failures exist, report success and stop.
  1. Resolve run and failing job IDs.
  • Derive the workflow run ID from the run URL when available.
  • Derive each failing job ID from job URLs, or list jobs with:
bash
gh run view <run-id> --json jobs
  1. Pull logs for failed jobs.
  • For each failed job:
bash
gh run view <run-id> --job <job-id> --log 2>&1 | tail -80
  • If the tail misses the error, inspect more lines or grep for error markers:
bash
gh run view <run-id> --job <job-id> --log 2>&1 | rg -n "error|failed|traceback|E999|F401|mypy|pytest"
  1. Summarize root causes with evidence.
  • Report by failing check/job name.
  • Include the shortest exact evidence line(s) that explain failure.
  • State likely fix direction (for example: ruff import ordering, mypy type mismatch, failing pytest assertion).

Output Format

Use this structure:

text
check the CI failure details.

Reviewed GitHub Actions logs for test and linting results
Bash
gh pr checks <pr-number> 2>&1
<key failing checks output>

Bash
gh run view <run-id> --job <job-id> --log 2>&1 | tail -60
<relevant error/failure excerpt>

Bash
gh run view <run-id> --job <job-id> --log 2>&1 | tail -40
<relevant error/failure excerpt>

Then provide a short diagnosis section:

  • Finding: one sentence per failed job.
  • Evidence: command + key line.
  • Next fix: concrete first edit to attempt.

Guardrails

  • Do not claim a job failed without a log line proving it.
  • Prefer job-specific logs over workflow-level summaries.
  • Keep excerpts tight; include only lines needed to justify the finding.
  • If GitHub CLI lacks permission or run is missing, state the blocker and requested access explicitly.