circleci-builds — скилл для Codex: сбои CircleCI и установка
Скилл разбирает сбои CircleCI по логам, находит вероятную причину и предлагает минимальное исправление. Пригодится для падений сборки, тестов и конфигурации.
npx skills add openai/plugins --skill builds -a codexЧто делает circleci-builds
Скилл выделяет первый сбой в pipeline, workflow или job, затем рассматривает шаг с ошибкой и ключевые строки лога. Он помогает отличить ошибку конфигурации, несовпадение окружения, проблему зависимости или кэша, регрессию тестов или сборки от внешнего временного сбоя.
После классификации скилл предлагает менять только файлы, связанные с подтверждённой причиной. Он задаёт локальные проверки, описывает ожидаемый сигнал успешного повторного запуска и отдельно фиксирует оставшийся риск. Для решений о повторном запуске есть справка references/transient-vs-deterministic.md, а вопросы тестовых метаданных, повторов и JUnit XML описаны в ../config/references/test-results-and-splitting.md.
Смешивать исправление инцидента с несвязанным рефакторингом нельзя. Для разбора понадобятся идентификатор pipeline, workflow или job, ветка, SHA коммита, первый упавший шаг и результат повторного запуска на том же коммите.
Какие задачи решает
- найти первый сбой в CircleCI pipeline
- классифицировать причину падения job
- исправить конфигурацию или тестовую настройку
- проверить, воспроизводится ли ошибка на том же коммите
- описать остаточный риск после исправления
Примеры запросов агенту
- Разбери падение CircleCI job по этому логу и назови первый сбой.
- Проверь, что сломалось в workflow на ветке
mainдля этого SHA, и предложи минимальный патч. - Определи, стоит ли повторять запуск или нужно менять конфигурацию, тесты либо код сборки.
Как установить circleci-builds
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill builds -a codex2Вручную: положить файлы
.agents/skills/builds/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill builds -a claude-code2Вручную: положить файлы
~/.claude/skills/builds/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/builds/
Вручную: положить файлы
.cursor/skills/builds/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins builds2Вручную: положить файлы
.github/skills/builds/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/circleci/skills/buildsВручную: положить файлы
.devin/skills/builds/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о circleci-builds
Как установить circleci-builds в Codex?
Выполните npx skills add openai/plugins --skill builds -a codex, затем используйте файл .agents/skills/builds/SKILL.md.
Что делает circleci-builds?
Скилл исследует упавшие CircleCI pipeline, workflow и job, связывает первый сбой с вероятной причиной и помогает подготовить небольшой патч с планом проверки.
Какие данные нужны для разбора сбоя CircleCI?
Нужны идентификатор pipeline, workflow или job, ветка и SHA коммита, первый упавший шаг, ключевые строки лога и результат повторного запуска на том же коммите.
Исходный текст
SKILL.md · MIT
--- name: circleci-builds description: Diagnose and fix failing CircleCI builds quickly and safely. Use when users ask to investigate failed CircleCI jobs, triage flaky pipelines, identify root causes from logs, and implement minimal fixes in configuration, test setup, or build-related code paths. --- # CircleCI Builds ## Overview Use this skill to turn failing CircleCI pipelines into actionable fixes with clear evidence. Prioritize fast root-cause isolation, minimal safe patches, and explicit validation criteria. Read `references/transient-vs-deterministic.md` when deciding whether a failure should be fixed in code/config, retried, mitigated with rerun behavior, or reported as external/transient. Read `../config/references/test-results-and-splitting.md` when the failure involves missing test metadata, flaky test reruns, test splitting, or JUnit XML setup. ## Inputs To Gather - Failing pipeline/workflow/job identifier - Branch and commit SHA - First failing step and key log lines - Whether rerun on same commit reproduces failure ## Workflow 1. Identify the primary failing signal. - Record the first failing job and step, not every downstream failure. 2. Classify issue type. - Config syntax/reference issue - Environment/toolchain mismatch - Dependency/cache issue - Test or build regression - External/transient failure 3. Apply the smallest viable fix. - Patch only files tied to confirmed root cause. - Keep workaround scope narrow. 4. Validate. - Run highest-signal local checks when possible. - Define expected CircleCI success signals for the rerun. 5. Report residual risk. - Call out unverified assumptions and likely follow-up checks. ## Guardrails - Do not hide deterministic failures with blanket retries. - Avoid mixing unrelated refactors into incident fixes. - Treat external service outages as report-and-mitigate unless user asks for deeper redesign. - Keep confidence levels explicit when logs are incomplete. - Do not recommend automatic reruns or flaky-test workflows until the failure is classified as plausibly transient. ## Output Contract Provide: 1. Failure summary (pipeline/workflow/job/step). 2. Root-cause hypothesis with confidence. 3. Applied changes with file list. 4. Validation plan and expected pass signal. 5. Remaining risk.
© CircleCI · MIT · openai/plugins
