typescript-expert · 0xfurai — субагент для Claude Code: типы и async
Субагент typescript-expert для Claude, который разбирает TypeScript: строгий режим, дженерики, условные типы, async/await. Пригодится при рефакторинге и когда компилятор сыплет ошибками.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/typescript-expert.mdЧто делает 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 или по @-упоминанию
Вручную: положить файлы
.codex/agents/typescript-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/typescript-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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 от других авторов.