Fetching Circleci Logs

Henter trinn-nivå CircleCI jobb-logger via v1.1 API-et og skriver ut kun de feilende trinnene

Krever oppsett ★ 8.4/10

Hva den gjør

Henter CircleCI jobb-logger via v1.1 API-et, går gjennom trinn-/handlings-treet, og skriver ut kun for trinn som feilet, og avkorter hvert til 2000 tegn. Utløses når en CI-sjekk feiler på en pull-request, når en CircleCI jobb-URL limes inn, eller på fraser som "build failed", "CI failed", eller "check the build logs". Leser API-tokenet fra ~/.circleci/cli.yml og utleder org/repo fra git remote når kun et jobbnummer er gitt.

Testrapport

Jeg satte opp et lokalt mock CircleCI v1.1 endepunkt (en feilet jobb med 5 trinn: 2 bestått, 2 feilende, 1 kansellert, med 29 673 tegn med jest/tsc logg bak output_url) og kjørte begge tilnærmingene mot det. Baseline (mitt eget instinkt: curl jobben og pipe til json.tool) produserte 1 975 bytes som navnga hvilke trinn som feilet, men som ikke inneholdt noen av de fire diagnostiske probene - "Expected: 19.99", "TS2345", "applyDiscount > rounds to 2dp", "1 failed, 27 passed" var alle fraværende; ferdighetens ordrette kommando produserte 2 362 bytes som inneholdt alle fire, etter å ha hoppet over de beståtte trinnenes logger helt og avkortet den 29 673-tegns meldingen til nøyaktig 2000. Jeg bekreftet uavhengig mot CircleCIs v1-dokumenter og støttemateriale at actions[].{name,status,exit_code,failed} og den forhåndssignerte output_url som returnerer [{message,type,time}] er virkelige felt, ikke oppfunnet, og dens git-remote sed-hjelper løste alle 4 vanlige fjernformater korrekt; installasjonsblokken plasserte SKILL.md korrekt i en ren midlertidig HOME. To reelle hull jeg observerte: skriptet fjerner ikke ANSI escape-koder (jeg kjørte på nytt med realistisk farget jest-utdata og fikk rå \x1b[1m\x1b[31m sekvenser som spiste opp 2000-tegns budsjettet), og avkorting tar hodet av hver melding, så et verktøy som skriver ut feilsammendraget sist, ville fått det forkastet. Dommen er "oppsett" ikke "bestått" fordi det ene trinnet jeg ikke kunne utføre er autentisering mot live API-et - det trenger et ekte CircleCI-konto-token på ~/.circleci/cli.yml, så alt ovenfor er målt mot en form-tro mock snarere enn produksjons-CircleCI. Utløserfraser vurdert - SKAL utlø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?"; SKAL IKKE utløses: "Our .circleci/config.yml fails to validate, fix the YAML" (konfigurasjonsredigering, ikke logghenting) og "The GitHub Actions workflow failed, show me the run logs" (feil CI-leverandør) - jeg ville korrekt lastet/ikke-lastet alle 5, selv om beskrivelsens generiske "check the logs"-nøkkelord er en falsk-positiv risiko på ikke-CI-loggforespørsler.

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

Installer

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-logsHenter trinn-nivå CircleCI jobb-logger via v1.1 API-et og skriver ut kun de feilende trinnene

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →