技能 build-diagnostics
🔍

build-diagnostics

安全 🌐 網路存取📁 檔案系統存取⚙️ 外部命令

Диагностика проблем сборки и поиск первопричин

Сбои сборки тратят часы времени разработчика. Этот агент систематически исследует блокеры, используя все доступные инструменты, определяет истинную первопричину и внедряет проверенные исправления без создания новых проблем.

支援: Claude Codex Code(CC)
📊 69 充足
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「build-diagnostics」。 Build failed with: 'Error: Turbopack cannot write manifest to .next/static/turbopack/manifest.json'

預期結果:

  • ПЕРВОПРИЧИНА: Отсутствует структура родительской директории для вывода манифеста Turbopack
  • СИМПТОМ: Ошибка записи файла при сборке Turbopack
  • ФАКТИЧЕСКАЯ ПРИЧИНА: Директория .next/static/turbopack/ не существует до начала сборки
  • УВЕРЕННОСТЬ: 95%
  • ИСПРАВЛЕНИЕ: Добавить mkdir -p .next/static/turbopack/ перед сборкой или настроить путь вывода Turbopack
  • ПРОВЕРКА: Сборка завершается без ошибок записи манифеста

正在使用「build-diagnostics」。 Tests are failing in my authentication module

預期結果:

  • ИССЛЕДОВАНИЕ: Запущен набор тестов, найдено 3 падающих теста, связанных с обновлением токена
  • ПЕРВОПРИЧИНА: Мок сервиса аутентификации не обновлен после изменения логики истечения токена
  • УВЕРЕННОСТЬ: 90%
  • ИСПРАВЛЕНИЕ: Обновить мок для обработки нового поведения обновления токена
  • ПРОВЕРКА: Все 3 теста проходят после обновления мока

安全審計

安全
v5 • 1/16/2026

This skill contains only Markdown documentation describing a troubleshooting workflow. No executable code, no file system access, no network calls, and no external dependencies. The static findings are all false positives caused by the analyzer misinterpreting documentation text (code fences, placeholders, and solution descriptions) as actual code vulnerabilities. The skill-report.json already correctly assessed this as safe.

2
已掃描檔案
412
分析行數
3
發現項
5
審計總數
審計者: claude 查看審計歷史 →

品質評分

38
架構
95
可維護性
87
內容
21
社群
100
安全
91
規範符合性

你能建構什麼

Быстрое устранение сбоев сборки

Диагностика загадочных ошибок сборки, таких как проблемы с манифестом Turbopack или сбои выделения памяти, с помощью систематического исследования.

Решение проблем в CI/CD конвейерах

Исследование сбоев конвейера путем воспроизведения ошибок, проверки конфигураций и выявления проблем, связанных с окружением.

Предотвращение повторяющихся блокеров

Обеспечение того, чтобы исправления устраняли первопричины, а не симптомы, снижая повторение проблем в команде разработки.

試試這些提示

Захват ошибки сборки
Build failed with: [paste error message]. Investigate this blocker. Reproduce the error, find the root cause, and propose a fix.
Отладка ошибок типов
TypeScript is reporting type mismatches in [file or component]. Run typecheck, examine the type definitions, identify the root cause, and suggest how to fix it.
Исследование сбоев тестов
Tests are failing in [module or test file]. Run the tests, examine the test structure, find why tests are failing, and implement a fix.
Полный рабочий процесс диагностики
We have a blocker: [description]. Follow your full investigation workflow. Reproduce the error, gather all context (configs, environment, related code), identify root cause with confidence level, propose solution with risk assessment, and verify the fix works.

最佳實務

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

避免

  • Внесение изменений без понимания первопричины
  • Попытка случайных исправлений, пока что-то не начнет работать
  • Предположение, что ошибка не связана с недавними изменениями без доказательств

常見問題

Какие системы сборки поддерживаются?
Работает с любыми инструментами сборки, включая npm, Turbopack, Vite, Webpack, компилятор TypeScript и CI/CD конвейеры.
Сколько обычно занимает диагностика?
Простые проблемы решаются за минуты. Сложные блокеры могут потребовать 15-30 минут систематического исследования.
Есть ли интеграция с инструментами CI/CD?
Да, агент может анализировать логи и ошибки CI/CD из GitHub Actions, GitLab CI, CircleCI и подобных платформ.
Получает ли агент доступ к моему коду или данным во время диагностики?
Агент читает только файлы, которые вы явно указываете. Никакие данные не покидают ваше окружение.
Что происходит, если агент не может найти первопричину?
Агент следует критериям остановки и эскалирует с подробным резюме исследования, когда первопричину невозможно определить.
Чем это отличается от обычной отладки?
Это следует структурированному рабочему процессу исследования с уровнями уверенности, шагами проверки и документированными путями эскалации.

開發者詳情

檔案結構

📄 SKILL.md