auto-error-resolver — субагент для Claude Code: как установить
auto-error-resolver — субагент Claude Code, который устраняет ошибки компиляции TypeScript по отчётам проверочного хука и перепроверяет сборку через tsc.
MIT ★ 10 055 обновлён 2026-07-13
.claude/agents/auto-error-resolver.mdЧто делает 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 или по @-упоминанию
Вручную: положить файлы
.codex/agents/auto-error-resolver.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/auto-error-resolver.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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