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

typescript-expert · 0xfurai — субагент для Claude Code: типы и async

Субагент typescript-expert для Claude, который разбирает TypeScript: строгий режим, дженерики, условные типы, async/await. Пригодится при рефакторинге и когда компилятор сыплет ошибками.

MIT ★ 1 029 обновлён 2025-10-15

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

Что делает typescript-expert

Субагент читает ваш TypeScript и ведёт его к строгой типизации: дженерики с ограничениями, условные и mapped-типы, type guards для сужения, declaration merging и module augmentation. Внутри — набор правил: где вывести тип вместо аннотации, когда брать интерфейс вместо type alias, как настроить tsconfig и разрешение модулей.

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

Про any: субагент его избегает и просит тип поточнее. На проекте с выключенным strict, где половина файлов размечена loosely, он начнёт с большого рефакторинга, а не с мелкой правки.

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

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

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

  • Прогони src/api/client.ts через строгую типизацию и убери все any.
  • Разбери ошибки компилятора в пакете packages/core и поправь tsconfig.
  • Перепиши этот обработчик на async/await с обработкой ошибок.

Как установить typescript-expert

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

.claude/agents/typescript-expert.md

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

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

Вопросы о typescript-expert

Как установить typescript-expert в Claude Code?

Положите файл субагента по пути .claude/agents/typescript-expert.md в проекте.

Что делает typescript-expert?

Разбирает TypeScript-код: строгий режим, дженерики, условные и mapped-типы, type guards, async/await. Возвращает типизированный код и рекомендации по tsconfig.

На каком коде он забуксует?

Он включает строгую проверку и просит полное покрытие типами экспортируемых модулей. Там, где strict выключен, первым делом будет крупный рефакторинг.

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

typescript-expert.md · MIT
---
name: typescript-expert
description: Expert in TypeScript specializing in type safety, async patterns, and modern ES features. Use PROACTIVELY for TypeScript development, refactoring, or type system optimization.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Strict type safety and type inference
- Advanced types (union, intersection, conditional types)
- Generics and their applications
- Decorators and metadata reflection
- Async/await and promise handling
- TypeScript compiler options and configurations
- Module resolution and import/export syntax
- Interface and type alias usage
- Type declaration merging
- Namespace and module augmentation

## Approach

- Always enable strict type checking for maximum safety
- Use type inference over explicit type annotations when possible
- Leverage generics for reusable, type-safe components
- Prefer interfaces for defining object shapes
- Employ async/await syntax for cleaner asynchronous code
- Use access modifiers to control class member visibility
- Keep type definitions DRY and avoid duplication
- Use type guards to safely handle type narrowing
- Utilize mapped types for dynamic type transformations
- Regularly refactor to incorporate newer TypeScript features

## Quality Checklist

- All code should pass with no TypeScript compiler errors
- Ensure 100% type coverage on exported modules
- Generics should have clear constraints and defaults
- Async functions should have proper error handling
- Avoid "any" type in favor of more specific types
- Implement custom ESLint rules for TS-specific patterns
- Type guards are comprehensive and well-tested
- Interfaces are used over type aliases where extension is needed
- Unused code is regularly pruned and types are kept relevant
- TypeScript project references are correctly set up in large projects

## Output

- Clean and well-typed TypeScript code
- Comprehensive type definitions for all modules
- Usage examples of advanced type patterns
- Documentation of complex types with examples
- Test cases demonstrating type safety
- Compiler configuration optimized for build performance
- Suggestions for improving existing type annotations
- Error-free asynchronous code with async/await
- Consistent module import and export conventions
- Refactoring recommendations for improved type usage

© 0xfurai · MIT · 0xfurai/claude-code-subagents

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

Все субагенты по теме «Языки программирования» →

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

typescript-expert carlrannaberg Субагент typescript-expert разбирает сложные задачи TypeScript и JavaScript: типы, сборку, монорепозитории, отладку и архитектуру. Подключайте его для анализа кода и проверки решений. CX Codex ★ 763звёзд репо typescript PyModel С рекомендациями по типам и настройке TypeScript 7. Помогает разбирать tsconfig.json, сложные типы, асинхронный код и структуру модулей. CX Codex +1 657установок typescript-best-practices cursor Скилл typescript-best-practices задаёт агенту правила работы с типами в .ts и .tsx: дискриминированные объединения, брендированные типы, проверка на границах. CX Codex +1 11 200установок typescript-variables mkosir Скилл typescript-variables для Claude Code применяет и объясняет правила работы с переменными TypeScript. Подключается к задачам с const, enum, объединениями типов и значениями null или undefined. CX Codex +1 4 200установок typescript-magician mcollina Скилл typescript-magician устраняет ошибки TypeScript, заменяет any на строгие типы и строит типобезопасные дженерики. Помогает навести порядок в типах кодовой базы. CX Codex +1 3 000установок typescript-refactor pproenca Скилл typescript-refactor для Claude Code проверяет TypeScript и React-код на типобезопасность, убирает as и переводит на возможности TS 5.x–6.0. Включается при рефакторинге, типизации хуков и миграции. CX Codex +1 808установок typescript-strict-migrator patricio0312rev Скилл typescript-strict-migrator для Claude Code переводит TypeScript-проект на strict по одному флагу после аудита ошибок. Миграция начинается с noImplicitAny, затем включает strictNullChecks и остальные флаги. CX Codex +1 280установок

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

Весь набор →
cypress-expert Субагент cypress-expert помогает проектировать и отлаживать сквозные тесты на Cypress: от фикстур и пользовательских команд до разбора нестабильных проверок. CX Codex ★ 1 029звёзд репо websocket-expert Субагент websocket-expert для работы с WebSocket: разбирает протокол, рукопожатие, кадры и переподключение — и на клиенте, и на сервере. CX Codex ★ 1 029звёзд репо mssql-expert Субагент mssql-expert для Microsoft SQL Server: оптимизирует T-SQL запросы, проектирует схемы данных и настраивает отказоустойчивость. CX Codex ★ 1 029звёзд репо sidekiq-expert Субагент sidekiq-expert для Claude Code помогает настраивать и оптимизировать обработку фоновых задач в Sidekiq. Он разбирает очереди, повторы, мониторинг и нагрузку на воркеры. CX Codex ★ 1 029звёзд репо python-expert Субагент python-expert настраивает Claude Code на написание идиоматичного кода на Python по PEP 8, покрытие тестами через pytest и проверку типов с mypy. CX Codex ★ 1 029звёзд репо jquery-expert Субагент jquery-expert помогает писать и проверять jQuery-код: DOM, события, AJAX, анимации и совместимость браузеров. CX Codex ★ 1 029звёзд репо jwt-expert Субагент jwt-expert для Claude Code разбирает создание и проверку JWT: подпись, срок жизни, отзыв токенов и сверку с RFC 7519. Проверяет готовую логику авторизации. CX Codex ★ 1 029звёзд репо typeorm-expert Субагент typeorm-expert помогает проектировать сущности TypeORM, настраивать каскадные связи, писать миграции и оптимизировать запросы в проектах на Node.js. CX Codex ★ 1 029звёзд репо

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

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