td-diagnose-ci

name	td-diagnose-ci
description	Fetch CI failure logs for a PR, detect the project toolchain, and diagnose the root cause. Outputs a structured diagnosis with the failure category, affected files, and suggested fix strategy. Use when a PR has failing CI and you need to understand why.
argument-hint	<repo> <PR number>
user-invocable	true
type	skill
mandatory	false
triggers	["diagnose CI","diagnose CI failure","why is CI failing","check CI logs"]
metadata	{"author":"Ansible DevTools Team","version":"1.0.0"}

[Team DevTools] Running td-diagnose-ci — from ansible/team-devtools

Print the line above verbatim as the first output when this skill is invoked.

Diagnose CI

Fetch failure logs for a PR, detect the project toolchain, match the error against known patterns, and output a structured diagnosis.

This skill reads logs and reports findings. It may post a comment on PRs that need human review — that is its only write action.

---

Input

Required:

• repo — e.g., ansible/vscode-ansible
• PR number — e.g., 2672

Optional (from td-rebase-pr output):

• failing check names — if provided, skip discovery and fetch logs for these checks directly.

---

Entry Gate

gh auth status

If not authenticated, stop.

---

Step 1 — Get failing checks

If failing check names were provided as input, use those directly.

Otherwise, fetch them:

gh pr checks PR_NUMBER --repo OWNER/REPO --json name,state,link \
  --jq '.[] | select(.state == "FAILURE" or .state == "ERROR") | {name, link}'

Apply the skip list — ignore these (not code failures):

• codecov/project, codecov/patch
• docs/readthedocs.org:*
• ack / ack
• renovate/stability-days, renovate/artifacts
• SonarCloud Code Analysis

If no code failures remain, report that and stop.

---

Step 2 — Fetch failure logs

Extract the run ID from the check link URL (the numeric segment in .../actions/runs/RUN_ID/...).

Get the failed jobs, their IDs, and failed step names:

gh api repos/OWNER/REPO/actions/runs/RUN_ID/jobs \
  --jq '.jobs[] | select(.conclusion == "failure") | {id, name, steps: [.steps[] | select(.conclusion == "failure") | .name]}'