Fetching Circleci Logs

Trækker trin-niveau CircleCI job-logs via v1.1 API'en og udskriver kun de fejlede trin

Virker med opsætning ★ 8.4/10

Hvad det gør

Henter CircleCI job-logs via v1.1 API'en, gennemgår steps/actions-træet og udskriver kun output for trin, der fejlede, og afkorter hvert til 2000 tegn. Udløses, når en CI-kontrol fejler på en pull request, når en CircleCI job-URL indsættes, eller ved fraser som "build failed", "CI failed" eller "check the build logs". Læser API-tokenet fra ~/.circleci/cli.yml og udleder org/repo fra git remote, når kun et jobnummer er givet.

Testrapport

Jeg opsatte et lokalt mock CircleCI v1.1 endpoint (et fejlet job med 5 trin: 2 beståede, 2 fejlede, 1 annulleret, med 29.673 tegn jest/tsc log bag output_url) og kørte begge tilgange mod det. Baseline (mit eget instinkt: curl jobbet og pipe til json.tool) producerede 1.975 bytes, der navngav hvilke trin der fejlede, men indeholdt ingen af de fire diagnostiske sonder - "Expected: 19.99", "TS2345", "applyDiscount > rounds to 2dp", "1 failed, 27 passed" var alle fraværende; skillens ordrette kommando producerede 2.362 bytes indeholdende alle fire, idet den havde sprunget de beståede trins logs helt over og afkortet den 29.673-tegns besked til præcis 2000. Jeg bekræftede uafhængigt mod CircleCI's v1 docs og supportmateriale, at actions[].{name,status,exit_code,failed} og den forhåndssignerede output_url, der returnerer [{message,type,time}], er reelle felter, ikke opfundne, og dens git-remote sed helper løste alle 4 almindelige remote-formater korrekt; installationsblokken placerede SKILL.md korrekt i en ren midlertidig HOME. To reelle huller jeg observerede: scriptet fjerner ikke ANSI escape-koder (jeg kørte igen med realistisk farvet jest output og fik rå \x1b[1m\x1b[31m sekvenser, der spiste de 2000-tegns budget), og afkortning tager starten af hver besked, så et værktøj, der udskriver sin fejlopsummering sidst, ville få den kasseret. Dommen er "opsætning" ikke "bestået", fordi det ene trin, jeg ikke kunne udføre, er godkendelse mod den live API - det kræver et ægte CircleCI konto-token i ~/.circleci/cli.yml, so everything above is measured against a shape-faithful mock rather than production CircleCI. Udløsningsfraser bedømt - SKULLE udløses: "The CircleCI check on my PR is red, pull the logs and tell me what broke", "https://circleci.com/gh/acme/widgets/169955 why did this fail?", "Build failed on main again, can you check the CI logs?"; SKULLE IKKE udløses: "Our .circleci/config.yml fails to validate, fix the YAML" (konfigurationsredigering, ikke log-hentning) og "The GitHub Actions workflow failed, show me the run logs" (forkert CI-udbyder) - jeg ville korrekt indlæse/ikke-indlæse alle 5, selvom beskrivelsens generiske "check the logs" nøgleord er en falsk-positiv risiko på ikke-CI log-anmodninger.

Testet: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/NTCoding/claude-skillz.git /tmp/fetching-circleci-logs-src
mkdir -p ~/.claude/skills
cp -R /tmp/fetching-circleci-logs-src/fetching-circleci-logs ~/.claude/skills/fetching-circleci-logs
# Single-file skill (SKILL.md only) - no scripts, no deps beyond curl + python3 (both preinstalled on macOS/Linux).
#
# REQUIRED MANUAL STEP - the skill does nothing without a CircleCI API token:
#   brew install circleci && circleci setup
# or write it by hand:
#   mkdir -p ~/.circleci && printf 'host: https://circleci.com\ntoken: YOUR_TOKEN\n' > ~/.circleci/cli.yml
# Create the token at https://app.circleci.com/settings/user/tokens
#
# Plugin-marketplace alternative (this skill is registered in .claude-plugin/marketplace.json):
#   /plugin marketplace add ntcoding/claude-skillz
#   /plugin install fetching-circleci-logs@claude-skillz
#
# Usage: paste a job URL like https://circleci.com/gh/{org}/{repo}/{job_number} and ask why CI failed.

Kommandoer og eksempelprompter

/fetching-circleci-logsTrækker trin-niveau CircleCI job-logs via v1.1 API'en og udskriver kun de fejlede trin

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

Check why the CircleCI build failed
Fetch the logs for this CircleCI job URL
Show me the failed step in the last CI run

Læs hele rapporten →