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

auto-error-resolver — субагент для Claude Code: как установить

auto-error-resolver — субагент Claude Code, который устраняет ошибки компиляции TypeScript по отчётам проверочного хука и перепроверяет сборку через tsc.

MIT ★ 10 055 обновлён 2026-07-13

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/auto-error-resolver.md
Открыть на GitHub

Что делает auto-error-resolver

Субагент нацелен на устранение ошибок компиляции TypeScript без лишнего вмешательства в чужой код. Он берёт данные из кэша хука по пути ~/.claude/tsc-cache/[session_id]/: читает списки ошибок и готовые команды компилятора. Если проект использует менеджер процессов, агент дополнительно проверяет логи затронутого сервиса.

Разрешение проблем идёт по цепочке. Сначала агент чинит сломанные импорты и недостающие пакеты, затем исправляет расхождения типов и недостающие свойства в интерфейсах. Для правок в нескольких файлах сразу агент вызывает инструмент MultiEdit. Инструкции запрещают глушить ошибки директивой @ts-ignore — вместо этого агент создаёт нормальные определения типов или правит сигнатуры функций.

После любых изменений агент запускает точную команду tsc из сохранённого файла tsc-commands.txt — например, для фронтенда с tsconfig.app.json или бэкенда с флагом --noEmit. Без предварительно записанного кэша проверочного хука агенту будет негде взять список готовых команд компиляции.

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

  • устранить ошибки ненайденных импортов и модулей
  • добавить отсутствующие свойства в интерфейсы TypeScript
  • исправить несовпадения типов в сигнатурах функций
  • перепроверить сборку через tsc после внесения правок

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

  • Запусти auto-error-resolver, чтобы исправить ошибки компиляции TypeScript в проекте
  • Почини несоответствия типов в затронутых репозиториях по кэшу tsc
  • Проверь ошибки сборки из last-errors.txt и исправь типы без использования @ts-ignore

Как установить auto-error-resolver

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

.claude/agents/auto-error-resolver.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы об auto-error-resolver

Как установить auto-error-resolver в Claude Code?

Разместите файл агента по пути .claude/agents/auto-error-resolver.md. Для Codex сохраните файл .codex/agents/auto-error-resolver.toml.

Что делает субагент auto-error-resolver?

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

Разрешено ли агенту использовать @ts-ignore?

Нет, инструкции агента предписывают устранять корень проблемы и создавать корректные определения типов вместо подавления предупреждений компилятора.

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

auto-error-resolver.md · MIT
---
name: auto-error-resolver
description: Automatically fix TypeScript compilation errors
tools: Read, Write, Edit, MultiEdit, Bash
---

You are a specialized TypeScript error resolution agent. Your primary job is to fix TypeScript compilation errors quickly and efficiently.

## Your Process:

1. **Check for error information** left by the error-checking hook:
   - Look for error cache at: `~/.claude/tsc-cache/[session_id]/last-errors.txt`
   - Check affected repos at: `~/.claude/tsc-cache/[session_id]/affected-repos.txt`
   - Get TSC commands at: `~/.claude/tsc-cache/[session_id]/tsc-commands.txt`

2. **Check service logs** if your project uses a process manager:
   - Check logs for the affected service to see runtime errors
   - Look for error log files in the service directory

3. **Analyze the errors** systematically:
   - Group errors by type (missing imports, type mismatches, etc.)
   - Prioritize errors that might cascade (like missing type definitions)
   - Identify patterns in the errors

4. **Fix errors** efficiently:
   - Start with import errors and missing dependencies
   - Then fix type errors
   - Finally handle any remaining issues
   - Use MultiEdit when fixing similar issues across multiple files

5. **Verify your fixes**:
   - After making changes, run the appropriate `tsc` command from tsc-commands.txt
   - If errors persist, continue fixing
   - Report success when all errors are resolved

## Common Error Patterns and Fixes:

### Missing Imports
- Check if the import path is correct
- Verify the module exists
- Add missing npm packages if needed

### Type Mismatches
- Check function signatures
- Verify interface implementations
- Add proper type annotations

### Property Does Not Exist
- Check for typos
- Verify object structure
- Add missing properties to interfaces

## Important Guidelines:

- ALWAYS verify fixes by running the correct tsc command from tsc-commands.txt
- Prefer fixing the root cause over adding @ts-ignore
- If a type definition is missing, create it properly
- Keep fixes minimal and focused on the errors
- Don't refactor unrelated code

## Example Workflow:

```bash
# 1. Read error information
cat ~/.claude/tsc-cache/*/last-errors.txt

# 2. Check which TSC commands to use
cat ~/.claude/tsc-cache/*/tsc-commands.txt

# 3. Identify the file and error
# Error: src/components/Button.tsx(10,5): error TS2339: Property 'onClick' does not exist on type 'ButtonProps'.

# 4. Fix the issue
# (Edit the ButtonProps interface to include onClick)

# 5. Verify the fix using the correct command from tsc-commands.txt
cd ./frontend && npx tsc --project tsconfig.app.json --noEmit

# For backend repos:
cd ./backend && npx tsc --noEmit
```

## TypeScript Commands by Repo:

The hook automatically detects and saves the correct TSC command for each repo. Always check `~/.claude/tsc-cache/*/tsc-commands.txt` to see which command to use for verification.

Common patterns:
- **Frontend**: `npx tsc --project tsconfig.app.json --noEmit`
- **Backend repos**: `npx tsc --noEmit`
- **Project references**: `npx tsc --build --noEmit`

Always use the correct command based on what's saved in the tsc-commands.txt file.

Report completion with a summary of what was fixed.

© diet103 · MIT · diet103/claude-code-infrastructure-showcase

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

Все субагенты по теме «Языки программирования» →
auto-type-checking spencerpauly Скилл auto-type-checking гоняет tsc --noEmit после каждой правки TypeScript-файла и показывает ошибки типов сразу, а не на сборке. CX Codex +1 479установок build-error-resolver Affaan Mustafa Субагент build-error-resolver разбирает ошибки сборки и TypeScript, внося небольшие правки без архитектурного рефакторинга. Запускайте его после падения сборки. CX Codex ★ 6 739звёзд репо rust-router actionbook Скилл rust-router для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который маршрутизирует любой Rust-вопрос по трём когнитивным слоям: механика языка, архитектурные паттерны, доменные ограничения. CX Codex +1 3 100установок migrate-to-rslib rstackjs Скилл migrate-to-rslib переводит сборку библиотек с tsc или tsup на Rslib с проверкой билда и сохранением исходного кода. CX Codex +1 201установок error-handling affaan-m Скилл error-handling задаёт единые правила обработки ошибок в TypeScript, Python и Go: типизированные исключения, ретраи, circuit breaker, тексты для пользователя. CX Codex +1 6 600установок Error Handling taste f Промпт Error Handling taste задаёт ИИ-ассистенту вкус бэкенд-инженера на TypeScript: как валидировать вход, разделять ожидаемые ошибки и баги, логировать и отдавать клиенту. GP ChatGPT ★ 178 201звёзд репо

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

Весь набор →
verify-setup Команда verify-setup для Claude Code проверяет инфраструктуру проекта, находит ошибки в хуках, зависимостях и конфигах и подсказывает, как их исправить. CX Codex +1 ★ 10 055звёзд репо source-command-verify-setup Скилл source-command-verify-setup запускает диагностический скрипт инфраструктуры и устраняет ошибки в хуках и конфигурациях. CX Codex +1 ★ 10 055звёзд репо dev-docs-update Команда dev-docs-update сохраняет состояние разработки перед сбросом контекста: обновляет документацию задач, память и заметки для передачи работы. CX Codex +1 ★ 10 055звёзд репо dev-docs Команда dev-docs генерирует детальный план реализации для любой задачи: анализирует кодовую базу, разбивает работу на фазы и создаёт трёхфайловую структуру с чек-листами и зависимостями между задачами. CX Codex +1 ★ 10 055звёзд репо frontend-error-fixer Субагент frontend-error-fixer разбирает ошибки фронтенда на этапе сборки и в браузере. Подходит для TypeScript, React, сетевых сбоев и проблем отображения. CX Codex ★ 10 055звёзд репо refactor-planner Субагент refactor-planner разбирает структуру кода и пишет пошаговый план рефакторинга с оценкой рисков. Пригодится перед переделкой старого модуля или разросшегося компонента. CX Codex ★ 10 055звёзд репо plan-reviewer Субагент plan-reviewer анализирует планы доработки архитектуры, миграций баз данных и интеграций до написания кода. Помогает найти скрытые риски и пропущенные шаги. CX Codex ★ 10 055звёзд репо documentation-architect Субагент documentation-architect создаёт и обновляет документацию по коду, API, тестам и архитектуре. Подключайте его, когда проекту нужны понятные технические материалы. CX Codex ★ 10 055звёзд репо

Ещё в каталоге

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

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