К основному содержанию
субагент CX Codex

build-engineer · voltagent/awesome-codex-subagents — субагент Codex: отладка сборок и стабилизация CI

Субагент build-engineer для диагностики проблем в графе зависимостей, исправления ошибок сборки и стабилизации CI-конвейера. Помогает найти корень проблемы, не переделывая всю систему сборки.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/build-engineer.toml
Открыть на GitHub

Что делает build-engineer

build-engineer фокусируется на конкретной боли: он сначала находит границу проблемы (где именно ломается сборка), отличает причину от симптома, а потом рекомендует минимальный безопасный шаг, чтобы снять давление. Не предлагает полную миграцию инструментов, если проблема точечная.

Что он делает: анализирует граф зависимостей и порядок их выполнения, проверяет инкрементальное кэширование между локалом и CI, ловит ошибки в конфиге компилятора или бандлера для изменённых целей, проверяет воспроизводимость артефактов и версионирование, находит узкие места при параллельных сборках. Возвращает точный анализ: где именно сломалось, почему, какой минимальный шаг это исправит, что он уже проверил и какие риски остаются.

Процесс: нарисовать границы workflow, найти боль, проверить сборку на нормальном пути и на краевых случаях, убедиться, что выход один и тот же на повторных запусках, и что локальное окружение совпадает с CI. Если нужны настройки на реальном CI-раннере — укажет, что именно.

Какие задачи решает

  • разобраться, почему сборка нестабильна под нагрузкой
  • найти утечку в кэше между локальной машиной и CI
  • отладить граф зависимостей, когда компилятор жалуется на порядок
  • проверить, что артефакты одинаковые при повторных запусках
  • понять, где стандартное значение конфига компилятора вызывает ошибку

Примеры запросов агенту

  • Почему локально сборка проходит, а на CI падает с ошибкой кэша?
  • Помоги разобраться в графе зависимостей и найди, что мешает параллельной сборке
  • Сборка стала медленнее после обновления webpack — в чём причина?

Как установить build-engineer

Вручную: положить файлы

.codex/agents/build-engineer.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о build-engineer

Как установить build-engineer в Codex?

Создай файл .codex/agents/build-engineer.toml в корне проекта. Codex найдёт субагент автоматически при следующем запуске.

Что делает build-engineer?

Ищет корни проблем в сборке: ошибки в графе зависимостей, кэш-утечки, нестабильность CI, неправильный конфиг компилятора. Возвращает анализ с конкретным минимальным шагом для исправления, а не полную переделку системы.

Когда вызывать build-engineer вместо ручного исправления конфига?

Когда проблема воспроизводится непредсказуемо, когда локально работает, а в CI — нет, или когда нужно понять, как граф зависимостей влияет на параллелизм. build-engineer проверит, что твой шаг не сломает воспроизводимость и не создаст новые узкие места.

Исходный текст

build-engineer.toml · MIT
# build-engineer

Use when a task needs build-graph debugging, bundling fixes, compiler pipeline work, or CI build stabilization.

Own build engineering work as developer productivity and workflow reliability engineering, not checklist execution.

Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed.

Working mode:
1. Map the workflow boundary and identify the concrete pain/failure point.
2. Distinguish evidence-backed root causes from symptoms.
3. Implement or recommend the smallest coherent intervention.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- build-graph dependency ordering and deterministic execution boundaries
- incremental build and cache behavior across local and CI environments
- compiler/bundler/transpiler configuration correctness for changed targets
- artifact reproducibility, version stamping, and output integrity
- parallelism, resource contention, and flaky build behavior under load
- build diagnostics quality to reduce mean time to root cause
- migration risk when build-tool settings or plugins are changed

Quality checks:
- verify failure reproduction and fix validation on the affected build path
- confirm changes preserve deterministic outputs across repeated runs
- check CI and local parity assumptions for toolchain versions and env vars
- ensure fallback/rollback path exists for high-impact pipeline adjustments
- call out environment checks still required on real CI runners

Return:
- exact workflow/tool boundary analyzed or changed
- primary friction/failure source and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not recommend full build-system migration for a scoped failure unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «DevOps и инфраструктура» →

Сначала — build-engineer от других авторов.

build-engineer VoltAgent Community Субагент build-engineer для Claude Code, ускоряет сборку проекта и настраивает кэширование. Изучает граф зависимостей, находит узкие места ввода-вывода и запускает инкрементальную компиляцию с параллельной обработкой. CX Codex 345установок zig-build-system mohitmishra786 Скилл zig-build-system помогает агенту писать и отлаживать build.zig: исполняемые файлы, библиотеки, C-исходники, опции сборки и тесты. CX Codex +1 589установок build-error-resolver sangrokjung Субагент build-error-resolver доводит упавшую сборку до зелёного состояния минимальными правками: типы, компиляция, импорты, зависимости. Рефакторинг и смена архитектуры исключены. CX Codex ★ 880звёзд репо tooling-engineer VoltAgent Community Субагент tooling-engineer на Claude Code проектирует и пишет CLI-утилиты, генераторы кода, плагины для IDE и сборочные скрипты. Автоматизирует рутину разработчиков внутри команды. CX Codex 257установок ue-module-build-system quodsoler Скилл ue-module-build-system для работы с Build.cs, Target.cs, .uproject и .uplugin в Unreal Engine 5.8: подсказывает зависимости, экспорт-макросы и разбор ошибок сборки. CX Codex +1 1 600установок game-build-log-triage akillness Скилл game-build-log-triage разбирает полотна логов Unity и Unreal Engine при падении сборки или кукинга. Находит первую причину сбоя и отсекает вторичные ошибки. CX Codex +1 312установок documentation-engineer VoltAgent Community Субагент documentation-engineer для Claude Code проектирует и обновляет техническую документацию: справочники API, руководства и архитектурные схемы. Анализирует расхождения между кодом и текстами. CX Codex 735установок

Из того же набора176

Весь набор →
dx-optimizer Субагент dx-optimizer ищет трения в настройке, локальной разработке и цикле обратной связи. Он предлагает небольшие изменения с проверкой обычного и сбойного сценария. CX Codex ★ 6 505звёзд репо documentation-engineer Субагент documentation-engineer для технической документации, которая не отстаёт от реального кода и рабочих процессов. Помогает найти, где документ врёт или устарел, и исправить это минимальным изменением. CX Codex ★ 6 505звёзд репо dependency-manager Субагент dependency-manager анализирует граф пакетов, обновляет зависимости и оценивает риски сторонних библиотек в проектах под управлением Codex. CX Codex ★ 6 505звёзд репо cli-developer Субагент cli-developer для Codex, который берёт разработку интерфейсов командной строки как инженерию, а не чек-лист. CX Codex ★ 6 505звёзд репо reinforcement-learning-engineer Субагент reinforcement-learning-engineer проектирует среды обучения с подкреплением, настраивает функции вознаграждения и оценивает политики агентов в Codex. CX Codex ★ 6 505звёзд репо prompt-engineer Субагент prompt-engineer разбирает промпты как контракты: находит неоднозначности, уточняет формат ответа и предлагает проверку на обычных, крайних и ошибочных сценариях. CX Codex ★ 6 505звёзд репо postgres-pro Субагент postgres-pro для Codex разбирает схемы PostgreSQL, планы запросов, блокировки и эксплуатационные риски. Он подключается к задачам, где нужны рекомендации с учётом нагрузки и миграций. CX Codex ★ 6 505звёзд репо nlp-engineer Субагент nlp-engineer помогает настраивать пайплайны обработки текста, токенизацию, эмбеддинги и ранжирование в Codex. Фокусируется на сбоях в реальных запросах. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой